/DISPLAY Q command

Use the /DISPLAY Q command to display the message queues according to classes and priority levels.

Subsections:

Environment
Syntax
Keywords
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 /DISPLAY Q command and keywords
Command / Keywords	DB/DC	DBCTL	DCCTL
/DISPLAY	X	X	X
BALGRP	X		X
CLASS	X		X
Q	X		X
PRIORITY	X	X	X
TRANSACTION	X		X

Syntax

Keywords

The following keywords can be specified for the /DISPLAY Q command:

BALGRP: Displays queue counts of the Fast Path load balancing group queues.
CLASS: Displays queues for specified classes.
PRIORITY: Displays queues for specified priorities.
QCNT: Specifies that global queue count information is to be displayed for Fast Path load balancing groups. If QCNT is not specified, only local queue counts are displayed; when it is specified, no local queue counts are displayed.
This keyword is valid only in a shared-queues environment.
TRANSACTION: Displays queues for transactions that are ready to run. DFSCPIC is displayed as psbname for CPI Communications driven transactions that have not issued a DL/I call to allocate a PSB.

Combinations of the CLASS, PRIORITY, and TRANSACTION keywords enable classes, priority levels within classes, transactions within priority levels, and message counts to be displayed on an as-needed basis.

Examples

The following are examples of the /DISPLAY Q command.

Example 1 for /DISPLAY Q command

Entry ET:

  /DISPLAY Q

Response ET:

  CLS CT  PTY CT  MSG CT  TRAN CT
    3        5        28      8
  *90253/103811*

Entry ET:

  /DISPLAY Q BALGRP

Response ET:

   BALGRP   NO.RGNS   MSG CT  ENQ COUNT  DEQ COUNT
  DDLTM06         1        1          2          1
  DDLTM07         1        0          0          0
  *91068/112000*

Explanation: In a shared-queues environment, the DEQ COUNT column shows the number of messages processed by the local IMS. This can be a message that is entered by the local IMS system or a sharing IMS system in the IMSplex.

Entry ET:

  /DISPLAY Q BALGRP QCNT

Response ET:

  BALGRP             GBLQCT
  SMQFP1                  2
  SMQFP2                  3
  *96197/174618*

Entry ET:

  /DISPLAY Q CLASS ALL

Response ET:

  CLS     PTY CT   MSG CT  TRAN CT
    1        1        2        1
    2        1        2        1
    3        1        4        1
  *90253/103855*

Entry ET:

  /DISPLAY Q CLASS 1 2

Response ET:

  CLS     PTY CT  MSG CT  TRAN CT
    1        1        2       1
    2        1        2       1
  *90253/103913*

Entry ET:

  /DISPLAY Q PRIORITY ALL

Response ET:

  CLS     PTY     MSG CT  TRAN CT
    1        9        2       1
    2        1        2       1
    3        5        4       1
  *90253/103945*

Entry ET:

  /DISPLAY Q PRIORITY 10

Response ET:

  CLS     PTY     MSG CT  TRAN CT
    4       10       18       3
  *90253/1104016

Entry ET:

  /DISPLAY Q CLASS 4 PRIORITY 10

Response ET:

  CLS     PTY     MSG CT  TRAN CT
    4       10       18       3
  *90309/122418*

Entry ET:

  /DISPLAY Q TRANSACTION

Response ET:

  CLS     PTY     MSG CT TRAN     PSBNAME
    3       10        3  CLOSE    DFSSAM05
    4       10        2  ADDPART  DFSSAM04
    4       10        4  PART     DFSSAM02
    5        7        1  ADDINV   DFSSAM04
    5       10        5  DLETINV  DFSSAM04
  *90243/110324*

Entry ET:

  /DISPLAY Q CLASS 3 5 TRANSACTION

Response ET:

  CLS     PTY     MSG CT TRAN     PSBNAME
    3       10        3  CLOSE    DFSSAM05
    5        7        1  ADDINV   DFSSAM04
    5       10        5  DLETINV  DFSSAM04
  *90243/110332*

Entry ET:

  /DISPLAY Q CLASS 4 PRIORITY 10 11 TRANSACTION

Response ET:

  CLS     PTY     MSG CT TRAN     PSBNAME
    4       10        2  ADDPART  DFSSAM04
    4       10        4  PART     DFSSAM02
  *90243/110343*

Entry ET:

  /DISPLAY Q CLASS 1 2 3 PRIORITY 1

Response ET:

  CLS     PTY     MSG CT  TRAN CT
    1        1        2       1
    2        1        2       1
    3        1        4       1
  *90253/104321*

Example 2 for /DISPLAY Q command

Entry ET:

  /DISPLAY QUEUE TRANSACTION

Response ET:

  CLS    PTY    MSG  CT    TRAN     PSBNAME
   20      5         2     TPN1     DFSCPIC
   20      2         5     TPN2     SAAPSB1
   22      3         7     TPN3     SAAPSB2
  *90332/114253*