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:

CICS operations views > Temporary storage queue (TSQ) operations views > Temporary storage queues

Table 1. Views in the supplied Temporary storage queues (TSQNAME) view set
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

Table 2. Actions available for TSQNAME views
Action Description
DELETE Delete a temporary storage queue.
SET Set attributes according to new values specified in input fields.

Fields

Table 3. Fields in TSQNAME views
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.
  • 0 - Indicates that no expiry interval applies to this TSMODEL and therefore a temporary storage queue based on this will never expire. This is the default value.
  • value - Specifies the last used interval in hours after which the queue becomes eligible for automatic deletion.
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.
  • 0 - Indicates that no expiry interval applies to this TS queue. This is the default value.
  • value - Specifies the last used interval in minutes after which the queue becomes eligible for automatic deletion.
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:
  • AUXILIARY The temporary storage queue is held in the CICS temporary storage VSAM data set (or in the coupling facility).
  • MAIN The temporary storage queue is held in main storage.
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.


eyua3xq.html | Timestamp icon Last updated: Sunday, 4 June 2017