/CQQUERY command

The /CQQUERY command displays information regarding a specific coupling facility list structure or all the coupling facility list structures holding IMS messages.

The /CQQUERY STATISTICS command displays the statistics and status information for the coupling facility list structures specified by the STRUCTURE keyword.

Subsections:

Environment
Syntax
Keywords
Usage notes
Examples

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the command and keywords.

Table 1. Valid environments for the /CQQUERY command and keywords
Command / Keywords	DB/DC	DCCTL
/CQQUERY	X	X
STATISTICS	X	X
STRUCTURE	X	X

Syntax

Keywords

The following keywords are valid for the /CQQUERY command:

STATISTICS: Specifies that statistics should be gathered and displayed.
STRUCTURE: Specifies that one or more structure names follow.
Only primary, coupling facility list-structure names used by IMS for shared queues are valid.

Usage notes

This command is valid only in a shared-queues environment.

The following statistics information is displayed:

Number of data elements that can be allocated in the structure
Number of list entries that can be allocated in the structure
Number of data elements in use in the structure
Number of list entries in use in the structure
Entry-to-element ratio

The entry-to-element ratio is the ratio of list entries to list elements in the structure when the structure was first allocated, or last altered (for structures defined with ALLOWAUTOALT(YES)). The ratio value is initially derived by CQS from the OBJAVGSZ parameter in the CQSSGxxx PROCLIB member. The ratio can be changed by z/OS® dynamically as needed for ALLOWAUTOALT(YES) structures. The ratio might also change slightly when a structure is rebuilt, because CQS uses the saved values of the actual number of allocated entries and elements to derive the entry-to-element ratio for the connection to a rebuild structure.

In an IMSplex, /CQQUERY displays information regarding a specific shared queue coupling facility list structure or all the shared queue coupling facility list structures holding IMS messages. /CQQUERY does not display any information about resource structures.

When the /CQQ command is issued through OM, command processing is not serialized through the IMS CTL TCB.

This command can be issued to an IMSplex by using the Batch SPOC utility.

Examples

The following are examples of the /CQQUERY command:

Example 1 for /CQQUERY command

Entry ET:

/CQQUERY STATISTICS STRUCTURE ALL

Response ET:

STRUCTURE NAME    LEALLOC  LEINUSE ELMALLOC ELMINUSE    LE/EL
IMSMSGQ01            1789       11     1787       19 00001/00001
IMSMSGQ01OFLW         N/A      N/A      N/A      N/A     N/A
IMSEMHQ01             377        3      375        3 00001/00001
IMSEMHQ01OFLW         N/A      N/A      N/A      N/A     N/A
*08282/211714*

Explanation: This command displays the structure statistics of the message queue and Fast Path EMH queue structures used by IMS. The list entries allocated (LEALLOC), the list entries in use (LEINUSE), the elements allocated (ELMALLOC) and the elements in use (ELMINUSE) show the usage of the structures. When CQS allocates a structure, it allocates a certain number of list entries and elements to manage data on the structure. A structure is full if all list entries are in use or if all elements are in use.

Example 2 for /CQQUERY command

Entry ET:

/CQQ STATISTICS STRUCTURE IMSMSGQ01

Response ET:

STRUCTURE NAME    LEALLOC  LEINUSE ELMALLOC ELMINUSE    LE/EL
IMSMSG101           9132     9027    9130       9071 00001/00001
IMSMSGQ01OFLW       1915     1866    1912       1866 00001/00001
*08282/211714*

Explanation: This command displays the structure statistics of the message queue structure used by IMS and its associated overflow queue.