|
|
|
|
This section applies only to 3270 emulation, not to 3179G. For information about starting the 3179G emulation program, see Starting the 3179G Emulation Program.
Before starting the 3270 emulation program, make sure that you are configured as a 3270 user and that the SNAP-IX software has been started. Contact your System Administrator.
To start the 3270 emulation program, enter the following command at the Solaris command prompt:
sna3270[-s[ /path/]stylefile] [-t [/ path/]convfile] [-e | -b] [-h IDlist] [-l LUlist] [-p]
To start the Motif version of the program, type the following:
xsna3270 [-s[ /path/]stylefile] [-t [/ path/]convfile] [-h IDlist] [-l LUlist] [-p]
Following are descriptions of the options available with the command to start the 3270 emulation program:
Loads the specified style file. If you include , it must be followed by a style file name (with or without a directory path).
If you specify a path, the program tries to open the file in the directory given; if no path is given, the file is assumed to be in the current directory. The style file name must have the extension .stu, but you need not specify this extension (the 3270 emulation program adds it if you do not specify it). If you do not specify a style file, the 3270 emulation program uses the default style file specified in the configuration file. For more information, see Search Path for Style Files.
Your System Administrator may have configured the 3270 emulation program so that you do not have permission to use your own style file. In this case, the 3270 emulation program displays a warning message and runs with the default style file specified in the configuration rather than the one you specify here.
Used if you need to communicate with hosts using foreign language versions of EBCDIC. This option enables you to specify a host language other than U.S. English, and to remap your keyboard to include any characters specific to that language (for more information about keyboard remapping, see Customizing 3270 Emulation). This option should be used only if your operating system and your terminal's hardware are set up to use the ISO8859 character set (for more information, see International Support). If you do not use this option, the host language defaults to U.S. English and you cannot change it. You cannot use this option with the option.
The option is not required with the Motif program; international language characters are always supported.
Used if you need to specify your own conversion table file for converting between ASCII and EBCDIC. Your SNAP-IX TN3270 product supplier or your System Administrator can tell you whether to use this option. The convfile parameter represent the name of a file containing the translation table; for details of the format required for this file, see Translation Table File Format. If the file is not in the current directory, include the full path. You cannot use this option with the option.
Used to suppress the menu interface so that you can save runtime memory. However, using this option limits you to using only the 3270 emulation sessions already configured. The menu interface is inaccessible. Therefore, if you use this option, you must use a style file that has at least one initially active display session of a suitable model size for your monitor. For more information about style files, see Customizing 3270 Emulation.
Starts the 3270 emulation program as a background process. To save memory, the menu interface process is disabled (it would be inaccessible in any case). This option cannot be used with the option. For more information, see Running 3270 Emulation in the Background.
The and options are not available with the Motif program. The main screen menus are available in the Motif program, and only sna3270 can be run in the background.
Specifies session IDs to be used with your 3270 sessions. The option must be followed by a list of one-byte hexadecimal values representing ASCII characters, separated by commas. Any value in the range 0x01-0xFF can be used, as long as it does not match any other session ID or session long name used with this 3270 emulation program. These session IDs are assigned to each session in turn.
Two consecutive commas indicate that no session ID is being assigned; in this case, or if the list contains fewer session IDs than your configured sessions, the session IDs specified in the style file are used instead. If one of your sessions is a printer session, for which session IDs do not apply, the corresponding ID is ignored.
For example, if you have five sessions of which sessions 2 and 4 are printer sessions, specifying the string -h 0x01,0x02,,0x04 is interpreted as follows: the ID for session 1 is set to 0x01, the IDs for sessions 2 and 4 (the printer sessions) are ignored, and the IDs for sessions 3 and 5 are taken from the style file (because you did not specify IDs for these sessions).
Session IDs specified on the command line apply only to the current run of the 3270 emulation program; they cannot be saved in a style file. To use the same command-line session IDs again, you can create a shell script to start the program with the correct command-line parameters.
Specifies LUs or LU pools to be used with your 3270 sessions. Using the option is equivalent to remapping the sessions to different LUs or pools using the <Remap> push button on the Control Display Sessions or Control Printer Sessions dialog; you can use it only if your System Administrator has given you permission to remap sessions. The option must be followed by a list of up to ten LU names or LU pool names, corresponding to 3270 LUs or LU pools in the configuration file, separated by commas. These LUs or pools are assigned to each session in turn.
Two consecutive commas indicate that no LU or pool is being assigned; in this case, or if the list contains fewer names than your configured sessions, the LUs or pools specified in the style file are used instead. If the list contains more names than your configured sessions (up to the maximum of ten names), the additional sessions are assigned and you can activate them as required. However, the limit specified in the configuration file for the maximum number of sessions you can enable at one time still applies.
For example, if you have three configured sessions mapped to LUs LU 1, LU 2, and LU 3, and you specify the string -l LU3,,LU4, then session 1 will use LU 3, session 2 will use LU 2 as before, and session 3 will use LU 4. If you specify the string -l LU3,,LU4,LU5, then you will now have four available sessions using LU 3, LU 2, LU 4, and LU 5; however, if the Maximum enabled sessions value in your configuration file is 3, you will not be able to use more than three sessions at a time.
Normally, the names you specify should be either the names of 3270 LUs that are not in pools, or the names of LU pools. If you specify the name of a 3270 LU that is in an LU pool, the session will use this specific LU if it is available; otherwise, another LU from the pool will be assigned to the session.
If a name you specify does not correspond to the name of a 3270 LU or LU pool in the configuration file, the emulation program will start, but you will not be able to connect to the host using that session. Check that the names are valid, and restart the program using the correct name. If the list contains more than ten names, an error message is displayed and the 3270 emulation program does not start; you cannot assign more than ten sessions for a single 3270 emulation program.
This option is provided for advanced users only; most users will not need to use it.
Specifies that the emulation program retains Set Horizontal Format (SHF) and Set Vertical Format (SVF) information specified by the host until an UNBIND or CLEAR is received. Without this option, the emulation program resets the SHF and SVF information at the end of a bracket (this is the normal operation).
The translation table file has the same format as the Table G file used by the Common Service Verb CONVERT (refer to the SNAP-IX CSV Programmer's Guide for more information). It is an ASCII file 32 lines long. Each line consists of 32 hexadecimal digits, representing 16 characters. The first 16 lines (256 characters) specify the EBCDIC characters to which ASCII characters are converted; the remaining 16 lines specify the ASCII characters to which EBCDIC characters are converted. The hexadecimal digits A-F can be either uppercase or lowercase.
The file /opt/sna/samples/3270conv.dat listed below, contains a sample conversion table. This table converts between code pages 437 (ASCII) and 037 (EBCDIC), except that ASCII characters that do not correspond to valid 3270 characters, or that cannot be displayed on most terminals, are mapped to zero.
00000000000000000000000000000000 00000000000000000000000000000000 405A7F7B5B6C507D4D5D5C4E6B604B61 F0F1F2F3F4F5F6F7F8F97A5E4C7E6E6F 7CC1C2C3C4C5C6C7C8C9D1D2D3D4D5D6 D7D8D9E2E3E4E5E6E7E8E900E000006D 79818283848586878889919293949596 979899A2A3A4A5A6A7A8A9C06AD0A100 00000000000000000000000000000000 00000000000000000000000000000000 00000000000000000000000000000000 00000000000000000000000000000000 00000000000000000000000000000000 00000000000000000000000000000000 00000000000000000000000000000000 00000000000000000000000000000000 200102032D092D7F2D2D2D0B20200E0F 101112132D20082D18202D2D2A1D3B1F 2D2D2D2D2D0A171B2D2D2D2D2D050607 2D2D162D2D2D2D042D2D2D2D2D2D2D1A 20FF838485A02D8687A45B2E3C282B7C 268288898AA18C8B8DE121242A293BAA 2D2F2D8E2D2D2D8F80A57C2C255F3E3F 2D902D2D2D2D2D2D2D603A2340273D22 2D616263646566676869AEAF2D2D2DF1 F86A6B6C6D6E6F707172A6A7912D922D E67E737475767778797AADA82D2D2D2D 5E9C9DFA2D1514ACAB2D5B5D2D2D2D2D 7B4142434445464748492D939495A22D 7D4A4B4C4D4E4F5051522D968197A398 5CF6535455565758595AFD2D992D2D2D 303132333435363738392D2D9A2D2D2D
|
|
|
 |
|