|
|
|
|
Before starting the 3179G 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 3179G emulation program, enter the following command at the Solaris command prompt:
xsna3179g [-s[/ path/]stylefile] [-big | -normal | -small] [-cutpaste] [-h IDlist] [-l LUlist ][-p]
Following are descriptions of the options available with the command to start the 3179G 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 SNAP-IX TN3270 product 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 3179G emulation program displays a warning message and runs with the default style file specified in the configuration rather than with the one you specify here.
Specifies the default window size used for the 3179G display. If you specify , the window size is 720 x 512 pixels. If you specify , the window size is 960 x 672 pixels. If you specify , the window size is 480 x 320 pixels. If you do not specify one of these options, is assumed.
You can control the window size only by using these options, and not by resizing the window once the program has started. The sizes given here are the only window sizes supported.
Enables you to use the left and right mouse buttons for Motif cut-and-paste operations on alphanumeric text in the 3179G display. If you do not set , the mouse controls the graphics cursor (if the host application allows this). If you set , the mouse cannot be used to control the graphics cursor. For more information, see Using the Mouse with 3179G Emulation.
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 copy of the 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 3179G 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 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 dialog; you can use it only if your System Administrator has given you permission to remap sessions. The 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 LU3, session 2 will use LU 2, and session 3 will use LU 4. If you specify the string -l LU3,,LU4,LU5, you 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 3179G 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).
|
|
|
 |
|