cicsprnt options

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.

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/prntnzn.html