Change CICS TCT Entry (CHGCICSTCT)

Use the Change CICS Terminal Control Table (CHGCICSTCT) command to change an entry in the TCT.

Each TCT entry defines one of the following:

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

Top

Remote CICS system (SYSID)

The system identifier defined in the TCS Table of the remote device.

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.

Possible SYSID values are:

*SAME: The value currently specified in the TCT entry will remain the same.
*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 identifier by which the terminal is known on the remote system. This parameter is not valid when SYSID(*NONE) is specified.

Possible RMTDEV values are:

*SAME: The value currently specified in the TCT entry will remain the same.
*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)

Indicates the type of terminal.

Possible DEVTYPE values are:

*SAME: The value currently specified in the TCT entry will remain the same.
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 file to be used by the terminal. This is only valid when DEVTYPE is specified as SCS, 3270P, or 3270JP.

Possible library values are:

*SAME: The value currently specified in the TCT entry will remain the same.
*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.

Possible file name values are:

*SAME: The value currently specified in the TCT entry will remain the same.
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.

Possible DEVD values are:

*SAME: The value currently specified in the TCT entry will remain the same.
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 or not this terminal can be used as a model to autoinstall further terminals. This is only valid when DEVTYPE(5250), DEVTYPE(3270), DEVTYPE(3270J), or DEVTYPE(3151) is specified.

Possible DEVMODEL values are:

*SAME: Keep the value currently specified in the TCT entry.
*TERMINAL: The terminal cannot be used as a model to autoinstall further terminals.
*MODEL: The terminal can only be used as a model to autoinstall further 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.

Possible NETWORK values are:

*SAME: Keep the value currently specified in the TCT entry.
*CICSDEV: The terminal suffixed with 4 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:

*SAME: The value currently defined in the TCT will remain the same.
*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).

Status (DEVSTS)

Indicates whether or not the terminal can be used by the control region when the TCT entry is defined to the runtime resource table definition Terminal Control facility.

Possible DEVSTS values are:

*SAME: Keep the current value specified in the TCT entry.
*ENABLED: The terminal can be used by the control region.
*DISABLED: The terminal cannot be used by the control region.

ATI supported (ATISTS)

Indicates whether the terminal can be used by transactions that are initiated automatically by the control region, or is an ISC session. An ISC session is for transactions that are using the terminal as an alternate facility to communicate with another CICS system.

Possible ATISTS values are:

*SAME: Keep the value currently specified in the TCT entry.
*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 whether or not the terminal is allowed to initiate transactions.

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

Possible TTISTS values are:

*SAME: Keep the value currently specified in the TCT entry.
*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.

Possible DEVCHRID values are:

Element 1: Code Page

The code page to be used.

*SAME: Keep the value currently specified in the TCT entry.
*SYSVAL: Use the iSeries system code page.
code-page: The code-page-number 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.
*SAME: Keep the value currently specified in the TCT entry.
*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 to 65535.

Transaction (TRANSID)

The transaction identifier defined in the PCT, when it is the only transaction allowed to run on the terminal.

Possible TRANSID values are:

*SAME: Keep the value currently specified in the TCT entry.
*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.

Auto upper case translation (UCTRN)

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

Possible UCTRN values are:

*SAME: Specifies that the value currently specified in the TCT entry is to apply.
*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 entered in lowercase 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.

Possible ALTSCN values are:

*SAME: Keep the value currently specified in the TCT table.
*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:

*SAME: Keep the value currently specified in the TCT entry.
*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:

*SAME: Keep the value currently specified in the Terminal Control Table entry.
*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.