Managing temporary storage resource definitions - IBM - AS/400

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 generic name enables you to create one entry to apply to many temporary storage queues. CICS/400 will use the TST entry associated with the generic name. You must take care, therefore, that there is no ambiguity in your TS queue names.

Using the ADDCICSTST command

Flowchart

Using the ADDCICSTST command  Flowchart

Notes:

  1. The SYSID parameter and the RMTQUEUE parameter are valid only when TYPE(*REMOTE) is specified.
  2. The SYSID parameter is required when TYPE(*REMOTE) is specified.
  3. All parameters preceding this point can be specified positionally.

Function
Use the Add CICS/400 Temporary Storage Table (ADDCICSTST) command to add an entry to the TST.

Required parameters

  1. Library (LIB)
  2. Enter the name of the OS/400 library that contains the CICS/400 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.
  3. Group (GROUP)
  4. Enter the name of the group to which this TST entry is to be added.
    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 $, @, or #.
  5. Queue (TSQUEUE)
  6. Enter either an eight-character name of a 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-name: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 $, @, or #. If a partial name is specified, it will be treated as a generic name and all TST entries beginning with the generic name will be eligible for processing.
  7. Type (TYPE)
  8. Indicates whether the temporary storage queue is recoverable or remote.
    Possible values are:
    *RECOVERABLE: The temporary storage queue is recoverable.
    *REMOTE: The temporary storage queue is remote.

Optional parameters

  1. CICS system (SYSID)
  2. Enter the identifier of the system that owns the temporary storage queue. The system should have a TCS entry. This parameter is required only for remote queues, that is when the Type (TYPE) parameter contains *REMOTE. If this parameter contains the ID of the local system, the entry will be treated as if *NONE has been entered.
    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 $, @, or #.
  3. Remote queue name (RMTQUEUE)
  4. Enter the name by which the temporary storage queue is known on the remote system. This parameter is valid only for remote queues, that is when the Type (TYPE) parameter contains *REMOTE.
    Possible values are:
    *TSQUEUE: The local and remote temporary storage queue names are the same. The name in the TSQUEUE parameter 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 $, @, or #.

Examples
ADDCICSTST LIB(CICSWORK) GROUP(ACCT)
TSQUEUE(AU) TYPE(*RECOVERABLE)

This command adds a TST entry called AU to group ACCT in OS/400 library CICSWORK, as a recoverable queue type. This definition will apply to all temporary storage queues with names beginning with AU.

Using the CHGCICSTST command
Flowchart

Using the CHGCICSTST command  Flowchart

Notes:

  1. The SYSID parameter and the RMTQUEUE parameter are valid only when TYPE(*REMOTE) is specified.
  2. The SYSID parameter is required when TYPE(*REMOTE) is specified.
  3. All parameters preceding this point can be specified positionally.

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

Required parameters

  1. Library (LIB)
  2. Enter the name of the OS/400 library that contains the CICS/400 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.
  3. Group (GROUP)
  4. 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 $, @, or #.
  5. Queue (TSQUEUE)
  6. Enter either an eight-character name of a 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-name: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 $, @, or #. If a partial name is specified, it will be treated as a generic name and all TST entries beginning with the generic name will be eligible for processing.

Optional parameters

  1. Type (TYPE)
  2. 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.
  3. CICS system (SYSID)
  4. Enter the identifier of the system that owns the temporary storage queue. The system should have a TCS entry. This parameter is required only for remote queues, that is when the Type (TYPE) parameter contains *REMOTE. If this parameter contains the ID of the local system, the entry will be treated as if *NONE has been entered.
    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 $, @, or #.
  5. Remote queue name (RMTQUEUE)
  6. Enter the name by which the temporary storage queue is known on the remote system. This parameter is valid only for remote queues, that is when the Type (TYPE) parameter contains *REMOTE.
    Possible 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 parameter 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 $, @, or #.

Examples
ADDCICSTST LIB(CICSWORK) GROUP(ACCT)
TSQUEUE(AU) TYPE(*REMOTE) SYSID(SYS1)

This command changes the TST entry called AU in group ACCT in OS/400 library CICSWORK. The queue has been redefined as a remote queue on system SYS1.

Using the DSPCICSTST command

Flowchart

Using the DSPCICSTST command

Notes:

  1. All parameters preceding this point can be specified positionally.

Function
Use the Display CICS/400 Temporary Storage Table (DSPCICSTST) command to display a TST entry. You can only view this entry; you can neither make changes to it nor delete it.

Optional parameters

  1. Library (LIB)
  2. 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 CICS/400 group.
    *CURLIB: The current library contains the CICS/400 group. If no library is specified as the current library, the QGPL library is used.
    library-name:Specify the name of the OS/400 library that contains the group.
  3. Group (GROUP)
  4. Enter the name of the group containing the TST entry to be displayed.
    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 $, @, or #.
  5. Queue (TSQUEUE)
  6. Enter the name of the TST entry to be displayed. This could be either a complete name or a generic name.
    Possible values are:
    *FIRST: Display the first TST entry.
    *ALL: Display all TST entries.
    queue-name: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 $, @, or #. If a partial name is specified, it will be treated as a generic name and all TST entries beginning with the generic name will be eligible for processing.
  7. Location of output (OUTPUT)
  8. Enter the location of the output from this command.
    Possible values are:
    *: The output is either displayed (if requested by an interactive job) or printed with the job spool output (if requested by a batch job).
    *PRINT: The output is printed with the job spool output.

Examples
DSPCICSTST LIB(CICSWORK) GROUP(ACCT) TSQUEUE(*ALL)

This command displays all TST entries located in group ACCT in OS/400 library CICSWORK.

Using the RMVCICSTST command

Flowchart

Using the RMVCICSTST command

Notes:
1 All parameters preceding this point can be specified positionally.

Function
Use the Remove CICS/400 Temporary Storage Table (RMVCICSTST) command to delete an entry from the TST.

Required parameters

  1. Library (LIB)
  2. Enter the name of the OS/400 library that contains the CICS/400 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.
  3. Group (GROUP)
  4. Enter the name of the group containing the TST entry to be removed.
    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 $, @, or #.
  5. Queue (TSQUEUE)
  6. Enter the name of the TST entry to be removed. This could be either a complete or a generic name.
    Possible values are:
    *FIRST: Remove the first TST entry.
    *ALL: Remove all TST entries.
    queue-name: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 $, @, or #. If a partial name is specified, it will be treated as a generic name and all TST entries beginning with the generic name will be eligible for processing.

Examples
RMVCICSTST LIB(CICSWORK) GROUP(ACCT)
TSQUEUE(ABC*)

This command removes all TST entries, that start with ABC and end with anything, located in group ACCT in OS/400 library CICSWORK.

Using the WRKCICSTST command

Flowchart

Using the WRKCICSTST command

Notes:
1 All parameters preceding this point can be specified positionally.

Function
Use the Work with CICS/400 Temporary Storage Table (WRKCICSTST) command to list entries in the TST. You can change, remove, copy and display entries, or add new entries to the list.

Optional parameters

  1. Library (LIB)
  2. 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 CICS/400 group.
    *CURLIB: The current library contains the CICS/400 group. If no library is specified as the current library, the QGPL library is used.
    library-name:Specify the name of the OS/400 library that contains the group.
  3. Group (GROUP)
  4. Enter the name of the group containing the TST entries 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 $, @, or #.
  5. Queue (TSQUEUE)
  6. Enter the name of the TST entry to be listed. This is the name that is used in temporary storage EXEC CICS commands.
    Possible values are:
    *ALL: List all TST entries.
    *FIRST: List the first TST entry.
    queue-name: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 $, @, or #. If a partial name is specified, it will be treated as a generic name and all TST entries beginning with the generic name will be eligible for processing.

Examples
WRKCICSTST LIB(CICSWORK) GROUP(ACCT)

This command lists all TST entries located in group ACCT in OS/400 library CICSWORK.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM - AS/400 Topics