Change CICS TCT Entry (CHGCICSTCT)
Where allowed to run:
|
Parameters Examples Error messages |
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.
| Top |
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 |
Library (LIB)
Enter the name of the library that contains the group. Possible values are:
- *LIBL: The library list is used to locate the first library that contains the group.
- *CURLIB: The current library contains the group. If no current library is specified, the QGPL library is used.
- library-name: The name of the library that contains the group.
| Top |
Group (GROUP)
The name of the group containing the TCT entry to be changed.
- group-name: The group name 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 #.
| Top |
CICS device (CICSDEV)
The terminal used to work with a device. This field is used to identify this TCT entry.
- terminal-identifier: The terminal 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 #.
| 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 #.
| Top |
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 #.
| Top |
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.
| Top |
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.
| Top |
Device description (DEVD)
The IBM i 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 #.
| Top |
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.
| Top |
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 #.
| Top |
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).
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
User area size (USRARASIZE)
The length of the user area associated with the terminal.
Possible USRARASIZE values are:
- *SAME: Keep the value currently specified in the TCT entry.
- user-area-length: The user-area-length must be numeric, greater than or equal to 0 and less than or equal to 255.
| Top |
Character identifier (DEVCHRID)
The code page and character set to be used with the terminal.
Possible DEVCHRID values are:
- *SAME: Keep the value currently specified in the TCT entry.
- *SYSVAL: Use the i 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 i character set.
- character-set: The character-set must be numeric, greater than or equal to 1 and less than or equal to 65535.
Element 1: Code Page
The code page to be used.
| Top |
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.
| Top |
Japanese alphabet supported (KATAKANA)
Indicates whether or not the terminal is to support double-byte characters.
Possible KATAKANA values are:
- *SAME: Keep the value currently specified in the TCT entry.
- *NO: The terminal does not support double-byte characters.
- *YES: The terminal supports double-byte characters.
| Top |
User specified DBCS data (SOSI)
Indicates whether or not the terminal has mixed EBCDIC/DBCS field capability.
Possible SOSI values are:
- *SAME: Keep the value currently specified in the TCT entry.
- *NO The terminal does not have mixed EBCDIC/DBCS field capability.
- *YES: The terminal has mixed EBCDIC/DBCS field capability.
| Top |
Unattended mode (UNATTEND)
Indicates whether or not the mode of operation for the terminal is unattended.
Possible UNATTEND values are:
- *SAME: Keep the value currently specified in the TCT entry.
- *NO: The terminal is to have an attended mode of operation.
- *YES: The terminal is to have an unattended mode of operation.
| Top |
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.
| Top |
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.
| Top |
Validation capability (VALIDATION)
Indicates whether or not the terminal has validation capability. This consists of the mandatory fill and mandatory enter.
Possible VALIDATION values are:
- *SAME: Keep the value currently specified in the TCT entry.
- *NO: The terminal does not have validation capability.
- *YES: The terminal has validation capability.
| Top |
Light pen supported (LIGHTPEN)
Indicates whether or not the terminal has light pen capability.
Possible LIGHTPEN values are:
- *SAME: Keep the value currently specified in the TCT entry.
- *NO: The terminal does not have light pen capability.
- *YES: The terminal has light pen capability.
| Top |
Ship to another CICS system (SHIP)
Indicates whether or not the terminal definition may be shipped to a remote CICS system.
Possible SHIP values are:
- *SAME: Keep the value currently specified in the TCT entry.
- *NO: The terminal definition may not be shipped to a remote CICS system.
- *YES: The terminal definition may be shipped to a remote CICS system.
| Top |
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.
| Top |
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.
| Top |
Examples
None| Top |
Error messages
Unknown| Top |