Sequential devices—DFHTCT TYPE=TERMINAL

Read syntax diagramSkip visual syntax diagram
>>-DFHTCT--TYPE=TERMINAL--+--------------------+---------------->
                          |          .-120---. |   
                          '-,LPLEN=--+-------+-'   
                                     '-value-'     

>--+-------------------------+---------------------------------->
   '-,PGSIZE=(lines,columns)-'   

>--+---------------------------------------------+-------------->
   |           .-number-specified-in-TYPE=LINE-. |   
   '-,TCTUAL=--+-------------------------------+-'   
               '-number------------------------'     

>--+------------------------------------------+----------------->
   '-,TRANSID=transaction-identification-code-'   

>--+-----------------------+------------------------------------>
   |            .-0------. |   
   '-,TRMPRTY=--+--------+-'   
                '-number-'     

>--+-----------------------------------------------------------+-><
   |            .-TRANSACTION------------.                     |   
   '-,TRMSTAT=--+------------------------+--+----------------+-'   
                '-(--status--+------+--)-'  '-,USERID=userid-'     
                             '-,...-'                              

LPLEN={120∨value}
Controls the length of the print line for SAM output line printers. If no NL symbol is found in a segmented write, the print line length is the LPLEN value. The default is LPLEN=120.
PGESIZE=(lines,columns)
The default page size for a 1403 or CRLP terminal is (12,80). Code PGESIZE if BMS is required for a device that has TRMTYPE=DASD specified, and specify the number of lines and columns you wish to use. These two values multiplied together must equal the value specified for INAREAL. The product of lines and columns must not exceed 32767.
TCTUAL={number-specified-in-TYPE=LINE ∨number}
Indicates the length in bytes (0 through 255) of the user area (the process control information field or PCI) for the terminal entry (TCTTE) associated with this terminal. Make it as small as possible. The TCT user area is initialized to zeros at system initialization.

Use the TCTUAL operand of the DFHTCT TYPE=TERMINAL macro if you want fields of different (variable) lengths for terminals associated with this line. In any case, the PCI field is generated for each terminal after the last terminal entry of the last line. The address of the PCI field is located at TCTTECIA; the length is located at TCTTECIL.

TRANSID=transaction-identification-code
Code this with a 1- to 4-character transaction code. This code specifies a transaction that is to be initiated each time input is received from the terminal when there is no active task.

If a TRANSID is not specified in the TCTTE, the TRANSID in a RETURN command from the previous transaction is used. Otherwise, the first one to four characters of the data passed in the TIOA are used as the transaction code. A delimiter is required for transaction identifications of fewer than four characters.

TRMIDNT=name
Code this with a unique 4-character symbolic identification of each terminal. The identification supplied is left-justified and padded with blanks to four characters if less than four characters are supplied.

The value CERR is reserved, as this is the identification generated for the error console.

TRMPRTY={0∨number}
Establishes the terminal priority. This decimal value (0 through 255) is used in establishing the overall transaction processing priority. (Transaction processing priority is equal to the sum of the terminal priority, transaction priority, and operator priority, and must not exceed 255.)
TRMSTAT={TRANSACTION∨(status,...)}
Code this with the types of activity that may occur at a given terminal. This terminal status is initially set in the TCTTE and is a combination of the processing status and the service status.
TRANSACTION
A terminal with TRANSACTION status is used in the processing of transactions such as inquiries or order entries. A display station or a hard-copy terminal, to which no messages are sent without a terminal request, and through which transactions are entered, is a TRANSACTION terminal.
INPUT
Indicates a terminal that can send messages to, but cannot receive messages from, CICS.
Note: System messages may be routed to an input terminal under conditions such as invalid transaction identification and ATP batch count. This causes DFHTACP to be scheduled. To handle this situation, code a DFHTEP to perform any action that the user requires.
'OUT OF SERVICE'
Indicates a terminal that can neither receive messages nor transmit input. Such terminals are not polled by CICS. The 'OUT OF SERVICE' parameter can be used in combination with any status setting.

Any terminal except the master terminal can be designated as 'OUT OF SERVICE'. When appropriate, the terminal can be placed in service by the master terminal and polling is resumed.

RECEIVE
Indicates a terminal to which messages are sent but from which no input is allowed. An example of this type of terminal is one that is located in a remote location, such as a warehouse, and is unattended, but may receive messages. Automatic transaction initiation is implemented as for TRANSCEIVE, below.
TRANSCEIVE
A terminal with TRANSCEIVE status is a TRANSACTION terminal to which messages are sent automatically. The automatic transaction initiation, either by transient data control or interval control, sets a condition in an appropriate terminal control table terminal entry. If the terminal status is TRANSCEIVE and if there is no transaction at the terminal, terminal control initiates the user-defined task. This task is expected to send messages to the terminal.
USERID=userid
Code this to specify a user identifier for devices such as printers that are unable to sign on using CESN. (You can also specify USERID for a display device, in which case the display is permanently signed on. Operators are unable to sign on.) You must code this operand if you want to use preset security with this device. All access to protected resources depends on USERID.

The userid is referred to in security error messages, security violation messages, and the audit trail. It must be defined to the security manager.

Userid must be a unique 1- to 8-character user identification. (A-Z 0-9 # $ and @ are acceptable characters.)