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