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