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