Temporary storage queues - TSQNAME
The Temporary storage queues (TSQNAME) views display information about all non-shared temporary storage queues.
Supplied views
To access from the main menu, click:
| View | Notes |
|---|---|
| Temporary storage queues EYUSTARTTSQNAME.DELETE |
Delete a temporary storage queue. |
| Temporary storage queues EYUSTARTTSQNAME.DETAILED |
Detailed information about a selected non-shared temporary storage queue. |
| Temporary storage queues EYUSTARTTSQNAME.TABULAR |
Tabular information about non-shared temporary storage queues in CICS systems. |
Actions
| Action | Description |
|---|---|
| DELETE | Delete a temporary storage queue. |
| SET | Set attributes according to new values specified in input fields. |
Fields
| Field | Attribute name | Description |
|---|---|---|
| TS Queue expiry interval (hours) | EXPIRYINT | The last used interval limit time, in hours, which is used to determine whether a temporary storage queue has expired
and is eligible to be automatically deleted. The value is derived from the EXPIRYINT value in the TSMODEL, or for
CICS TS 5.2 and higher either the EXPIRYINT value or the EXPIRYINTMIN value rounded up to the next hour. The
EXPIRYINTMIN value overrides EXPIRYINT. The value in the TSMODEL at the time a temporary storage queue is created will be
used for the lifetime of a queue even if the TSMODEL is subsequently changed. The value of EXPIRYINT can be
in the range of 0-to-15000.
|
| TS Queue expiry interval (minutes) | EXPIRYINTMIN | The last used interval limit time, in minutes, which is used to determine whether a temporary storage queue has expired
and is eligible to be automatically deleted. CICS rounds up the value to a multiple of ten minutes. The value
in the TSMODEL at the time a temporary storage queue is created will be used for the lifetime of a
queue even if the TSMODEL is subsequently changed. The value of EXPIRYINTMIN can be in the range of 0-to-900000.
|
| Queue name in hexadecimal | HEXNAME | The name of the temporary storage queue in hexadecimal. |
| Interval since queue last used (seconds) | LASTUSEDINT | The interval in seconds since the temporary storage queue was last referenced. The value returned for large shared temporary storage queues is governed by the value of the LASTUSEDINTERVAL parameter specified for the associated TS queue manager. |
| Queue location | LOCATION | Indicates where the temporary storage queue resides. Values are:
|
| Largest item length (bytes) | MAXITEMLEN | The length in bytes of the largest item in the temporary storage queue. The length of a queue item is the sum of the length of the user data plus 8 bytes for header information, rounded up. For main storage queues, the length is rounded up to the boundary of the MVS storage subpool used to store it. For auxiliary temporary storage, the length is rounded to the next highest multiple of either 64 or 128 (depending on the control interval size of the temporary storage data set). (For background information about CI sizes, see The control interval size.) For shared queues, the lengths returned in MINITEMLEN, MAXITEMLEN, and QUELENGTH, reflect the data length stored in the coupling facility. This includes any item control information, which consists of a 2-byte length prefix for each item. For all types of queue the maximum value returned will be capped at 32767 (Hex '7FFF'). |
| Smallest item length (bytes) | MINITEMLEN | The length in bytes of the smallest item in the temporary storage queue. For information about how CICS calculates the length of items, and for information about shared TS queues, see the MAXITEMLEN option. |
| Queue name | NAME | The name of the temporary storage queue. |
| Number of items in queue | NUMITEMS | The number of items in the temporary storage queue. |
| Total queue length (bytes) | QUELENGTH | The total length, in bytes, of all the items in the temporary storage queue. Note: If an AUXILIARY TSQNAME contains an item that is larger than the control interval size of the temporary storage data set, this field will be displayed as N/A. |
| Recovery status | RECOVSTATUS | Indicates whether or not the temporary storage queue is recoverable. Options are RECOVERABLE or NOTRECOVERABLE. |
| Transaction that created TS queue | TRANSID | The ID of the transaction that created the temporary storage queue. |