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

164 Chapter 5
Transferring Files
Transferring Files from the HP-UX Command Prompt
Sample File Transfer Commands
This section contains sample command lines for file transfer to and from
the different host types. Note the use of the backslash (\) character in all
these examples; it is used as an escape character to prevent
interpretation of parentheses and quotation marks by the HP-UX shell.
MVS/TSO tnsend Command
tnsend filea.txt A: \'id.text.mytext\(filea\)\' ASCII H\(277\) P\( 8859\) CRLF
This command sends the file filea.txt (from the current HP-UX
directory) to the member filea of the MVS/TSO partitioned data set
id.text.mytext, using the 3270 session with a session ID of A. The
host translates the file from ASCII to EBCDIC, using the host code page
277 and the PC (ASCII) code page 8859, and removes line-feed
characters.
VM/CMS tnreceive Command
tnreceive /usr/jim/file2.txt SESS02: mytext script \(crlf ascii t\(03\)
This command receives the VM/CMS file mytext with file type script
(the file mode is not specified, so it is assumed to be A1) and stores it in
the directory /usr/jim as a file named file2.txt; the host translates
the file from EBCDIC to ASCII and adds line-feed characters. The file
transfer uses the display session with long name SESS02. The transfer
will be canceled if the host fails to respond within 90 seconds (three
30-second timeout periods).
CICS tnsend Command
tnsend -h 0x01 FILE3 mytext \(ASCII NOCRLF\) Sales Meeting Report
This command sends the file named FILE3 in the current directory to the
CICS file mytext. The file transfer uses the display session with session
ID 0x01 (this session ID will have been specified on the command line
when starting the TN3270 emulation program). The host translates the
file from ASCII to EBCDIC, but does not remove line-feed characters.
The comment “Sales Meeting Report” is written to the first record of the
host file.
MVS/TSO tnreceive Command to a Japanese Host
tnreceive /usr/jim/filea.txt SESS2: text.mytext.filea \(crlf jiscii so\)