DISPLAY STATIONS command


>>-DISPLAY-- --NET--,--STATIONS--------------------------------->

>--+----------------------------------+------------------------->
   |                              (1) |   
   '-,--ID--=--+-name-----------+-----'   
               |    .-,----.    |         
               |    V      |    |         
               '-(----name-+--)-'         

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

   .-,--SCOPE--=--ALL---------------.   
>--+--------------------------------+--------------------------><
   |              .-ALL-----------. |   
   '-,--SCOPE--=--+---------------+-'   
                  '-+-----------+-'     
                    +-ACT-------+       
                    +-ACTONLY---+       
                    +-ACTSESS---+       
                    +-ALL-------+       
                    +-CONCT-----+       
                    +-INACT-----+       
                    +-INACTONLY-+       
                    +-PENDING---+       
                    +-RELSD-----+       
                    '-RESET-----'

Notes:

Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand.

Abbreviations

Operand	Abbreviation
DISPLAY	D
SCOPE=ACT	ACT or A
SCOPE=ACTONLY	ACTONLY
SCOPE=ACTSESS	ACTSESS
SCOPE=ALL	EVERY or E
SCOPE=CONCT	CONCT
SCOPE=INACT	INACT or I
SCOPE=INACTONLY	INACTONL
SCOPE=PENDING	PEND
SCOPE=RELSD	RELSD
SCOPE=RESET	RESET

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 STATIONS command displays the status of all cross-subarea link stations for active major nodes.

Operands

ID=name

Specifies the name of one or more major nodes, groups, lines, or link stations. If this operand is specified, information is displayed about only the link stations associated with the specified nodes. If this operand is omitted, information is displayed about all link stations in every active major node.

Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand. For more information about using wildcards, see Using wildcard names.

Attention: Specifying a wildcard name might degrade performance because VTAM® checks every major node, group, line, and link station in the network.

MAX

Specifies the maximum number of cross-subarea link stations that VTAM displays for this command.

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 cross-subarea link stations 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 cross-subarea link stations are found than you have specified on MAX, VTAM displays only the stations that are found.

SCOPE

Specifies the required scope of the display.

Note: If you specify the SCOPE operand without specifying a value SCOPE=ALL is assumed.

SCOPE=ACT: Specifies that information is to be displayed about all active, pending, and connectable cross-subarea link stations within each major node or associated with a specific node. If this display is undesirably large, you can use SCOPE=ACTONLY or SCOPE=CONCT to further limit the display.
SCOPE=ACTONLY: Specifies that information is to be displayed about all cross-subarea link stations in an active state within each major node or associated with a specific node. The display does not include link stations in pending or connectable states. If no link stations are found in an active state, you can use SCOPE=ACT to broaden the scope of the display to include those in active, connectable, and pending states.
SCOPE=ACTSESS: Specifies that information is to be displayed about all cross-subarea link stations that are active with sessions within each major node or associated with a specific node.
SCOPE=ALL: Specifies that information is to be displayed about all cross-subarea link stations within each major node or associated with a specific node (regardless of their status).
SCOPE=CONCT: Specifies that information is to be displayed about all cross-subarea link stations in a CONCT (connectable) state within each major node or associated with a specific node. If no link stations are found in a connectable state, you can use SCOPE=ACT to broaden the scope of the display to include those in active, connectable, and pending states.
SCOPE=INACT: Specifies that information is to be displayed about all inactive cross-subarea link stations within each major node or associated with a specific node. If this display is undesirably large, you can use SCOPE=INACTONLY or SCOPE=RESET to further limit the display.
SCOPE=INACTONLY: Specifies that information is to be displayed about all inactive cross-subarea link stations within each major node or associated with a specific node. Resources in a RESET state are not included in the SCOPE=INACTONLY display.
SCOPE=PENDING: Specifies that information is to be displayed about all pending cross-subarea link stations within each major node or associated with a specific node. A pending state is a transient state to or from the fully active state.
SCOPE=RELSD: Specifies that the information is to be displayed about all PUs in a RELSD state within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted).
SCOPE=RESET: Specifies that information is to be displayed about cross-subarea link stations in a RESET state within each major node or associated with a specific node.

Resulting display

The resulting display shows:

For each major node containing physical units that have subordinate link stations (host PU, NCP major node, or channel-attachment major node), or a node with subordinate or associated link stations:
- The name of the major node
- The subarea address of the major node (if it has one)
For each link station:
- The name and status of the link
- The name and status of the link station
- The current transmission group number
- The defined transmission group number (If no specific transmission group number was defined, it is displayed as 0.)
- The name (if known) and subarea (if known) of any adjacent NCP or host with which the link station is currently associated, and the name of the network in which the adjacent NCP or host is

Examples

Displaying a specific cross-subarea link station:

d net,stations,id=a31p04a
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STATIONS
IST393I PU T4/5 MAJOR NODE A3162ZC, SUBAREA = 310
IST396I LNKSTA    STATUS     CTG GTG ADJNODE  ADJSA  NETID  ADJLS
IST397I A31P04A   NEVAC        1   1              0
IST610I                            LINE A31C04   - STATUS NEVAC
IST1454I 1 STATIONS(S) DISPLAYED FOR ID=A31P04A
IST314I END

Displaying all cross-subarea link stations:

d net,stations
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STATIONS
IST393I PU T4/5 MAJOR NODE ISTPUS , SUBAREA = 500
IST396I LNKSTA    STATUS     CTG GTG ADJNODE  ADJSA  NETID  ADJLS
IST397I 0016-S    ACTIV----I   1   1 A3162ZC    310   NETA
IST610I                            LINE 0016-L   - STATUS ACTIV----I
IST397I 0015-S    ACTIV----I   1   1 A0362ZC      3   NETA
IST610I                            LINE 0015-L   - STATUS ACTIV----I
IST393I PU T4/5 MAJOR NODE A0362ZC, SUBAREA = 3
IST396I LNKSTA    STATUS     CTG GTG ADJNODE  ADJSA  NETID  ADJLS
IST397I A03P08A   NEVAC        0   0              0
IST610I                            LINE A03C08   - STATUS NEVAC
IST397I A03P10A   NEVAC        1   1              0
IST610I                            LINE A03C10   - STATUS NEVAC
IST393I PU T4/5 MAJOR NODE A3162ZC, SUBAREA = 310
IST396I LNKSTA    STATUS     CTG GTG ADJNODE  ADJSA  NETID  ADJLS
IST397I A31P00A   NEVAC        1   1              0
IST610I                            LINE A31C00   - STATUS NEVAC
IST397I A31P01A   NEVAC        1   1              0
IST610I                            LINE A31C01   - STATUS NEVAC
IST397I A31P02A   NEVAC        1   1              0
IST610I                            LINE A31C02   - STATUS NEVAC
IST397I A31P03A   NEVAC        1   1              0
IST610I                            LINE A31C03   - STATUS NEVAC
IST397I A31P04A   NEVAC        1   1              0
IST610I                            LINE A31C04   - STATUS NEVAC
IST397I A31P05A   NEVAC        1   1              0
IST610I                            LINE A31C05   - STATUS NEVAC
IST397I A31P06A   NEVAC        1   1              0
IST610I                            LINE A31C06   - STATUS NEVAC
IST1454I 11 STATIONS(S) DISPLAYED
IST314I END

Displaying cross-subarea link stations, limiting output to six resources:

d net,stations,max=6
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STATIONS
IST393I PU T4/5 MAJOR NODE ISTPUS, SUBAREA = 1
IST1358I NO QUALIFYING MATCHES
IST393I PU T4/5 MAJOR NODE NCP3AA1, SUBAREA = 3
IST394I ADJACENT LINK STATIONS NOT OWNED BUT AWAITING ACTIVATION
IST395I LS4A3A4   LS4A3A3   LS4A3A2   LS4A3A1
IST396I LNKSTA    STATUS     CTG GTG ADJNODE  ADJSA  NETID  ADJLS
IST397I LS3A4A1   NEVAC        2   2
IST610I                            LINE LN3A4A1  - STATUS NEVAC
IST397I LS3A4A2   NEVAC        2   2
IST610I                             LINE LN3A4A2  - STATUS NEVAC
IST1315I DISPLAY TRUNCATED AT MAX = 6
IST1454I 6 STATIONS(S) DISPLAYED
IST314I END