/DISPLAY MSNAME command

Use the /DISPLAY MSNAME command to display the queue counts for the specified logical link path. Generic parameters are supported for the MSNAME keyword.

Subsections:

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 MSNAME command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/DISPLAY X X X
MSNAME X   X
QCNT X   X

Syntax

Read syntax diagramSkip visual syntax diagram/DISPLAY/DISMSNAME msnamemsname*msnameQCNTALL

Keywords

The following keyword can be specified for the /DISPLAY MSNAME command:

QCNT
Specifies that global queue count information is to be displayed. If QCNT is not specified, local queue counts are displayed; when it is specified, no local queue counts are displayed.

This count represents the message counts of messages that can be processed by the IMS system where the command is issued. This count includes messages that can be processed by any IMS system (messages with no affinity), plus messages that can be processed by the IMS system where the command is issued (messages with an affinity to the IMS system that issued the command).

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

Usage notes

In a shared-queues environment, use the QCNT keyword to obtain the current message queue counts on the shared queues structure. The local queue counts (ENQCT, DEQCT, and QCT) value that is returned on this command when the QCNT keyword is not specified represents the messages being processed by the IMS system where this command is issued. Do not use local queue counts for queue evaluation purposes.

Examples

Entry ET:
/DISPLAY MSNAME ALL
Response ET:
  MSNAME    ENQCT   DEQCT    QCT
  SYSTEM2A      0      0       0
  SYSTEM2B      0      0       0
  FRESNO        0      0       0
  BOSTON        0      0       0
  ALBANY        0      0       0
  TEST1         0      0       0
  *91350/053859*
Entry ET:
  /DISPLAY MSNAME ALL
Response ET:
MSNAME    ENQCT   DEQCT    QCT   IMS1
LINK23B4      0       0      0  DYNAMIC   IMS1
LINK12V1      0       0      0    IMS1
LINK23U2      0       0      0  DYNAMIC   IMS1
ELINK211      0       0      0  DYNAMIC   IMS1
LINK13B3      0       0      0    IMS1
LINK13V       0       0      0    IMS1
LINK12V       0       0      0    IMS1
LINK13C2      0       0      0    IMS1
LINK13X       0       0      0    IMS1
LINK12V2      0       0      0    IMS1
LINK13M2      0       0      0    IMS1
LINK13V2      0       0      0    IMS1
ELINK124      0       0      0    IMS1
LINK23V1      0       0      0  DYNAMIC   IMS1
LINK12B1      0       0      0    IMS1
LINK12B2      0       0      0    IMS1
LINK12Y       0       0      0    IMS1
ELINK120      0       0      0    IMS1
LINK13B4      0       0      0    IMS1
LINK21V3      0       0      0  DYNAMIC   IMS1
ELINK1MS      0       0      0    IMS1
LINK12M1      0       0      0    IMS1
LINK23V       0       0      0  DYNAMIC   IMS1
LINK13U2      0       0      0    IMS1
LINK23B3      0       0      0  DYNAMIC   IMS1
ELINK224      0       0      0  DYNAMIC   IMS1
LINK23X       0       0      0  DYNAMIC   IMS1
LINK23V2      0       0      0  DYNAMIC   IMS1
ELINK121      0       0      0    IMS1
LINK23C2      0       0      0  DYNAMIC   IMS1
LINK12U1      0       0      0    IMS1
LINK23M2      0       0      0  DYNAMIC   IMS1
ELINK122      0       0      0    IMS1
ELINK222      0       0      0  DYNAMIC   IMS1
LINK12C1      0       0      0    IMS1
LINK13V1      0       0      0    IMS1
ELINK123      0       0      0    IMS1
PTH3TSTB      0       0      0    IMS1
*97258/175636*