DISPLAY SESSIONS command
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
- 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
- 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
, andactive
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
orrecovery 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
- 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, DSMONITR status and RU size information are displayed.
- Path information for each hop in the session known to this node.
Examples
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'
IST2436I DSMONITR = NO
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
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
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
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
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
d net,sessions,lu1=appl1,scope=act,list=count
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SESSIONS
IST878I NUMBER OF ACTIVE SESSIONS = 1
IST314I END
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
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
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
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
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
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