DISPLAY SESSIONS command


Display all sessions:

>>-DISPLAY-- --NET--,--SESSIONS--------------------------------->

>--+----------------------------------------------+------------->
   +-,--LU1--=--lu_name--+--------------------+---+   
   |                     '-,--LU2--=--lu_name-'   |   
   +-,--LU2--=--lu_name--+--------------------+---+   
   |                     '-,--LU1--=--lu_name-'   |   
   +-,--PLU--=--plu_name--+---------------------+-+   
   |                      '-,--SLU--=--slu_name-' |   
   '-,--SLU--=--slu_name--+---------------------+-'   
                          '-,--PLU--=--plu_name-'     

   .-,--LIST--=--COUNT----------------.   
>--+----------------------------------+------------------------->
   '-,--LIST--=--+-| ALL operand: |-+-'   
                 +-COUNT------------+     
                 '-SUMMARY----------'     

   .-,--SCOPE--=--ALL---------.   
>--+--------------------------+--------------------------------><
   '-,--SCOPE--=--+-ACT-----+-'   
                  +-ALL-----+     
                  +-PENDING-+     
                  '-Q-------'     

ALL operand:

|--ALL--| MAX operand: |----------------------------------------|

MAX operand:

   .-,--MAX--=--DSPLYDEF_start_option_value-.   
|--+----------------------------------------+-------------------|
   '-,--MAX--=--+-*-------------------+-----'   
                '-number_of_resources-'


Display a specific session:

>>-DISPLAY-- --NET--,--SESSIONS--,--SID--=--session_id---------->

   .-,--PATHINFO--=--YES-----.   
>--+-------------------------+---------------------------------><
   '-,--PATHINFO--=--+-NO--+-'   
                     '-YES-'

Abbreviations

Operand	Abbreviation
DISPLAY	D
PATHINFO=YES	PATH
SCOPE=ACT	ACT or A
SCOPE=ALL	EVERY or E
SCOPE=PENDING	SCOPE=PEND or PEND
SESSIONS	SESSION

When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for SCOPE=ALL, code only EVERY or E. Do not code SCOPE=E.

Purpose

The DISPLAY SESSIONS command displays LU-LU session status information. The command can display status information for:

A single session identified by its session identifier
All sessions in which a specified logical unit is the primary session partner
All sessions in which a specified logical unit is the secondary session partner
All sessions in which a pair of logical units have a specified primary/secondary relationship as session partners
All sessions in which a specified logical unit is a session partner (without regard to its primary or secondary status)
All sessions between a pair of logical units regardless of their primary/secondary relationship as session partners
All sessions known to VTAM®, limited with the SCOPE operand to all pending sessions, all queued sessions, or all active sessions

Note:

To display sessions between specified logical units, one of the session partners must be in the host VTAM network.
If you issue the DISPLAY SESSIONS command at a network node server that is not an interchange node, control point, or SSCP for either session partner, this command might show duplicate information for some sessions. This might occur briefly during BIND processing in a normal session setup or it might indicate a hung session. If subsequent displays continue to show duplicate information for the same session, the session might be hung.

Operands

LIST

Specifies the level of detail to display.

LIST=ALL: Displays all session status information for sessions with the status specified in the SCOPE operand. If SCOPE=ALL, the display includes active, pending, and queued sessions.
LIST=COUNT: Displays only the total number of sessions with the status specified in the SCOPE operand. If SCOPE=ALL, the number includes all sessions, regardless of whether they are active, pending, or queued.
LIST=SUMMARY: Displays the total number of sessions with the status specified in the SCOPE operand (same as LIST=COUNT), plus the actual session state codes for pending and queued sessions. For a description of possible session initiation and termination states, see z/OS Communications Server: SNA Messages.

LU1=lu_name

Identifies the logical unit for which sessions are displayed. lu_name can be specified as a network-qualified name. If you also specify the LU2 operand, the command displays only sessions involving both named logical units.

If lu_name is a generic resource name, VTAM will display session status information for all members known by that generic name.

LU2=lu_name

Identifies the logical unit for which sessions are displayed. lu_name can be specified as a network-qualified name. If you also specify the LU1 operand, the command displays only sessions involving both named logical units.

If lu_name is a generic resource name, VTAM will display session status information for all members known by that generic name.

MAX

Specifies the maximum number of sessions that VTAM displays for this command. This operand is valid only with LIST=ALL.

MAX=*: Specifies that the value of the DSPLYMAX start option is used to limit the display output.
MAX=number_of_resources: Specifies the number of sessions that VTAM displays for this command. The valid range is 1–value of DSPLYMAX. The default is the value specified for the DSPLYDEF start option.
Specifying MAX limits the display output. VTAM searches only for the number of instances that you have specified. When that number is found, VTAM does not search any further. This saves processing time for the command and gives you control over the amount of display output generated by the command. If fewer sessions are found than you have specified on MAX, VTAM displays only the sessions that are found.

PATHINFO

Specifies whether path information is displayed.

PATHINFO=NO

Specifies that no path information is to be displayed.

PATHINFO=YES

Displays the following information for each hop in the session path known to this node:

The TG number
The partner CP name
The TG type
The level of HPR support provided by this node for this TG; the value displayed depends on the HPR start option value and the HPR operand value on the corresponding PU definition (which can be used to override the HPR start option)

The preceding information is displayed in addition to the information currently being displayed.

Additional information such as RSCV and/or HPR path RSCV information is reported to z/OS® by a DLUR node.

PLU=plu_name

Identifies the logical unit that is the primary session partner. plu_name can be specified as a network-qualified name. If you specify the PLU operand, the command displays only sessions in which this logical unit is the primary session partner. If you also specify the SLU operand, the command displays only sessions involving both named logical units in the specified primary/secondary relationship.

If plu_name is a generic resource name, VTAM will display session status information for all members known by that generic name.

SCOPE

Specifies the status of the sessions to display. See z/OS Communications Server: SNA Messages for a description of the initiation states "queued", "pending active", and "active" for each session status. You cannot use this operand with the SID operand.

SCOPE=ACT

Displays only active sessions.

SCOPE=ALL

Displays all sessions, whether active, pending, or queued.

SCOPE=PENDING

Displays only pending sessions. A pending state is:

A transient state to or from a fully active state.
A state of "recovery pending" or "recovery in progress" for sessions that have been retained because of the failure or takeover of an application enabled for persistence.
Note: In either situation, the state of the half-session as seen by the PLU is the status reported for the session. Because of this, you must enter the DISPLAY command on the system that contains the application.

SCOPE=Q

Displays only queued sessions.

SID=session_id

Identifies the VTAM LU-LU session to display. To display the session identifier named in this operand, issue either the DISPLAY SESSIONS,SCOPE=ALL command or a DISPLAY ID=resource name,SCOPE=ALL command. The session ID is identified by SID on the display and is 16 characters long.

If you specify the SID operand, you cannot specify SCOPE or LIST on the same command.

SLU=slu_name

Identifies the logical unit that is the secondary session partner. slu_name can be specified as a network-qualified name. If you specify the SLU operand, the command displays only sessions in which this logical unit is the secondary session partner. If you also specify the PLU operand, the command displays only sessions involving both named logical units in the specified primary/secondary relationship.

If slu_name is a generic resource name, VTAM will display session status information for all members known by that generic name.

Resulting display

The resulting display shows:

For LIST=COUNT:
- The number of sessions with the status specified in the SCOPE operand, optionally limited by LU1, LU2, PLU, or SLU.
- A summary of active SSCP sessions, showing the number of SSCP-LU sessions, the number of SSCP-PU sessions, and the number of SSCP-SSCP sessions. This includes both active and pending sessions. These counts of SSCP sessions are not included in the number of total sessions (message IST878I). This summary of active SSCP sessions does not appear if the display has been limited by the LU1, LU2, PLU, or SLU operands, or if SCOPE excludes active sessions.
For LIST=SUMMARY:
- The number of sessions with the status specified in the SCOPE operand, optionally limited by LU1, LU2, PLU, or SLU.
- For queued and pending sessions, the number of sessions with each status code.
- For active sessions, the number of LU-LU sessions, the number of CP-CP contention winner sessions, and the number of CP-CP contention loser sessions.
- A summary of active SSCP sessions, showing the number of SSCP-LU sessions, the number of SSCP-PU sessions, and the number of SSCP-SSCP sessions. This includes both active and pending sessions. These counts of SSCP sessions are not included in the number of total sessions (message IST878I). This summary of active SSCP sessions does not appear if the display has been limited by the LU1, LU2, PLU, or SLU operands, or if SCOPE excludes active sessions.
For LIST=ALL:
- The names of the resources in the sessions.
- Each session's identifier.
- Each session's status code.
- The number of sessions with the status specified in the SCOPE operand, optionally limited by LU1, LU2, PLU, or SLU.
- For queued and pending sessions, the number of sessions with each status code.
  Note: If the value of the MAX operand is exceeded, count displays 10 asterisks (**********).
- For active sessions, the number of LU-LU sessions, the number of CP-CP or CPSVRMGR contention winner sessions, and the number of CP-CP or CPSVRMGR contention loser sessions.
  Note: If the value of the MAX operand is exceeded, count for the LU-LU sessions displays 10 asterisks (**********).
- A summary of active SSCP sessions, showing the number of SSCP-LU sessions, the number of SSCP-PU sessions, and the number of SSCP-SSCP sessions. This includes both active and pending sessions. These counts of SSCP sessions are not included in the number of total sessions (message IST878I). This summary of active SSCP sessions does not appear if the display has been limited by the LU1, LU2, PLU, or SLU operands, or if SCOPE excludes active sessions.
For SID:
- The real and alias (if available) names of the primary session partner.
- The real and alias (if available) names of the secondary session partner.
- The session status.
- The adjacent SSCP toward the PLU or SLU, if cross-domain (if available).
- The rapid transport protocol (RTP) physical unit as the ALSNAME toward the PLU or SLU, if the session is using high performance routing (HPR).
- The gateway NCP toward the PLU or SLU, if cross-network (if available).
- The signals needed to complete a session, if the session is pending session setup or takedown.
- The Class of Service table entry and logon mode entry used.
- The APPN Class of Service toward the PLU or SLU, (if available).
- Compression information, if compression is being used on the session in either the PLU-to-SLU or the SLU-to-PLU direction.
  - The compression-level values (0–4) in use for input and output messages
  - The percentage of reduction in length for input and output messages
  - The indicator "NA" (not applicable) if there has been no message traffic or if compression is not being used on either the inbound or outbound half-session.
  If compression is not being used in either direction, this information is not displayed.
- If the command is issued on the application owning host, RU size information is displayed.
- Path information for each hop in the session known to this node.

Examples

Displaying a specific session:

d net,sessions,sid=eaabeec3e5a79ccb
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST879I PLU/OLU REAL = NETA.APPL2        ALIAS = ***NA***
IST879I SLU/DLU REAL = NETA.APPL1        ALIAS = ***NA***
IST880I SETUP STATUS = ACTIV
IST933I LOGMODE=INTERACT, COS=*BLANK*
IST1635I PLU HSCB TYPE: FMCB LOCATED AT ADDRESS X'0155F5B8'
IST1635I SLU HSCB TYPE: FMCB LOCATED AT ADDRESS X'0155F720'
IST2064I PLU TO SLU RU SIZE = 65535    SLU TO PLU RU SIZE = 65535
IST1636I PACING STAGE(S) AND VALUES:
IST1637I PLU--STAGE 1--SLU
IST1638I STAGE1: PRIMARY TO SECONDARY DIRECTION - ADAPTIVE
IST1639I         PRIMARY SEND: CURRENT   =     7     NEXT =     8
IST1640I         SECONDARY RECEIVE       = 32767
IST1641I STAGE1: SECONDARY TO PRIMARY DIRECTION - ADAPTIVE
IST1642I         SECONDARY SEND: CURRENT =     7     NEXT =     8
IST1643I         PRIMARY RECEIVE         = 32767
IST314I END

Displaying all sessions:

d net,sessions,scope=all,list=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST873I        PLU               SLU              SID        STATUS
IST874I NETA.SSCP1A       NETA.ENCPA4       EAABEEC3297ED9FC ACTIV/DL
IST874I NETB.SSCP7B       NETA.SSCP1A       C2BB19BC57AD196C ACTIV/CP
IST874I NETA.SSCP1A       NETB.SSCP7B       EAABEEC3297ED9FA ACTIV/CP
IST874I NETA.SSCP2A       NETA.SSCP1A       F6ABEEC32C7EDA76 ACTIV/CP
IST874I NETA.SSCP1A       NETA.SSCP2A       EAABEEC3297ED9F8 ACTIV/CP
IST874I NETA.ENCPA4       NETA.SSCP1A       E2C5E2E2D6D50013 ACTIV/DL
IST924I -------------------------------------------------------------
IST878I NUMBER OF PENDING SESSIONS =          0
IST924I -------------------------------------------------------------
IST878I NUMBER OF ACTIVE  SESSIONS =          6
IST1162I    LU-LU                  =          2
IST1162I    CP-CP CONWINNER        =          2
IST1162I    CP-CP CONLOSER         =          2
IST924I -------------------------------------------------------------
IST878I NUMBER OF QUEUED  SESSIONS =          0
IST924I -------------------------------------------------------------
IST878I NUMBER OF TOTAL   SESSIONS =          6
IST924I -------------------------------------------------------------
IST1161I SSCP SESSIONS
IST1162I    SSCP-LU                =          6
IST1162I    SSCP-PU                =          4
IST1162I    SSCP-SSCP              =          0
IST314I END

Displaying sessions, limiting output to six sessions:

d net,sessions,list=all,max=6
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST873I        PLU               SLU              SID        STATUS
IST874I NETA.MECHZ1A      NETA.ECHOZHA      D9F389C8E5517F35 ACTIV/MI
IST874I NETA.MECHZ1A      NETA.ECHOZHA      D9F389C8E5517F38 ACTIV/MI
IST874I NETA.ECHOZIA      NETA.ECHOZHA      E7F38956127BB9F6 ACTIV
IST874I NETA.ECHOZIA      NETA.ECHOZHA      E7F38956127BB9F4 ACTIV
IST874I NETA.MECHZIA      NETA.ECHOZHA      E7F38956127BB9F3 ACTIV/M
IST874I NETA.MECHZIA      NETA.ECHOZHA      E7F38956127BB9F1 ACTIV/M
IST1315I DISPLAY TRUNCATED AT MAX = 6
IST924I -------------------------------------------------------------
IST878I NUMBER OF PENDING SESSIONS = **********
IST924I -------------------------------------------------------------
IST878I NUMBER OF ACTIVE  SESSIONS = **********
IST1162I    LU-LU                  = **********
IST1162I    CP-CP CONWINNER        =          1
IST1162I    CP-CP CONLOSER         =          1
IST924I -------------------------------------------------------------
IST878I NUMBER OF QUEUED  SESSIONS = **********
IST924I -------------------------------------------------------------
IST878I NUMBER OF TOTAL   SESSIONS = **********
IST924I -------------------------------------------------------------
IST1161I SSCP SESSIONS
IST1162I    SSCP-LU                =         25
IST1162I    SSCP-PU                =          1
IST1162I    SSCP-SSCP              =          0
IST314I END

Displaying a summary of all sessions:

d net,sessions,scope=all,list=summary
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST924I -------------------------------------------------------------
IST878I NUMBER OF PENDING SESSIONS =          0
IST924I -------------------------------------------------------------
IST878I NUMBER OF ACTIVE  SESSIONS =          4
IST1162I    LU-LU                  =          2
IST1162I    CP-CP CONWINNER        =          1
IST1162I    CP-CP CONLOSER         =          1
IST924I -------------------------------------------------------------
IST878I NUMBER OF QUEUED  SESSIONS =          0
IST924I -------------------------------------------------------------
IST878I NUMBER OF TOTAL   SESSIONS =          4
IST924I -------------------------------------------------------------
IST1161I SSCP SESSIONS
IST1162I    SSCP-LU                =         10
IST1162I    SSCP-PU                =          4
IST1162I    SSCP-SSCP              =          0
IST314I END

Displaying all sessions for a specific LU:

d net,sessions,lu1=appl0001,scope=all,list=summary
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST924I -------------------------------------------------------------
IST878I NUMBER OF PENDING SESSIONS =          0
IST924I -------------------------------------------------------------
IST878I NUMBER OF ACTIVE  SESSIONS =          1
IST924I -------------------------------------------------------------
IST878I NUMBER OF QUEUED  SESSIONS =          0
IST924I -------------------------------------------------------------
IST878I NUMBER OF TOTAL   SESSIONS =          1
IST314I END

Displaying active sessions for a specific LU:

d net,sessions,lu1=appl1,scope=act,list=count
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST878I NUMBER OF ACTIVE  SESSIONS =          1
IST314I END

Displaying pending sessions for a specific LU:

d net,sessions,lu1=appl1,scope=pending,list=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST873I        PLU               SLU              SID        STATUS
IST874I NETA.APPL1        NETA.NETAPPL1     EAABEEC3FD825DEA PSEST/B
IST878I NUMBER OF PENDING SESSIONS =          1
IST1237I    PSEST    = 1
IST314I END

Displaying queued sessions between two LUs:

d net,sessions,lu1=appl1,lu2=appl0001,scope=q,list=count
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST1284I LUALIAS APPL0001 IS NETA.NETAPPL1 FOR APPLICATIONS
IST878I NUMBER OF QUEUED  SESSIONS =          2
IST314I END

Displaying a count of active sessions with a USERVAR:

d net,sessions,lu1=echo01a,scope=act,list=count
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST113I ECHO01A IS A USERVAR WITH VALUE ECHO01A IN NETWORK NETA
IST1057I NETA.ECHO01A IS ALSO A REAL RESOURCE
IST878I NUMBER OF ACTIVE  SESSIONS =         61
IST314I END

Displaying a generic resource name for LU1:

d net,sessions,lu1=cics,list=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST1364I CICS IS A GENERIC RESOURCE NAME FOR:
IST1154I NETA.CICS1        NETA.CICS2        NETA.CICS3
IST924I -------------------------------------------------------------
IST873I        PLU               SLU              SID        STATUS
IST874I NETA.CICS1        NETA.APPL1A2      EAABEEC3F8FE476C ACTIV
IST874I NETA.APPL1A1      NETA.CICS2        EAABEEC3F8FE476B ACTIV
IST874I NETA.APPL1A1      NETA.CICS2        EAABEEC3F8FE476A ACTIV
IST874I NETA.CICS3        NETA.APPL1A5      EAABEEC3F8FE4769 ACTIV
IST874I NETA.CICS3        NETA.APPL1A9      EAABEEC3F8FE4768 ACTIV
IST878I NUMBER OF PENDING SESSIONS =          0
IST878I NUMBER OF ACTIVE  SESSIONS =          5
IST878I NUMBER OF QUEUED  SESSIONS =          0
IST878I NUMBER OF TOTAL   SESSIONS =          5
IST314I END

Displaying PATHINFO with HPR (including all the types of session/paths):

d net,sessions,sid=f6abeec39de53b70,pathinfo=yes
IST097I DISPLAY ACCEPTED                                
IST350I DISPLAY TYPE = SESSIONS                         
IST879I PLU/OLU REAL = NETA.NETAPPL1     ALIAS = ***NA***        
IST879I SLU/DLU REAL = NETA.AA2LUA1      ALIAS = ***NA***        
IST880I SETUP STATUS = ACTIV                                     
IST875I ADJSSCP TOWARDS PLU = ISTAPNCP                           
IST875I ALSNAME TOWARDS PLU = CNR00004                           
IST875I ALSNAME TOWARDS SLU = P3A4956N                           
IST933I LOGMODE=INTERACT, COS=*BLANK*                            
IST875I APPNCOS TOWARDS PLU = #INTER                             
IST875I APPNCOS TOWARDS SLU = #INTER                             
IST1635I PLU HSCB TYPE: BSB LOCATED AT ADDRESS X'02FF6228'       
IST1636I PACING STAGE(S) AND VALUES:                             
IST1644I PLU--STAGE 1-----|-----STAGE 2--SLU                     
IST1638I STAGE1: PRIMARY TO SECONDARY DIRECTION - ADAPTIVE       
IST1640I         SECONDARY RECEIVE       =     1                 
IST1641I STAGE1: SECONDARY TO PRIMARY DIRECTION - ADAPTIVE       
IST1642I         SECONDARY SEND: CURRENT =     1     NEXT =     1
IST1638I STAGE2: PRIMARY TO SECONDARY DIRECTION - ADAPTIVE       
IST1639I         PRIMARY SEND: CURRENT   =     0     NEXT =     1
IST1641I STAGE2: SECONDARY TO PRIMARY DIRECTION - ADAPTIVE       
IST1643I         PRIMARY RECEIVE         =    15                 
IST1710I RSCV FROM PLU SAVED AT SESSION ACTIVATION               
IST1460I TGN  CPNAME             TG TYPE      HPR                
IST1461I  21  NETA.SSCP1A        APPN         RTP                
IST1461I  21  NETA.NNCPA2        APPN         *NA*               
IST1713I RTP RSCV IN THE DIRECTION OF THE PLU                    
IST1460I TGN  CPNAME             TG TYPE      HPR                
IST1461I  21  NETA.SSCP2A        APPN         RTP                
IST1758I RSCV TOWARDS DLUR SAVED AT SESSION ACTIVATION           
IST1460I TGN  CPNAME             TG TYPE      HPR                
IST1461I  21  NETA.SSCP1A        APPN         RTP                
IST1461I  21  NETA.NNCPA2        APPN         *NA*               
IST1759I RTP RSCV FROM THE DIRECTION OF THE DLUR                 
IST1460I TGN  CPNAME             TG TYPE      HPR 
IST1461I  22  NETA.SSCP1A        APPN         RTP 
IST1461I  21  NETA.NNCPA2        APPN         *NA*
IST314I END

Displaying PATHINFO without HPR:

d net,sessions,sid=F6ABEEC350FC32A6,path
IST097I DISPLAY ACCEPTED                                  
IST350I DISPLAY TYPE = SESSIONS                           
IST879I PLU/OLU REAL = NETA.NETAPPL1     ALIAS = ***NA*** 
IST879I SLU/DLU REAL = NETA.APPLAA1      ALIAS = ***NA*** 
IST880I SETUP STATUS = ACTIV                              
IST875I ADJSSCP TOWARDS SLU = ISTAPNCP    
IST875I ALSNAME TOWARDS SLU = AHHCPU1                  
IST933I LOGMODE=INTERACT, COS=*BLANK*                  
IST875I APPNCOS TOWARDS SLU = #INTER                   
IST1711I RSCV TOWARDS SLU SAVED AT SESSION ACTIVATION  
IST1460I TGN  CPNAME             TG TYPE      HPR      
IST1461I  21  NETA.SSCP1A        APPN         *NA*     
IST1461I  21  NETA.SSCPAA        APPN         *NA*     
IST314I END