/DISPLAY LUNAME command

Use the /DISPLAY LUNAME command to display information about a specific LU 6.2 application program.

After restart and any checkpoint, only LU 6.2 resources with status or messages queued are displayed.

If you use a side information entry name to place messages on queues, specify the side information entry name for the LU name and the character string DFFSIDE for the TP name to display those messages.

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

Syntax

Read syntax diagramSkip visual syntax diagram/DISPLAY/DISLUNAME lunameALLINPUTOUTPUTlunameQCNTlunameTPNAMEtpnameALLQCNT

Keywords

The following keywords are valid for the /DISPLAY LUNAME command:

LUNAME
The LU name of the LU 6.2 application program about which you want to display information.
INPUT

Displays the count of LU 6.2 inbound conversations and synchronous outbound activities for the specified LU names and their status.

/DISPLAY LUNAME INPUT can indicate that a command such as the /STO LU ALL INPUT command or the /TRACE SET ON LU ALL INPUT command was entered before the display that applies to all future LU 6.2 inbound conversations.

OUTPUT

Displays the count of asynchronous output messages that are being enqueued and dequeued for the LU name and the count of LU 6.2 asynchronous outbound conversations for that LU name.

The /DISPLAY LUNAME OUTPUT command can indicate that a command such as the /STO LU ALL OUTPUT command or the /TRACE SET ON LU ALL OUTPUT command was entered that applies to all future LU 6.2 outbound conversations.

QCNT

Displays the number of output messages on the global queue for the specified LU name. QCNT specifies that global queue count information is to be displayed. Local queue counts are not 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).

The /DISPLAY LUNAME QCNT form of the command is only valid in a shared-queues environment.

TPNAME

Displays the number of asynchronous output messages being enqueued and dequeued and their status.

If the LU name includes a network identifier, you must specify the network-qualified LU name when using the TPNAME keyword. A network-qualified LU name refers to a different resource than a non-qualified LU name.

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.

Output fields

The following output fields are displayed for the /DISPLAY LUNAME command:
LUNAME
LU name of the LU 6.2 application program
#APPC-CONV
The number of LU 6.2 inbound conversations
ENQCT
Total number of messages enqueued on this LU name. In a shared-queues environment, only shows messages enqueued for the local subsystem.
DEQCT
Total number of messages dequeued from this LU name. In a shared-queues environment, only shows messages dequeued for the local subsystem.
QCT
Total number of messages still in the queue. In a shared-queues environment, only shows messages enqueued for the local subsystem.
CONVCT
Number of LU 6.2 asynchronous outbound conversations.

Status can be stopped (STO), traced (TRA), or stopped and traced.

The CONVCT output field only applies if the OUTPUT keyword was specified.

GBLQCNT
The total number of APPC output messages on the global queue. The global queue count includes messages that were placed on the global queue prior to the latest cold start of the owning IMS. Synchronous and asynchronous APPC output messages are included in the global queue count.
AFFINITY
The IMSID (or the first seven bytes of the RSENAME if XRF capable) of the IMS to which the output messages have affinity.
Status
The status displayed can be none, stopped (STO), traced (TRA), or both stopped and traced. The status information does not have a header.

Examples

Entry ET: 
  /DISPLAY LU luname1 luname2 INPUT
Response ET: 
  LUNAME   #APPC-CONV
  LUNAME1          15 TRA
  LUNAME2           5
  *90332/114253*
Entry ET: 
  /DISPLAY LU luname1 luname3 BADLUNME OUTPUT
Response ET: 
  LUNAME        ENQCT      DEQCT      QCT      CONVCT
  LUNAME1           5          3        2           2
  LUNAME3           5          4        1           1
  BADLUNME IS INVALID
  *90332/114253*
Entry ET: 
  /DISPLAY LU LUNAME1 TPNAME TPNAME1 BADTPNME
Response ET: 
  LUNAME/TPNAME        ENQCT      DEQCT      QCT
  LUNAME1
  -TPNAME1                 0          0        0 STO
  BADTPNME IS INVALID
  *90332/114253*
Entry ET: 
  /DISPLAY LU LUNAME1 TPNAME ALL OUTPUT
Response ET: 
  LUNAME/TPNAME        ENQCT      DEQCT      QCT
  LUNAME1
  -TPNAME1                 0          0        0 STO
  -TPNAME7890123456+       5          3        2 TRA,STO
   789END
  -DFSSIDE                 2          2        0
  *90332/114253*
Entry ET: 
  /DISPLAY LU LUNAME2 TPNAME ALL
Response ET: 
  LUNAME/TPNAME        ENQCT      DEQCT      QCT
  NO TPNAME(S) ASSOCIATED WITH LUNAME
  *90332/114253*
Entry ET: 
  /DISPLAY LU 'network1.luname1' luname3 'nid2.luname4' OUTPUT
Response ET: 
LUNAME                       ENQCT       DEQCT      QCT      CONVCT
NETWORK1.LUNAME1                 5           3        2           2
LUNAME3                          5           4        1           1
NID2.LUNAME4                     0           0        0           0
*92232/114253*
Entry ET: 
  /DISPLAY LU 'network1.luname1' TPNAME tpname1 badtpnme
Response ET: 
LUNAME/TPNAME                ENQCT       DEQCT      QCT
NETWORK1.LUNAME1
-TPNAME1                         0           0        0 STO
-BADTPNME           IS INVALID
*92232/114253*
Entry ET: 
/DISPLAY LU ALL INPUT
Response ET 
LUNAME           #APPC-CONV
NET1.LU1                  0 STO,TRA
NET2.LU1                  0
LU3                       0 STO,TRA
NET4.LU3                  0 STO
NET5.LU5                  0 TRA
FUTURE INPUT:  STO,TRA
*93069/114435*
Entry ET: 
/DISPLAY LU ALL OUTPUT
Response ET: 
LUNAME                ENQCT      DEQCT        QCT     CONVCT
NET1.LU1                  0         0         0             0  STO
NET2.LU1                  0         0         0             0  TRA
LU3                       0         0         0             0  STO,TRA
NET4.LU3                  0         0         0             0  TRA
NET5.LU5                  0         0         0             0  STO
FUTURE OUTPUT:  STO,TRA
*93069/114435*
Entry ET: 
  /DISPLAY LU L62MVS1 LU1 CTA73 QCNT
Response ET: 
  LUNAME               GBLQCT       AFFINITY
  DEBVMU00.CTA73            8       SYS3
  L62MVS1                  22       SYS3
  CTA73                     6       SYS3
  NTWKA.CTA73              16       SYS3
  L62MVS1                  26       IMS2
  NTWKA.CTA73               4       IMS2
  LU1                       0
*03202/143132*
Entry ET: 
  /DIS LU CTA73 TPNAME ALL QCNT
Response ET: 
LUNAME/TPNAME      GBLQCT     AFFINITY
DEBVMU00.CTA73
-DFAASYNC               8     SYS3
CTA73
-TPNM012345678901+      6     SYS3
234567890123456789012345678901234567890123456789
NTWKA.CTA73
-TP100                  4     IMS2
-TP100                 16     SYS3
*03202/143204*
Entry ET: 
  /DIS LU LU100 TPNAME TP100 TP300 TP200 QCNT
Response ET: 
LUNAME/TPNAME     GBLQCT     AFFINITY
NTWK2.LU100
-TP100                 8     IMS2
NTWK1.LU100 
-TP100                 8     IMS2
-TP200                10     IMS2
LU100
-TP300                 0
*03202/143201*
Entry ET: 
/DIS LU SIDENAME TPNAME DFSSIDE QCNT
Response ET: 
LUNAME/TPNAME     GBLQCT     AFFINITY
SIDENAME
-DFSSIDE               9     IMS2
*03202/143231*