A number of options and parameters are available when using
the cicsprnt command to start a 3270 printer terminal
emulator.
The syntax of the command is:
cicsprnt -m=modelname|-n=netname
[-s=servername|-r[=servername]]
[-t=[initialtransid]]
[-p=printcmd|-f=printfile]
[-q|-w]
[-j]
[-z]
[-b]
[-?]
The options are:
- -b
- By default, cicsprnt does not print blank lines.
A blank line is defined as a line that contains only null characters
or non-displayable fields, or is undefined in the BMS map. This option
causes blank lines in the data stream to be printed.
- -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 of the -f or -p parameters
is provided, the Print command or Print file setting
in the configuration file defines
the command, file, or default action to take with print requests.
- -j
- Specifies that cicsprnt should
concatenate all EXEC CICS® SEND
PRINT commands issued on a server transaction into a single print
job. This print job is issued when the transaction terminates. Otherwise cicsprnt generates
a separate print job for every EXEC CICS SEND
PRINT command issued for a server transaction.
- -m=modelname
- Specifies the name of a model terminal definition, as known at
the server to which the 3270 Print Terminal emulator is to connect,
to be used to define the terminal characteristics. If this parameter
is not 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.
You must
specify either the -m or the -n option,
or both.
This option is case-sensitive
- -n=netname
- Specifies the name of a particular terminal definition at the
server that this 3270 Print Terminal emulator is to be installed as.
The precise interpretation of netname varies between servers. For
example, on TXSeries for AIX® it
is a netname.
You must specify either the -m or the -n option,
or both.
This option is case-sensitive.
- -p=printcmd
- Specifies a command used to process the temporary print file generated
when print requests are received by the terminal emulator. On Windows enter
the full path to the command, even if it is in a directory that appears
in the search path.
If the command contains embedded blanks, the
command must be surrounded by double quotation marks (“). Any double
quotation marks within the command must be entered as backslash double
quotation mark (\“).
If neither of the -f or -p parameters
is specified, the Print command or Print file setting
in the configuration file defines
the command, file, or default action to take with print requests.
The
temporary print file is post-processed by appending the file name
to the command, and executing the resultant command, so reports can
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 processed by a print command, the command is responsible for
deleting the temporary file.
- -q
- Disables the display of all messages output by the command.
- -s=servername or -r=servername
- Specifies the name of the server that the printer is to be connected
to. This servername 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 servername is provided) then, if 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 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 printer.
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.
Note: Be careful that transactions that you specify
either here or in the configuration file do
not require terminal input to complete.
This option is
case-sensitive.
- -w
- Prompts the user, before the command completes, to press the Enter
key, to confirm that messages output to the screen (both informational
and error) have been read.
- -z
- When cicsprnt is running in a DBCS locale and a field containing
mixed DBCS and SBCS character is displayed, blank spaces are inserted
between DBCS and SBCS characters. This option suppresses the insertion
of spaces.
- -?
- Causes the parameter syntax to be listed; any other options specified
are ignored.