HP-UX TN3270 Users Guide, March 1998
Table Of Contents
- Audience
- Fast Path to TN3270 Emulation and File Transfer
- Organization of This Guide
- Typographic Conventions
- Motif Version and Character-Based Version
- Help Screens
- HP-UX SNAplus2 TN3270 Documentation Set
- Related Publications
- 1 Introducing the TN3270 Emulation Program
- Overview
- Support of TN3270 Features
- Sessions
- Model 2-5 Display Support
- File Transfer
- Background Operation
- Temporary Exit from TN3270 Emulation
- Type-Ahead during TN3270 Emulation
- Local Copy
- Keyboard Remapping
- Keystroke Recording and Replay
- International Language Support
- 3270 Status Line
- Printer Emulation
- File, Customize, and Control Menus
- HLLAPI Support
- Where Do You Go from Here?
- Overview
- 2 The TN3270 Emulation Program User Interface
- 3 Getting Started with 3270 Emulation
- Overview
- Specifying the Path to TN3270 Product Programs
- Fast Path to 3270 Terminal Emulation
- Starting the TN3270 Emulation Program
- Using Menus and Dialog Boxes
- Running 3270 Emulation in the Background
- Overview of 3270 Operations
- 3270 Data Fields
- Double-Byte Characters
- Keystroke Recording and Replay
- Running HLLAPI Programs
- Moving from the Menu Interface to TN3270 Emulation
- Exiting the TN3270 Emulation Program
- Automating the TN3270 Emulation Start-Up
- Where Do You Go from Here?
- 4 Controlling 3270 Emulation
- 5 Transferring Files
- Overview
- Fast Path to File Transfer
- Preparing to Transfer Files
- Monitoring File Transfer Status
- Transferring Files Using the Menu Interface
- Transferring Files from the HP-UX Command Prompt
- Stopping a File Transfer in Progress
- Finishing File Transfer
- 6 Customizing 3270 Emulation
- 7 Solving Problems
- Overview
- 3270 Could Not Initialize due to Failure to Fork a...
- 3270 Emulation Program Not Found
- Cannot Get from 3270 Session to TN3270 Emulation P...
- Cannot Run 3270 Emulation in Background
- Cannot Run 3270 Emulation without a Menu Interface
- Cannot Tell Which Terminal Keys Correspond to Vari...
- Characters on Display Do Not Match Keys Pressed
- Customize Menu Options Not Selectable
- Display Colors Are Different from Those Selected
- Display Is Incomplete or Hard to Read
- Error Message—3270 User Not Found
- Error Message—No 3270 Sessions
- Error Message—No 3270 Users
- Failed to Initialize Windowing System
- Fields Cannot Be Changed or Edited
- File Menu Options Not Selectable
- File Transfer Process “Hung”
- HLLAPI Application Does Not Work
- Host Response Times Option Not Selectable
- Last Transaction Time Indicator (LTTI) on Status L...
- Main Screen Invoked Instead of 3270 Session
- Model Type Radio Group Is Not Selectable
- Open Option Is Not Selectable
- Style File Contains Invalid Maximum Structured Fie...
- Unable to Obtain System Semaphores
- Overview
- Functions within Groups and Corresponding Keys
- Alphabetical List of Functions and Corresponding K...
- Overview
- How the Status Line Is Displayed
- Overview of the Status Line
- Session Status Messages
- Do Not Enter Messages
- Communications Check Codes
- Last Transaction Time Indicator
- Cursor Width Indicator
- Numeric Indicator
- Insert Indicator
- Printer Identifier
- Record/Replay ID
- Host Session
- Cursor Position Message
- Session ID
- Program Check Codes
- Overview
- Menu Interface File Transfer Messages
- Host File Transfer Messages
- Overview
- Command Format
- Output
- Error Messages
- Overview
- Overriding Host Domain Names
- Overview
- Specifying Output Method
- SPOF Format
- Model Control Commands
82 Chapter 3
Getting Started with 3270 Emulation
Double-Byte Characters
Double-Byte Characters
The TN3270 emulation program supports the use of double-byte
characters, used in languages such as Japanese and Korean, to enable
the program to communicate with 3270 host programs that support
these characters.
Single-Byte, Double-Byte, and Mixed Fields
In a formatted presentation space, the host application can designate
certain fields as accepting single-byte characters only, double-byte
characters only, or mixed characters, in the same way that it designates
fields as accepting any characters or only numeric characters. In a mixed
field, you must use the SO and SI (shift out and shift in) characters to
indicate the start and end, respectively, of a group of double-byte
characters.
SO/SI Characters
In presentation space fields that accept both single-byte and double-byte
characters, the two special characters SO and SI (shift out and shift in)
are used to indicate the start and end of a group of double-byte
characters. Single-byte characters are standard, so it may help you to
think of shifting out of the regular mode to use double-byte characters
and then shifting back in to regular mode when you finish. These
characters are represented by the ASCII values 0x0E (SO) and 0x0F
(SI).
When a single-byte character is followed by a double-byte character, an
SO character is placed after the single-byte and before the double-byte
character. When a double-byte character is followed by a single-byte
character, or when the last character in the field is a double-byte
character, an SI character is placed after the double-byte character.
The default characters displayed are [`] (open single quote) for SO and
['] (close single quote) for SI; you can change these to different ASCII
characters if required. You may want to choose characters that are not
normally used for any other purpose in the host application, to make it
easier to recognize SO and SI characters. To do this, set the environment
variables SNAP3270_SO and SNAP3270_SI to the hexadecimal values