CEMT INQUIRE TSQUEUE / TSQNAME
Retrieve information about temporary storage queues by using the CEMT INQUIRE TSQUEUE or CEMT INQUIRE TSQNAME commands. In CEMT, you can use either command to operate on temporary storage queues (TS queues) with names up to 16 characters long.
In the CICS Explorer, the TS queues operations view provides a functional equivalent to this command.
Description
- **
- BMS paging
- $$
- BMS route
- X'FA' to X'FF'
- CICS
- CEBR
- Default CEBR queue name
- DF
- CICS
- DFHM
- Message cache for message-protected tasks
- DFXXxx
- CICS REQIDS (where xx is a hexadecimal value)
Input
- Type CEMT INQUIRE TSQUEUE (or suitable abbreviations for the keywords). The resulting display lists the status.
- Type CEMT INQUIRE TSQUEUE (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i tsq main, the resulting display shows the details of only those temporary storage queues that are resident in main storage.
- ALL
- The default.
- (value)
- The name of the temporary storage queue for which information is requested.
- SYSID(value)
- The
system name that corresponds to the temporary storage pool name if
the request is to be sent to a TS server.
This value is input-only, and must be specific; you cannot specify generic names for SYSID. The specified system name must be defined in a temporary storage table (TST) in a TST TYPE=SHARED entry. If the SYSID is not found in a TST TYPE=SHARED entry, CICS returns a SYSID NOT FOUND error.
- POOLNAME(value)
- Specifies
the 8-character pool name of a temporary storage pool if the request
is sent to a TS server. Use this option to view shared temporary storage
queues that are defined by RDO resource definitions.
If the pool name is not found, CICS returns a POOLERR.
Browsing
If you place the cursor against a specific entry in the list of temporary storage queues and press Enter, CICS displays an expanded format.
Not all TS queues visible on the CEMT INQUIRE TSQUEUE results panel can necessarily be browsed using CEBR. Queues resident in a shared TS pool, when the POOLNAME is specified on the INQUIRE TSQUEUE request, can sometimes not be browsed. Such queues can be browsed if there is a TSMODEL resource definition or temporary storage table (TST) entry mapping the queue name to the TS pool.
You can also browse queues in a shared pool by specifying a SYSID that maps to the shared pool using an entry in the temporary storage table (TST). However, the SYSID is not available to CEMT, so entering B next to the queue gives a NOT FOUND response from CEBR. If an appropriate SYSID is then provided by the user, the reference to the shared pool can be resolved.
If there is no suitable entry in the temporary storage table (TST) and no TSMODEL mapping the queue name to the shared pool, the queue cannot be browsed. CEBR indicates that the requested queue does not exist.
Displayed fields
- EXPIRYINTMIN(value)
- Displays
the expiry interval, in minutes, that is defined for the temporary
storage queue in its TSMODEL resource definition. CICS uses the value rounded up to the nearest
multiple of 10 minutes. If the temporary storage queue is not referenced
during the expiry interval, it becomes eligible to be deleted automatically
by CICS. The automatic deletion
of shared TS queues is enabled.A value of zero means that no expiry interval applies to the temporary storage queue, so it is never eligible for automatic deletion. In addition, the following types of temporary storage queues are never deleted automatically by CICS, even if a nonzero expiry interval is set in the matching TSMODEL resource definition:
- Queues in auxiliary temporary storage that are defined as recoverable.
- Queues in a remote CICS region.
- Queues that CICS creates for its own use.
Starting with CICS TS 5.2, the expiry interval now also applies to shared temporary storage queues.
- LASTUSEDINT(value)
- Displays the elapsed time interval in binary seconds since the queue was last referenced.
- LENGTH(value)
- Displays the total length in bytes of all the items in the temporary storage queue.
- LOCATION
- Displays
where the temporary storage queue resides. The values are as follows:
- AUXILIARY
- The temporary storage queue is held in auxiliary temporary storage (the VSAM data set DFHTEMP), or in temporary storage pools in the coupling facility.
- MAIN
- The temporary storage queue is held in main storage.
- MAXITEMLEN(value)
- Displays the length in bytes of the largest item in the temporary storage queue.
- MINITEMLEN(value)
- Displays the length in bytes of the smallest item in the temporary storage queue.
- NUMITEMS(value)
- Displays the number of items in the temporary storage queue.
- RECOVSTATUS
- Displays
the recovery status of the temporary storage queue. The values are
as follows:
- RECOVERABLE
- The temporary storage queue is recoverable.
- NOTRECOVABLE
- The temporary storage queue is not recoverable.
- TRANSID(value)
- Displays the 4-character ID of the transaction that created the TS queue.
- TSQUEUE(value)
- Indicates
that this panel relates to a TSQUEUE inquiry and displays the 16-character
name of a temporary storage queue. Note: Characters that cannot be displayed appear as periods. You can use PF2 on the expanded panel to see the value in hexadecimal.