cicsterm options

A number of options and parameters are available when using the cicsterm command to start a 3270 terminal emulator.

The options are as follows:
-a
Specifies that the terminal emulator is not sign-on capable. By default, cicsterm creates terminal emulators that are sign-on capable.

For more information on sign-on capability, see Specifying terminal sign-on capability.

-c=colorfile
Specifies a color mapping file to be used with the emulator; this overrides the default color mapping file <install_path>/bin/cicscol.ini, and any color mapping file specified by the CICSCOL environment variable. See Customizing the screen colors for cicsterm for more details.
-e
Specifies that when extended attributes are included in a 3270 datastream received by cicsterm and no color attribute is set, the color of a field is determined by both the intensity and protection attributes. The colors used to display the field are then determined by the normal_unprotected, intensified_unprotected, normal_protected and intensified_protected definitions in the color mapping file. By default, when this option is not specified, the 3270 datastream contains extended attributes and no color attribute is set, the color of fields is determined by the default and default_highlight definitions in the color mapping file. See Customizing the screen colors for cicsterm for further information on color mapping.
-f=printfile
Specifies the name of a file to which the output of print requests is appended. If you do not specify a full path, printfile is created in the <install_path>/bin directory. If the name of the file contains embedded blanks, it must be surrounded by double quotation marks (“). Any double quotation marks within the name of the file must be entered as backslash double quotation mark (\“).

If neither the -f or -p parameters is specified, the Print command or Print file configuration settings define the command, file, or default action to take with print requests.

-k=keyfile
Specifies a keyboard mapping file to be used with the emulator; this overrides the default key mapping file <install_path>/bin/cicskey.ini and any key mapping file specified by the CICSKEY environment variable. For more information, see Keyboard mapping for cicsterm

Start of change Keyboard mapping in cicsterm is governed by the terminal type that you are using. Many terminal types do not support all of the function keys that can be used in a CICS application. If cicsterm does not recognize some of the key mappings defined by the <install_path>/bin/cicskey.ini file, try using a different terminal type. For example, on AIX systems use aixterm in preference to xterm. End of change

-m=modelname
Specifies the name of a Model terminal definition, as known at the server to which the emulator is to connect, to be used to define the terminal characteristics. If neither this parameter nor -n=netname is specified, any Model terminal definition value from the configuration file is used. If no Model terminal definition value has been specified in the configuration file, the server's default terminal definition is assumed.

This option is case-sensitive.

-n=netname
Specifies the name of a particular terminal definition at the server that this emulator is to be installed as. The precise interpretation of netname varies between servers.

This option is case-sensitive.

-p=printcmd
Specifies an operating system command used to process the temporary print file generated when print requests are received by the terminal emulator. If the command contains embedded blanks, enclose it in double quotation marks (“). Any double quotation marks within the command must be entered as backslash double quotation mark (\“).

The temporary print file is post-processed by appending the file name to the command, and running that command. Print output can then be copied to a local printer, copied into a permanent file, processed further for inclusion into a document, and other similar actions. If the temporary file is to be processed by a print command, the command is responsible for deleting the temporary file.

If neither the -f or -p parameters is specified, the Print command or Print file configuration settings define the command, file, or default action to take with print requests.

-q
Disables the display of all messages output by the command.
-s=servername or -r=servername
Specifies the name of the server that the terminal emulator is to be connected to. This server name must correspond to an entry in the configuration file.

You can specify -s, or -r, but not both. If neither parameter is specified, the first server entry in the configuration file is used.

Start of change If the parameter is specified as -s or -r (that is, no server name is provided), and the configuration file identifies more than one potential server to which the Client daemon can connect, the user is prompted to select from a list of available servers. These prompts are generated even if messages have been disabled (the -q parameter is specified). End of change

If there is only one potential server identified in the configuration file, that server is used and the user is not prompted.

-t=initialtransid
Identifies the initial transaction to be invoked for this terminal. If this option is omitted, any initial transaction specified in the configuration file is run. The string can be up to 128 characters long, specifying both a transaction name, and parameters to be passed to the transaction. The transaction name is the first four characters or the characters up to the first blank in the string. The rest of the string is the parameter data.

If the parameter is specified as -t= (that is, the initialtransid is omitted), any initial transaction specified in the configuration file is ignored.

This option is case-sensitive.

Ensure that transaction that you specify here does not require terminal input to complete.

-w
Prompts the user to press the Enter key, to confirm that messages output to the screen (both informational and error) have been read, before the command completes.
-?
Causes the parameter syntax to be listed; any other options specified are ignored.

Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//ctgunx/usterm.html