gtpo1mawOperations

ZNDLU-Display LU Information

Use this command to display information about one or more logical units (LUs).

Requirements and Restrictions

Format




ID-netid.luname
displays information about one or more LU, where netid is the 1- to 8-character network identifier and luname is the 1- to 8-character name of the LU.  The network ID and name of a resource must both begin with a letter (A-Z), @, #, or $. The remaining characters can be letters (A-Z), numbers (0-9), @, #, or $. 

Notes:

  1. Use the asterisk (*) as a global file-name character to specify a group of network identifiers or LU names that begin or end with a common string of characters. For example, to display information about all the LUs that have a name beginning with PP, enter:
    ZNDLU ID-PP*

    To display information about all the LUs in the ALPHA network, enter:


    ZNDLU ID-ALPHA.*

  2.  To specify an SNA network ID or resource name that contains dollar signs ($), you must type two consecutive dollar signs ($$) for each dollar sign in the network ID or resource name. For example, if the SNA resource name is $SNANAME, you must type $$SNANAME

Mode-modename
displays information about the sessions started for TPF Advanced Program-to-Program Communications (TPF/APPC) LUs that have the specified mode, where modename is the 1- to 8-character name of the mode.  Mode names must begin with a letter (A-Z), @, #, or $. The remaining characters can be letters (A-Z), numbers (0-9), @, #, or $. 
Note:
 To specify a mode name that contains dollar signs ($), you must type two consecutive dollar signs ($$) for each dollar sign in the name. For example, if the mode name is $MODNAME, you must type $$MODNAME

ALs-alsname
displays information about the logical units (LUs) that started a session through a specific adjacent link station (ALS), network control program (NCP), or channel-to-channel (CTC) resource, where alsname is the 1- to 8-character name of the ALS, NCP, or CTC resource.  The network ID and name of a resource must both begin with a letter (A-Z), @, #, or $. The remaining characters can be letters (A-Z), numbers (0-9), @, #, or $. 
Note:
 To specify an SNA network ID or resource name that contains dollar signs ($), you must type two consecutive dollar signs ($$) for each dollar sign in the network ID or resource name. For example, if the SNA resource name is $SNANAME, you must type $$SNANAME

APplication
displays information about the LUs that are in session with a specific TPF application or about the LUs that are not currently in session with a TPF application, where:

applname
is the 1- to 8-character alphanumeric name of an application.

NS
displays information about the LUs that are not currently in session with a TPF application.

Procedure
displays information about the LUs for which a session is currently being started or ended, where:

Bind
displays information about the LUs for which a session is currently being started.

Unbind
displays information about the LUs for which a session is currently being ended.

Rtp-index
displays information about the logical units (LUs) that are in session across a specific rapid transport protocol (RTP) connection, where index is the 1- to 6-digit hexadecimal rapid transport protocol control block (RTPCB) index.

Type
display information about the LUs of a particular type, where

0, 1, 2, 3, or 6.2
displays information about the LUs of type 0, 1, 2, 3, or 6.2, respectively.

Any
displays information about the LUs that are defined in the offline SNA table generation program (OSTG) as LUTYPE=ANY and are not currently in session.
Note:
If an LU is defined as LUTYPE=ANY and is currently in session, that LU is considered to be of type 0, 1, 2, 3, or 6.2, depending on how the session was started.

PLu
displays information about the primary logical units (PLUs) that are not of type 6.2.

CP
displays information about the APPN control point (CP) LUs.

Additional Information

Examples

The following information is displayed in the examples:

 APPL 
is the name of the TPF application with which the LU is in session, or the value NS if the LU is not currently in session with a TPF application.

 CDRM 
is the name of the system services control program (SSCP) or the cross-domain resource manager (CDRM) that owns the LU.
Note:
If no sessions were started for the LU, or if a low entry networking (LEN) session was started for the LU, this column is blank.

 CLASS 
Class associated with the LU, where:

 APSLU 
Application secondary LU

 AX001 
AX.25 single terminal controller

 AX002 
AX.25 multiple terminals controller

 FMMR 
Function management message router LU

 FTPI 
X.25 fast transaction processing LU

 NEF 
Network extension facility LU

 MCHLU 
X.25 multi-channel or physical link

 VCLU 
X.25 virtual circuit LU

 XALCI 
Airlines line control interconnection (ALCI) using an X.25 fast transaction processing (FTPI) LU

 3600 
Finance controller

 3614 
Consumer transaction facility terminal

 3270C 
3270 display device

 3270P 
3270 printer.

 D 
is the status of the LU, where Y indicates that the LU is a dynamic LU.

 LINK 
is the name of the link through which the LU has a session.
Note:
If the session is through an RTP connection that is performing a path switch, this field will be blank.

 LUNAME 
is the name of the LU.

 MODENAME 
is the name of the mode associated with the TPF/APPC LU session.

 NETID 
is the network identifier of the LU.
Note:
If the LU is defined as NETID=ANY in the offline SNA table generation program (OSTG) and is not currently in session, this column is blank.

 P 
is the contention status of the session, where:

 W 
Contention winner

 L 
Contention loser

 N 
Not currently in session.

 PCID 
is the procedure correlation identifier associated with the LU.

 PR 
is the procedure being performed, where:

 B 
A session is currently being started for the LU

 U 
A session is currently being ended for the LU.

 PROC 
is the procedure being performed, where:

 BIND 
A session is currently being started for the LU

 UNBIND 
A session is currently being ended for the LU.

 SCBID 
is the session control block identifier.

 STA 
is the status of the LU, where:

 A 
LU is active and the PIU trace facility is not active for the LU

 A/P 
LU is active and the PIU trace facility is active for the LU

 I 
LU is not active and the PIU trace facility is not active for the LU

 I/P 
LU is not active and the PIU trace facility is active for the LU.

 STATUS 
is the status of the LU, where:

 ACT 
LU is active and the PIU trace facility is not active for the LU

 ACT/P 
LU is active and the PIU trace facility is active for the LU

 INACT 
LU is not active and the PIU trace facility is not active for the LU

 INACT/P 
LU is not active and the PIU trace facility is active for the LU.

 TYP or TYPE 
is the type associated with the LU, where:

 0 
Type 0

 1 
3270/3270E secondary logical unit (SLU) or X.25 LU

 2 
3270/3270E display device

 3 
3270/3270E SLU 3 data stream

 6.2 
Type 6.2

 ANY 
Defined in the OSTG as LUTYPE=ANY and is not currently in session

 CP 
APPN control point (CP) LU

 PLU 
Primary LU (PLU) that is not of type 6.2.

Information about all the LUs in the TPF system is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNDLU                                                                   |
|                                                                                |
|System: NDLU0031I 16.53.48 BEGIN ZNDLU DISPLAY                                  |
|        NETID   .LUNAME   D TYP STA CLASS PR APPL     CDRM     LINK             |
|                .ACPAFMMR    0  I/P FMMR     NS       N/A                       |
|                .APPA       6.2 I/P                                             |
|                .APPC       6.2 A/P                                             |
|                .ATSO1      PLU I/P                                             |
|                .ATSO3      PLU I/P                                             |
|                .AZAZ       6.2 I/P                                             |
|                .AZAZZ001   6.2 I/P                                             |
|                .AZAZZ002   6.2 I/P                                             |
|                .B32O       PLU I/P                                             |
|                .CBM1       PLU I/P                                             |
|                .CBM2       PLU I/P                                             |
|                .CICSESA    6.2 I/P                                             |
|                .CICSESA2   6.2 I/P                                             |
|                .CLGB       PLU I/P                                             |
|                .CLGZ       PLU I/P                                             |
|                .CLG0       PLU I/P                                             |
|                .CLUBB001    0  I/P CLU      NS       N/A                       |
|        VTAMNET .CLUBB002    0  A/P CLU      ELMNGR   N/A      P34CA5B          |
|                .CLUBB003    0  I/P CLU      NS       N/A                       |
|                .CLUCC001    0  I/P CLU      NS       N/A                       |
|                .CLUC02      0  I/P CLU      NS       N/A                       |
|                .CLUC03      0  I/P CLU      NS       N/A                       |
|                .CLUC04      0  I/P CLU      NS       N/A                       |
|                .CLUC06      0  I/P CLU      NS       N/A                       |
|        END OF ZNDLU DISPLAY                                                    |
+--------------------------------------------------------------------------------+

Information about a specific LU is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNDLU ID-VTAMNET.CLUBB002                                               |
|                                                                                |
|System: NDLU0031I 17.05.59 BEGIN ZNDLU DISPLAY                                  |
|        NETID   .LUNAME   D TYP STA CLASS PR APPL     CDRM     LINK             |
|        VTAMNET .CLUBB002    0  A/P CLU      ELMNGR   N/A      P34CA5B          |
|        NDLU0013I 17.05.59   LU - VTAMNET.CLUBB002                              |
|        PCID - VTAMNET .VTAM2 . E383BE95 5248DD76                               |
|        END OF ZNDLU DISPLAY                                                    |
+--------------------------------------------------------------------------------+

Information about all of the LUs that have a session with the XCXC application is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNDLU APPL-XCXC                                                         |
|                                                                                |
|System: NDLU0031I 17.08.08 BEGIN ZNDLU DISPLAY                                  |
|        NETID   .LUNAME   D TYP STA CLASS PR APPL     CDRM     LINK             |
|                .PBPBB001   6.2 A/P          XCXC     TPFB     TBCTCL1          |
|                .PBPBB002   6.2 A/P          XCXC     TPFB     TBCTCL1          |
|                .PBPBB003   6.2 A/P          XCXC     TPFB     TBCTCL1          |
|                .PBPBB004   6.2 A/P          XCXC     TPFB     TBCTCL1          |
|        END OF ZNDLU DISPLAY                                                    |
+--------------------------------------------------------------------------------+

Information about all of the LUs that have a name beginning with the characters AP is displayed in the following example. Notice that information about parallel sessions is not included because the display contains more than one LU.

+--------------------------------------------------------------------------------+
|User:   ZNDLU ID-AP*                                                            |
|                                                                                |
|System: NDLU0031I 08.51.08 BEGIN ZNDLU DISPLAY                                  |
|        NETID   .LUNAME   D TYP STA CLASS PR APPL     CDRM     LINK             |
|                .APPA       6.2 A                                               |
|                .APPC       6.2 A                                               |
|        END OF ZNDLU DISPLAY                                                    |
+--------------------------------------------------------------------------------+

Information about all the local and remote LU 6.2 LUs is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNDLU TYPE-6.2                                                          |
|                                                                                |
|System: NDLU0031I 17.25.47 BEGIN ZNDLU DISPLAY                                  |
|        NETID   .LUNAME   D TYP STA CLASS PR APPL     CDRM     LINK             |
|                .APPA       6.2 A/P                                             |
|                .APPC       6.2 A/P                                             |
|                .AZAZ       6.2 I/P                                             |
|                .AZAZZ001   6.2 I/P                                             |
|                .AZAZZ002   6.2 I/P                                             |
|                .AZAZZ003   6.2 I/P                                             |
|                .AZAZZ004   6.2 I/P                                             |
|                .AZAZZ005   6.2 I/P                                             |
|                .AZAZZ006   6.2 I/P                                             |
|                .AZAZZ007   6.2 I/P                                             |
|                .AZAZZ008   6.2 I/P                                             |
|                .AZAZZ009   6.2 I/P                                             |
|                .AZAZZ010   6.2 I/P                                             |
|                .AZAZZ011   6.2 I/P                                             |
|        END OF ZNDLU DISPLAY                                                    |
+--------------------------------------------------------------------------------+

Information about a remote LU that has TPF/APPC sessions is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNDLU ID-APPC                                                           |
|                                                                                |
|System: NDLU0032I 17.15.31 BEGIN ZNDLU DISPLAY                                  |
|        NETID   .LUNAME   D  TYPE STATUS  CLASS  CDRM                           |
|                .APPC         6.2 ACT/P          TPFB                           |
|        SCBID   MODENAME  P   PROC    APPL     LINK                             |
|        800001  SNASVCMG  L           APPA     TBCTCL1                          |
|        800002  TPFMOD1   W           APPA     TBCTCL1                          |
|        END OF ZNDLU DISPLAY                                                    |
+--------------------------------------------------------------------------------+

Information about sessions that were started for the LU named APPC and have a mode name of TPFMOD1 is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNDLU ID-APPC MODE-TPFMOD1                                              |
|                                                                                |
|System: NDLU0032I 17.15.43 BEGIN ZNDLU DISPLAY                                  |
|        NETID   .LUNAME   D TYPE STATUS  CLASS  CDRM                            |
|                .APPC        6.2 ACT/P          TPFB                            |
|        SCBID   MODENAME  P   PROC    APPL     LINK                             |
|        800002  TPFMOD1   W           APPA     TBCTCL1                          |
|        END OF ZNDLU DISPLAY                                                    |
+--------------------------------------------------------------------------------+

Information about a dynamic LU is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNDLU ID-CNM02F98                                                       |
|                                                                                |
|System: NDLU0031I 15.27.08 BEGIN ZNDLU DISPLAY                                  |
|        NETID   .LUNAME   D TYP STA CLASS PR APPL     CDRM     LINK             |
|                .CNM02F98 Y  1  A   3270P    SMPD     VTAM2NCP N46E730          |
|        NDLU0013I 15.27.08   LU - CNM02F98                                      |
|        PCID - VTAMNET .VTAM2 . E383BE95 79744AE1                               |
|        END OF ZNDLU DISPLAY                                                    |
+--------------------------------------------------------------------------------+

Related Information

See TPF ACF/SNA Data Communications Reference for more information about SNA communications.