SNAP-IX 3270 User's Guide
Before You Begin
Intended Audience
Fast Path to 3270 Emulation and File Transfer
About This Book
Organization of This Book
Typographic Conventions
Graphic Conventions
Help Screens
SNAP-IX Publications
Publications for Users
Publications for Administrators
Publications for Programmers
Related Publications
1 Introducing the 3270 Emulation Program
1.1 Overview of 3270 Emulation
1.1.1 Sessions
1.1.2 Model 2-5 Display Support
1.1.3 File Transfer
1.1.4 Background Operation
1.1.5 Temporary Exit from 3270 Emulation
1.1.6 Type-Ahead during 3270 Emulation
1.1.7 Local Copy
1.1.8 Keyboard Remapping
1.1.9 Keystroke Recording and Replay
1.1.10 International Language Support
1.1.11 3270 Status Line
1.1.12 Printer Emulation
1.1.13 File, Customize, and Control Menus
1.1.14 HLLAPI Support
1.2 Where Do You Go from Here?
2 The 3270 Emulation Program User Interface
2.1 Screen Clearing on Different Terminal Types
2.2 Menus
2.2.1 Choosing a Menu from the Menu Bar
2.2.2 Choosing a Menu Item
2.3 Dialog Boxes
2.3.1 Push Buttons
2.3.2 Check Boxes
2.3.3 Radio Groups
2.3.4 Edit Boxes
2.3.5 List Boxes
2.4 Accelerator Keys
2.5 Nonselectable Items
2.6 Help Screens
2.7 Message Boxes
2.8 Screen Redrawing
2.9 Fast Exit from the Menu Interface
3 Getting Started with 3270 Emulation
3.1 Specifying the Path to SNAP-IX ProductPrograms
3.2 Fast Path to 3270 Terminal Emulation
3.3 Starting the 3270 Emulation Program
3.3.1 Translation Table File Format
3.4 Starting the 3179G Emulation Program
3.5 Using Menus and Dialog Boxes
3.5.1 Displaying the Main Screen
3.5.2 Incorrect Style File Specified
3.5.3 Using Style Files and Customizing Emulation
3.5.4 Controlling Emulation
3.5.5 Communicating with the Host
3.5.6 Moving between a 3270 Session and the Main Screen
3.5.7 Temporary Exit to the Solaris Command Prompt
3.5.8 Ending Emulation
3.6 Running 3270 Emulation in the Background
3.6.1 Starting the 3270 Emulation Program
3.6.2 Stopping the 3270 Emulation Program
3.7 Overview of 3270 Operations
3.7.1 Using the Keyboard
3.7.2 Understanding the 3270 Status Line
3.7.3 Switching between 3270 Sessions
3.7.4 Temporary Exit from 3270 Emulation
3.7.5 Type-Ahead during 3270 Emulation
3.7.6 3179G Screen Display
3.7.7 Using the Mouse with 3270 Emulation
3.7.8 Using the Mouse with 3179G Emulation
3.8 3270 Data Fields
3.8.1 Attribute Characters
3.8.2 EAB Characters
3.9 Keystroke Recording and Replay
3.9.1 Valid Keystrokes for Recorded Sequences
3.9.2 Recording a Keystroke Sequence
3.9.3 Replaying a Keystroke Sequence
3.9.4 Pausing within a Keystroke Sequence
3.9.5 Clearing a Recorded Keystroke Sequence
3.9.6 Saving Keystroke Sequences
3.9.7 Multiple Sessions
3.10 Running HLLAPI Programs
3.11 Moving from the Menu Interface to 3270 Emulation
3.12 Exiting the 3270 Emulation Program
3.13 Automating the 3270 Emulation Start-Up
3.14 Where Do You Go from Here?
4 Controlling 3270 Emulation
4.1 Overview of the Main Screen Menus
4.1.1 The Control Menu
4.2 Controlling Display Sessions
4.2.1 Enabling a Display Session
4.2.2 Making a Session Current
4.2.3 Disabling a Session
4.2.4 Remapping a Display Session
4.3 Controlling Printer Sessions
4.3.1 Enabling and Disabling a Printer Session
4.3.2 Remapping a Printer Session
4.3.3 Maximum Print Position for LU 1 andUnformatted LU 3 Printer Sessions
4.3.4 Code Translation for LU 1 Transparent Data
4.4 Transferring Files
4.5 Viewing Host Response Times
4.6 Sending NetView User Alert Messages
4.7 Resuming or Beginning Terminal Emulation
4.8 Moving between 3270 Sessions
5 Transferring Files
5.1 Fast Path to File Transfer
5.2 Preparing to Transfer Files
5.2.1 Setting Environment Variables
5.2.2 Setting Other Parameters
5.2.3 Establishing Communications
5.3 Monitoring File Transfer Status
5.4 Transferring Files Using the Menu Interface
5.4.1 Setting Host File Transfer Parameters
5.4.2 Transferring Files with an MVS/TSO Host
5.4.3 Transferring Files with a VM/CMS Host
5.4.4 Transferring Files with a CICS Host
5.5 Transferring Files from the Solaris Command Prompt
5.5.1 File Transfer Command Syntax
5.5.2 Sample File Transfer Commands
5.6 Stopping a File Transfer in Progress
5.7 Finishing File Transfer
6 Customizing 3270 Emulation
6.1 What Is a Style File?
6.1.1 Search Path for Style Files
6.1.2 Permissions to Use and Modify Style Files
6.2 Menus Used for Customizing 3270 Emulation
6.3 Opening, Creating, and Saving Style Files
6.3.1 Opening a Style File
6.3.2 Creating a New Style File
6.3.3 Saving a Style File
6.3.4 Saving a Style File under a Different Name
6.4 Setting Customization Options
6.5 Customizing Sessions
6.5.1 Customizing Display Sessions
6.5.2 Customizing Printer Sessions
6.6 Customizing Display Colors
6.6.1 Customizing Colors for a Display Session
6.6.2 Using Default Color Mapping
6.6.3 Copying Colors from Another Session
6.7 Choosing a Host Language
6.8 Customizing Key Definitions
6.8.1 Viewing Key Definitions
6.8.2 Redefining a Keystroke Used for a 3270 Function
6.8.3 Adding a Keystroke to a 3270 Function
6.8.4 Undefining Keystrokes
6.8.5 Choosing Default Keyboard Mapping
6.9 Customizing Miscellaneous Options
7 Solving Problems
7.1 3270 Could Not Initialize due to Failure to Fork a Process
7.2 3270 or 3179G Emulation Program Not Found
7.3 Cannot Get from 3270 Session to 3270 Emulation Program Main Screen
7.4 Cannot Run 3270 Emulation in Background
7.5 Cannot Run 3270 Emulation without a Menu Interface
7.6 Cannot Tell Which Terminal Keys Correspond to Various 3270 Keys
7.7 Characters on Display Do Not Match Keys Pressed
7.8 Customize Menu Options Not Selectable
7.9 Display Colors Are Different from Those Selected
7.10 Display Is Incomplete or Hard to Read
7.11 Error-3270 Failed to Initialize
7.12 Error Message-3270 User Not Found
7.13 Error Message-No 3270 Sessions
7.14 Error Message-No 3270 Users
7.15 Failed to Initialize Windowing System
7.16 Fields Cannot Be Changed or Edited
7.17 File Menu Options Not Selectable
7.18 File Transfer Process 'Hung'
7.19 HLLAPI Application Does Not Work
7.20 Host Language Option Not Selectable
7.21 Host Response Times Option Not Selectable
7.22 Last Transaction Time Indicator (LTTI) on Status Line Does Not Appear
7.23 Main Screen Invoked Instead of 3270 Session
7.24 Model Type Radio Group Is Not Selectable
7.25 NetView Alert Not Accepted
7.26 NetView Alerts Option Not Selectable
7.27 Open Option Is Not Selectable
7.28 Style File Contains Invalid Maximum Structured Field Size
7.29 Unable to Obtain System Semaphores
Appendix A: Required and Recommended Functions in the terminfo Database
Appendix B: Default Keyboard Mappings
B.1 Functions within Groups and Corresponding Keys
B.1.1 Program Function Keys
B.1.2 Program Access Keys
B.1.3 Printer Control Keys
B.1.4 3270 System Keys
B.1.5 Miscellaneous System Keys
B.1.6 Session Selection Keys
B.1.7 Edit Keys
B.1.8 3179G System Keys
B.1.9 Character Keys
B.2 Alphabetical List of Functions and Corresponding Keys
Appendix C: Status Line Information
C.1 How the Status Line Is Displayed
C.1.1 Status Line Display Modes
C.1.2 Status Line Display for Keystroke Recording and Replay
C.1.3 Status Line Help
C.2 Overview of the Status Line
C.3 Session Status Messages
C.4 Do Not Enter Messages
C.5 Communications Check Codes
C.6 Last Transaction Time Indicator
C.7 Numeric Indicator
C.8 Insert Indicator
C.9 Printer Identifier
C.10 Record/Replay ID
C.11 LU Name
C.12 Cursor Position Message
C.13 Session ID
C.14 Background Transparency Indicator
C.15 Program Symbol Set Indicator
C.16 Character Set Indicator
C.17 Extended Highlight Indicator
C.18 Extended Color Indicator
C.19 Program Check Codes
Appendix D: File Transfer Messages
D.1 Menu Interface File Transfer Messages
D.2 Host File Transfer Messages
Appendix E: Print Style File Utility
E.1 Command Format
E.2 Output
E.3 Error Messages
Appendix F: International Support
F.1 Overview of International Language Support
F.2 Generating International Characters
F.3 Setting Up Internationalization Options at Start of Day
Appendix G: Supported Code Pages
G.1 ASCII Code Pages
G.2 EBCDIC Code Pages
Index