cicsterm command reference

The dash (-) may be replaced with the forward slash (⁄) character as follows:
cicsterm [-s[=servername]|-r[=servername]]
[-t=[initialtransid]]
[-k=keyfile] 
[-c[=colorfile]] 
[-m[=modelname]] 
[-a]
[-n=netname] 
[-p=printcmd|-f=printfile] 
[-q|-w] 
[-?]
The options are:
-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 CICS Transaction Gateway: Programming Guide.

-c=colorfile
Identifies the name of a color mapping file to be used with the emulator; see Customizing the screen colors for cicsterm for more details. If you omit this parameter, the environment variable CICSCOL is assumed to identify the color mapping file. If CICSCOL is not defined, a file name of cicscol.ini in the <install_path>bin subdirectory is assumed.

If the parameter is specified as -c=, that is, the color mapping file name is omitted, the emulator runs without any color definitions.

-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 quotes (“). Any double quotes within the name of the file must be entered as backslash double quote (\“).

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
Identifies the name of a keyboard mapping file to be used with the emulator; see Keyboard mapping for cicsterm for more details. If this parameter is omitted, the environment variable CICSKEY is assumed to identify the key mapping file. If CICSKEY is not defined, a file name of cicskey.ini in the <install_path>bin subdirectory is assumed.
-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.

If the parameter is specified as -m= (that is, the modelname is omitted), any Model terminal definition value specified in the configuration file is ignored, and 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 quotes (“). Any double quotes within the command must be entered as backslash double quote (\“).

The temporary print file is post-processed by appending the file name to the command, and executing the resultant command. Thus print output may simply be copied to a local printer, copied into a permanent file, processed further for inclusion into a document, and so on. 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.

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).

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.