Add CICS TCT Entry (ADDCICSTCT)

Use the Add CICS Terminal Control Table (ADDCICSTCT) command to add an entry to the TCT. Use the TCT to define:

The characteristics of a display terminal or printer, that may be used by transactions running on this system. The terminal may be local or remote.
A model terminal for automatic installation (autoinstall). Since many terminals have several characteristics in common and their resource definitions would be identical, you can use the TCT to create a model definition that applies to a number of terminals. This model is used by CICS to create the necessary terminal definitions when the system is started.
A terminal to be used for automatic transaction initiation.

Parameters

Keyword	Description	Choices	Notes
LIB	Library	Communications name, LIBL, CURLIB	Required, Positional 1
GROUP	Group	Communications name	Required, Positional 2
CICSDEV	CICS device	Communications name	Required, Positional 3
SYSID	Remote CICS system	Communications name, *NONE	Optional, Positional 4
RMTDEV	Remote CICS device	Communications name, *CICSDEV	Optional, Positional 5
DEVTYPE	Device type	5250, 3270, 3270P, 3270J, 3270JP, 3151, SCS	Optional, Positional 6
PRTFILE	Print file	Qualified object name	Optional, Positional 7
	Qualifier 1: Print file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
DEVD	Device description	Name	Optional, Positional 8
DEVMODEL	Autoinstall model	TERMINAL, MODEL, *BOTH	Optional, Positional 9
NETWORK	Network	Communications name, *CICSDEV	Optional, Positional 10
ALTSUFFIX	Alternate map set suffix	0-9, *NONE	Optional, Positional 11
DEVSTS	Status	ENABLED, DISABLED	Optional, Positional 12
ATISTS	ATI supported	NO, YES	Optional, Positional 13
TTISTS	Transaction entry supported	NO, YES	Optional, Positional 14
USRARASIZE	User area size	0-255, 0	Optional, Positional 15
DEVCHRID	Character identifier	Element list	Optional, Positional 16
	Element 1: Code page	1-65535, *SYSVAL
	Element 2: Graphic character set	1-65535, *SYSVAL
TRANSID	Transaction	Character value, *ANY	Optional, Positional 17
KATAKANA	Japanese alphabet supported	NO, YES	Optional, Positional 18
SOSI	User specified DBCS data	NO, YES	Optional, Positional 19
UNATTEND	Unattended mode	NO, YES	Optional, Positional 20
UCTRN	Auto upper case translation	NO, YES, *TRANID	Optional, Positional 21
ALTSCN	Alternate screen size	*NONE, 24X80, 27X132	Optional, Positional 22
VALIDATION	Validation capability	NO, YES	Optional, Positional 23
LIGHTPEN	Light pen supported	NO, YES	Optional, Positional 24
SHIP	Ship to another CICS system	NO, YES	Optional, Positional 25
DEVACQ	ATI acquire	NO, YES	Optional, Positional 26
DSCOMP	Datastream compression	SITVAL, NO	Optional, Positional 27

Top

Remote CICS system (SYSID)

The name of the remote system identifier defined in the TCS Table in which the device is located.

Note: This entry will be installed as if SYSID(*NONE) was specified, into the runtime resource table definitions Terminal Control facility, when the control region has the same system identifier.

The possible SYSID values are:

*NONE: The terminal is defined to the same control region in which it is being used.
system-identifier: The system identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Remote CICS device (RMTDEV)

The name by which the terminal is known in the remote system. This field is not valid when SYSID(*NONE) is specified.

The possible RMTDEV values are:

*CICSDEV: The terminal associated to the TCT is to be used.
remote-terminal: The remote terminal may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Device type (DEVTYPE)

Type of the CICS terminal.

The possible DEVTYPE values are:

5250: Terminal supporting 5250 data stream.
3270: Terminal supporting 3270 data stream.
3270P: Printer supporting 3270 data stream.
3270J: Double-byte capable display.
3270JP: Double-byte capable printer.
3151: ASCII display.
SCS: Printer supporting SCS data stream.

Print file (PRTFILE)

The name of the print spool file that will be used by this terminal. This is only valid when DEVTYPE is specified as SCS, 3270P, or 3270JP.

Possible library values are:

*LIBL: The library list for the job that is associated to the control region is used to locate the file.
*CURLIB: The current library for the job that is associated to the control region is used to locate the file. If no library is specified as the current library, the QGPL library is used.
library-name: Specify the name of the library where the file is located.

print-file-name: Specify the name of the file.

Device description (DEVD)

The iSeries device name that is associated with the terminal. This is only required when SYSID(*NONE) is specified and DEVTYPE(SCS) and DEVMODEL(*MODEL) are not specified.

device-description: The device description may have a maximum length of 10 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Autoinstall model (DEVMODEL)

Indicates whether this terminal can be used as a model to autoinstall terminals. This is only valid when DEVTYPE(5250), DEVTYPE(3270), DEVTYPE(3270J), or DEVTYPE(3151) is specified.

The possible DEVMODEL values are:

*TERMINAL: The terminal can not be used as a model to autoinstall further terminals.
*MODEL: The terminal can only be used as a model to autoinstall terminals.
*BOTH: The terminal can be used as a model to autoinstall further terminals.

Network (NETWORK)

The symbolic network name used to identify the logical unit as it is known throughout the network. The name is supplied to VTAM system definition and is used to build the node initialization block (NIB). This is not valid when DEVMODEL(*MODEL) is specified.

The possible NETWORK values are:

*CICSDEV: The terminal suffixed with four blanks will be used as the symbolic network name.
network: The network may have a maximum length of 8 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Alternate map set suffix (ALTSUFFIX)

Enter a number to specify an alternate suffix for this device.

Possible values are:

*NONE: The device will not have a user defined alternate suffix.
0 - 9: This numeric suffix will be appended by BMS to map set names, if the transaction uses the alternate screen size. (or if the default and alternate screen sizes are the same).

ATI supported (ATISTS)

Indicates whether the terminal can be used for ATI transactions, or for an ISC session. ISC sessions are for transactions using the terminal as an alternate facility to communicate with another CICS system.

The possible ATISTS values are:

*NO: The terminal cannot be used by the control region ATI facility.
*YES: The terminal can be used by the control region ATI facility.

Transaction entry supported (TTISTS)

Indicates if the terminal is allowed to initiate transactions.

Note: When ATISTS(*NO) is specified, then this parameter must have *YES.

The possible TTISTS values are:

*YES: The terminal can initiate transactions.
*NO: The terminal cannot initiate transactions.

Character identifier (DEVCHRID)

The code page and character set to be used with the terminal.

The possible DEVCHRID values are:

Element 1: Code Page

The code page to be used.

*SYSVAL: Use the iSeries system code page.
code-page: The code-page must be numeric, greater than or equal to 1 and less than or equal to 65535.
Element 2: Character Set

The graphic character set to be used.
*SYSVAL: Use the iSeries system character set.
character-set: The character-set must be numeric, greater than or equal to 1 and less than or equal 65535.

Transaction (TRANSID)

The transaction identifier defined in the PCT when it is the only transaction that can be executed on the terminal.

The possible TRANSID values are:

*ANY: Any transaction can be executed on the terminal.
transaction-identifier: The transaction identifier may have a maximum length of 4 characters. Any characters on the keyboard can be entered, but lowercase letters and special characters should be enclosed in apostrophes.
When there is not enough space to enter the apostrophes, then enter an ampersand (&) in the first character position to get an extended field size that allows for the entry of additional characters. Blanks are accepted but, when the entry is defined to a control region, anything after the blank is ignored. For example, 'ab g' will be treated as 'ab' in the control region.

Hexadecimal characters should be enclosed in apostrophes and preceded by an uppercase X, for example X'A1A2A3A4'. Any hexadecimal value will be accepted, but, if the value is not a printable character, the entry will be rejected when it is defined to a control region.

Japanese alphabet supported (KATAKANA)

Indicates whether Katakana support is required. Katakana terminals cannot display mixed case output; uppercase characters appear as uppercase English characters, but lowercase characters appear as Katakana characters. BMS will provide automatic upper- casing of lower case Latin characters in BMS fields where the CASE=MIXED options specified, if Katakana support is required on terminal where the map is to be displayed.

User written application may query this terminal attribute and provide additional support.

Possible values are:

*NO: Terminal does not require Katakana support.
*YES: Terminal does require Katakana support.

Auto upper case translation (UCTRN)

Indicates whether the terminal input is to be translated to uppercase.

The possible UCTRN values are:

*NO: Specifies that data entered in lowercase from a terminal is not to be translated to uppercase. For execution of a given program you can override this by the UCTRN setting in the Program Control Table.
*YES: Specifies that data entered in lowercase from a terminal is to be translated to uppercase.
*TRANID: Specifies that transaction identifiers containing any lowercase characters entered from a terminal are to be translated to uppercase. All other input is to be handled as UCTRN=*NO.

Alternate screen size (ALTSCN)

Indicates the alternate screen height and width associated with the terminal.

The possible ALTSCN values are:

*NONE: No alternate screen size will be used.
24x80: 24 rows and 80 columns will be used as the alternate screen size.
27x132: 27 rows and 132 columns will be used as the alternate screen size.

ATI acquire (DEVACQ)

Indicates whether or not the terminal is to be acquired by transactions that are initiated automatically by the control region.

The possible DEVACQ values are:

*NO: The control region ATI facility will wait to initiate the transaction, until the terminal is in an acquire state.
*YES: The control region ATI facility will acquire the terminal if it is not already in an acquire state, prior to initiating the transaction.

Datastream compression (DSCOMP)

Indicates whether or not datastream compression may be performed for this terminal.

Possible values are:

*SITVAL: Specifies that datastream compression may be performed for this terminal, depending on the value specified for the DSCOMP keyword in the System Initialization Table.
*NO: Specifies that datastream compression should not be performed for this terminal.