Shared queues - TSQSHR

The Shared temporary storage queues (TSQSHR) views display information about shared temporary storage queues.

Supplied views

To access from the main menu, click:

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

Table 1. Views in the supplied Shared temporary storage queues (TSQSHR) view set
View Notes
Shared temporary storage queues

EYUSTARTTSQSHR.DELETE

Deletes the shared temporary storage queue.
Shared temporary storage queues

EYUSTARTTSQSHR.DETAILED

Detailed information about a selected temporary storage queue.
Shared temporary storage queues

EYUSTARTTSQSHR.TABULAR

Tabular information about shared temporary storage queues in CICS systems.

Actions

Table 2. Actions available for TSQSHR views
Action Description
DELETE Deletes the shared temporary storage queue.
SET Set attributes according new values specified in input fields.

Fields

Table 3. Fields in TSQSHR 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.
Interval since queue last used (seconds) LASTUSEDINT The interval, in seconds, since the shared temporary storage queue was last referenced.
Queue location LOCATION Indicates where the shared temporary storage queue resides.
Largest item length (bytes) MAXITEMLEN The length, in bytes, of the largest item in the shared temporary storage queue.

Note: If an AUXILIARY TSQSHR 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.

Smallest item length (bytes) MINITEMLEN The length, in bytes, of the smallest item in the shared temporary storage queue.

If an AUXILIARY TSQSHR 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.

Queue name NAME The name of the shared temporary storage queue.
Number of items in queue NUMITEMS The number of items in the shared temporary storage queue.
Temporary storage pool name POOLNAME The name of a temporary storage pool. CICS ships the command to the temporary storage server that manages the pool.
Total queue length (bytes) QUELENGTH The total length, in bytes, of all the items in the shared temporary storage queue.

If an AUXILIARY TSQSHR 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 shared temporary storage queue is recoverable.
Transaction that created TS queue TRANSID The ID of the transaction that created the shared temporary storage queue.


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