IMS Version 9

/CQQUERY

Format

Read syntax diagramSkip visual syntax diagram>>-+-/CQQUERY-+----STATISTICS----STRUCTURE---------------------->
   '-/CQQ-----'

     .---------------.
     V               |
>--+---structurename-+-+---------------------------------------><
   '-ALL---------------'

Environments and Keywords

Table 29 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 29. Valid Environments for the /CQQUERY Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/CQQUERY X X
STATISTICS X X
STRUCTURE X X

Usage

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. The following statistics information is displayed:

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

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.

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.

Examples

Example 1 for /CQQUERY Command

Entry ET:

/CQQUERY STATISTICS STRUCTURE ALL

Response ET:

 STRUCTURE NAME    LEALLOC  LEINUSE ELMALLOC ELMINUSE    LE/EL
 IMSMSGQ01             272        4      541        4  0001/0002
 IMSMSGQ01OFLW         N/A      N/A      N/A      N/A     N/A
 IMSEMHQ01             272        3      541        3  0001/0002
 IMSEMHQ01OFLW         N/A      N/A      N/A      N/A     N/A
 *97211/120123*

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:

/CQS STATISTICS STRUCTURE IMSMSGQ01

Response ET:

STRUCTURE NAME    LEALLOC  LEINUSE ELMALLOC ELMINUSE   LE/EL
IMSMSG101           9132     9027    9130       9071 0001/0001
IMSMSGQ01OFLW       1915     1866    1912       1866 0001/0001
*00039/180909*

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

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004