Work with CICS PCT (WRKCICSPCT)

Use the Work with CICS Program Control Table (WRKCICSPCT) command to list entries in the PCT. You can change, remove, copy or display entries in the list, or add new ones.

Parameters

Library (LIB)

Enter the name of the IBM i library which contains the group.

Possible values are:

• *LIBL: The library list is used to locate the first IBM i library that contains the group.
• *CURLIB: The current library contains the group. If no library is specified as the current library, the QGPL library is used.
• library-name: Specify the name of the IBM i library that contains the group.

Group (GROUP)

Enter the name of the group from which the PCT entries are to be listed.

Possible values are:

• *FIRST: No group is specified. The first group found is used.
• 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 name of the PCT entry to be listed. This is the transaction identifier that will be used in EXEC CICS commands to start a CICS program. The program should be defined in the PPT.

Possible values are:

• *ALL: List all PCT entries.
• *FIRST: List the first PCT entry.
• 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.

• generic*-transid: Specify the generic name of the CICS transaction identifier. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all PCT entries with transaction identifiers beginning with the generic name are displayed. If an asterisk is not included with the generic name, the system assumes it to be the complete transaction identifier.

Examples

Error messages