cicstermp - Printer emulation

Description

• Printers cannot be automatically installed, so there must be an entry in the Terminal Definitions (WD) whose attribute NetName matches the netName specified on the command before a printer can be attached to a region.
• You must understand the working of the 3270 terminal subsystem before using the cicstermp command.

CICS 3270 Terminal Emulators associated with printer devices are identical to normal user CICS 3270 Terminal Emulators, except that printer CICS 3270 Terminal Emulators are not connected to an interactive device, so they can never receive keyboard input. Either CICS must create the printer CICS 3270 Terminal Emulators when the region starts up, using the Terminal Definitions (WD), or you can enter cicstermp with the -P printCommand option.

The -P option or its default, is used to process the data when a print control is detected in the data stream sent to the terminal. The data is placed in a temporary file and the print command is issued with the name of the temporary file appended as a parameter. The temporary file is then erased.

Note that there is no requirement for the print command to actually print the data. It could, for example, copy the data so that it can be incorporated into documentation. Also, note that since the temporary file is immediately erased, the print command must finish processing the file before returning.

Parameters that are only associated with a PostScript printer type (-f, -M, -s and -R), must have valid values. If not, incorrect printer output might result. If any of these parameters are used when PostScript printer type is not used, an error message is sent and cicstermp terminates.

Options

-n netName

Specifies the network name, which is mandatory. The network name determines which printer terminal emulator is selected from the Terminal Definitions.

-r regionName

Specifies the name of the CICS region to which you want to attach.

-h hostList

Specifies a blank-separated list of names or addresses of hosts to be searched for the specified region. If a list of host names is not specified, the contents of the environment variable CICS_HOSTS are used. If CICS_HOSTS is not set, the local machine is searched.

-t transId

Specifies the transaction identifier of the transaction to run after printer CICS 3270 Terminal Emulator initialization.

-P printCommand

Specifies the command used by CICS to process the data sent to the terminal. This command is appended with the name of the temporary file before it is issued. The default is the operating system lp -c command, which in turn uses the default print destination.

-S

Suppresses the insertion of a blank character between single-byte and double-byte characters.

-p printerType

Specifies the type of printer. The valid printer types are “postscript” and “ps55”. These types are valid in either upper or lower case.

-f font

Specifies the default font. The default values are:

Courier                  (for single-byte characters)
GothicBBB-Medium-RKSJ-H  (for Ja_JP)
GothicBBB-Medium-EUC-H   (for ja_JP)

This option is valid only if the printer type is “postscript”.

-M paperType

Specifies the paper size. The valid paper types are:

LETTER, FOLIO, EXECUTIVE, LEGAL, LEDGER, TABLOID,
A0, A1, A2, A3, A4, A5, A6, A7, A8, A9,
B0, B1, B2, B3, B4, B5, B6, B7, B8, B9 and B10.

The default value is A4. This option is valid only if the printer type is “postscript”.

-s fontSize

Specifies the default font size. The default value is 11. This option is valid only if the printer type is “postscript”.

-R

Rotates the printed output through 90 degrees. This option is valid only if the printer type is “postscript”.

-?

Causes the usage message to be displayed.