Change CICS PCT Entry (CHGCICSPCT)

Use the Change CICS Program Control Table (CHGCICSPCT) command to change an entry in the PCT.

The Program Control Table (PCT) contains a definition for each transaction that may be run from this system. Each local transaction must be linked with a program which is defined in the Program Processing Table (PPT). Each remote transaction should have an associated remote system identifier which is defined in the Terminal Control Table (System Entry) (TCS).

Parameters

Keyword	Description	Choices	Notes
LIB	Library	Communications name, LIBL, CURLIB	Required, Positional 1
GROUP	Group	Communications name	Required, Positional 2
TRANSID	Transaction	Character value	Required, Positional 3
SYSID	Remote CICS system	Communications name, SAME, NONE	Optional, Positional 4
RMTTRANSID	Remote transaction	Character value, SAME, TRANSID	Optional, Positional 5
PGMID	CICS program	Communications name, *SAME	Optional, Positional 6
TRANSTS	Status	SAME, ENABLED, *DISABLED	Optional, Positional 7
PURGE	Can be purged while executing	SAME, YES, *NO	Optional, Positional 8
WAITTIME	Maximum deadlock wait time	0-7000, *SAME	Optional, Positional 9
IDLETIME	Maximum device I/O wait time	0-7000, *SAME	Optional, Positional 10
DUMP	Dump when Abend	SAME, YES, *NO	Optional, Positional 11
TWASIZE	Transaction work area size	0-32767, *SAME	Optional, Positional 12
SCRNSZE	Screen size used	SAME, DFT, *ALT	Optional, Positional 13
LCLQUEUE	Local system queuing	SAME, YES, *NO	Optional, Positional 14
UCTRN	Auto upper case translation	SAME, NO, *YES	Optional, Positional 15

Top

Library (LIB)

Enter the name of the OS/400 library that contains the group. Possible values are:

*LIBL: The library list is used to locate the first OS/400 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 OS/400 library that contains the group.

Group (GROUP)

Enter the name of the group to which the PCT entry to be changed belongs.

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 #.

Transaction (TRANSID)

Enter the transaction identifier of the PCT entry to be changed.

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.

Remote CICS system (SYSID)

Enter the name of the remote system that owns the transaction.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
*NONE: The transaction is held on the local system.
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 transaction (RMTTRANSID)

Enter the identifier by which the transaction is known on the remote system. This field is not valid for the local system, that is when the system identifier field contains *NONE.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
*TRANSID: The local and remote transaction identifiers are the same. The name in the transaction identifier field will be used.
remote-transaction-identifier: The remote 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.

CICS program (PGMID)

Enter that name of the program to be started by this transaction identifier. This program should have a PPT entry. This field is valid only for the local system, that is when the system identifier field contains *NONE.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
program-identifier: The program identifier 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 #.

Status (TRANSTS)

Indicates whether or not the transaction may be used.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
*ENABLED: The transaction may be used.
*DISABLED: The transaction may not be used.

Can be purged while executing (PURGE)

Indicates whether or not the transaction may be purged.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
*YES: The transaction may be purged.
*NO: The transaction may not be purged.

Maximum deadlock wait time (WAITTIME)

Enter the amount of time in seconds that the transaction can be in a dead lock state. The format is mmss

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
dead-lock-timeout: A number in the range 0 through 7000 (70 minutes). When the value specified is a 0, then the transaction identifier can be in a dead lock state for an unlimited amount of time.

Maximum device I/O wait time (IDLETIME)

Enter the amount of time in seconds that the transaction waits for terminal input or output. The format is mmss.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
read-timeout: A number in the range 0 through 7000 (70 minutes). When the value specified is a 0, then the transaction identifier can wait for unlimited amount of time for terminal input or output.

Dump when Abend (DUMP)

Indicates whether or not a transaction dump is taken when the transaction terminates abnormally. This field is valid only for the local system, that is when the system identifier field contains *NONE.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
*YES: Take a transaction dump.
*NO: Do not take a transaction dump.

Transaction work area size (TWASIZE)

Enter the size of the associated Transaction Work Area (TWA). This field is valid only for the local system, that is when the system identifier field contains *NONE.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
twa-size: A number in the range 0 through 32767. Enter 0 if there is no TWA associated with the transaction.

Screen size used (SCRNSZE)

Indicates whether the default or the alternate screen size associated with the terminal to be used to run the transaction.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
*DFT: The default screen size is to be used.
*ALT: The alternate screen size is to be used.

Local system queuing (LCLQUEUE)

Indicates whether or not queuing on the local system is to be performed.

Possible values are:

*SAME: Keep the value currently specified in the PCT entry.
*YES: Local system queuing is to be performed.
*NO: Local system queuing is not to be performed.

Auto upper case translation (UCTRN)

Indicates whether the terminal input to this transaction is to be translated to uppercase at any terminal on which this transaction is run.

Possible UCTRN values are:

*SAME: Specifies that the value currently specified in the Program Control Table is to apply.
*NO: Specifies that terminal input uppercase translation is dependent upon the UCTRN setting in effect in the Terminal Control Table for each individual terminal.
*YES: Specifies that data entered in lowercase from any terminal is to be translated to uppercase before being passed to this transaction.