Change CICS TST Entry (CHGCICSTST)

Use the Change CICS Temporary Storage Table (CHGCICSTST) command to change an entry in the TST.

A temporary storage queue is a file used by an application program to store data for later retrieval.

A Temporary Storage Table (TST) entry may define a recoverable or a remote temporary storage queue. TST entries are not required for local, unrecoverable temporary storage queues.

A temporary storage queue is a file used by an application program to store data for later retrieval. A Temporary Storage Table (TST) entry needs to be created for all recoverable and all remote temporary storage queues. You do not need to create TST entries for local, unrecoverable temporary storage queues.

You can create a TST entry with a generic name that can be used as a prefix to the full name that will be supplied by the application programs in EXEC CICS temporary storage commands. A prefix enables you to create one entry to apply to many temporary storage queues. CICS will use the TST entry associated with the prefix. You must take care, therefore, that there is no ambiguity in your TS queue names.

Parameters

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.

Group (GROUP)

Enter the name of the group that contains the TST 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 #.

Queue (TSQUEUE)

Enter either the complete name of the queue or a partial, generic name. This is the name that will be used in EXEC CICS temporary storage commands. This name is also used to identify this TST entry.

• queue-prefix: The queue name 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 #.

For a generic name a partial queue name is used, for example ABC.

Type (TYPE)

Indicates whether the temporary storage queue is recoverable or remote.

Possible values are:

• *SAME: Keep the value currently specified in the TST entry.
• *RECOVERABLE: The temporary storage queue is recoverable.
• *REMOTE: The temporary storage queue is remote.

Remote CICS system (SYSID)

Enter the identifier of the system owning the temporary storage queue. The system should have a TCS entry. This field is valid only for remote queues, that is when the type field contains *REMOTE.

Possible values are:

• *SAME: Keep the value currently specified in the TST entry.
• 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 queue name (RMTQUEUE)

Enter the name by which the temporary storage queue is known on the remote system. This field is valid only for remote queues, that is when the type field contains *REMOTE.

The possible RMTQUEUE values are:

• *SAME: Keep the value currently specified in the TST entry.
• *TSQUEUE: The local and remote temporary storage queue names are the same. The name in the TSQUEUE field will be used.
• remote-queue: The temporary storage queue name 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 #.

Examples

Error messages