DISPLAY LINES command

Read syntax diagramSkip visual syntax diagram
>>-DISPLAY-- --NET--,--LINES------------------------------------>

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

   .-,--LIST--=--ALL-------.   
>--+-----------------------+------------------------------------>
   '-,--LIST--=--+-ALL---+-'   
                 '-COUNT-'     

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

>--+----------------------------+------------------------------->
   '-,--OWNER--=--+-host_name-+-'   
                  '-*NONE-----'     

   .-,--SCOPE--=--ALL---------------.   
>--+--------------------------------+--------------------------->
   |              .-ALL-----------. |   
   '-,--SCOPE--=--+---------------+-'   
                  '-+-----------+-'     
                    +-ACT-------+       
                    +-ACTONLY---+       
                    +-ALL-------+       
                    +-IACTIVE---+       
                    +-IINACT----+       
                    +-INACT-----+       
                    +-INACTONLY-+       
                    +-PENDING---+       
                    '-RESET-----'       

>--+------------------------+----------------------------------><
   '-,--USE--=--+-DEFINED-+-'   
                '-SPARE---'     
Notes:
  1. 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=ALL EVERY or E
SCOPE=INACT INACT or I
USE=DEFINED DEFINED
USE=SPARE SPARE
SCOPE=INACTONLY INACTONL
SCOPE=PENDING PEND
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 LINES command displays the status of lines and channel links in the domain.

Note: To display lines and channel links independently of the major nodes that contain them, use the DISPLAY RSCLIST command with IDTYPE=LINES.

Operands

ID=name
Specifies the name of one or more active NCP, channel-attachment, or XCA major nodes whose subordinate lines and channel links are to be displayed.

If OWNER is also specified on this command, the value of ID must match the name of an NCP 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.

Note: Specifying a wildcard name might degrade performance because VTAM® checks every NCP, channel-attachment, and XCA major node in the network.
LIST
Specifies the level of detail to display.
LIST=COUNT
Displays only the number of resources in each state, based on the filters specified in the SCOPE, OWNER, and IDTYPE keywords.
LIST=ALL
Displays information about all resources, based on the filters specified in the SCOPE, OWNER, and IDTYPE keywords.
MAX
Specifies the maximum number of resources 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 lines and channel links 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 lines or channel links are found than you have specified on MAX, VTAM displays only the lines and channel links that are found.

OWNER
Specifies whether lines and channel links defined with the OWNER operand are to be displayed. This operand is valid only when the name or the wildcard value specified on the ID operand matches the name of an NCP major node.
OWNER=host_name
Specifies that only lines and channel links whose owning SSCP (as determined by the OWNER operand on the GROUP or LINE definition statements) matches the host_name specified are to be displayed.
OWNER=*NONE
Specifies that only lines and channel links without an OWNER operand on the GROUP or LINE definition statements are to be displayed.
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 lines and channel links within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted). If this display is undesirably large, you can use SCOPE=ACTONLY to further limit the display.
SCOPE=ACTONLY
Specifies that information is to be displayed about all lines and channel links in an active state within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted). The display does not include lines and channel links in pending or connectable states. If no lines or channel links 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=ALL
Specifies that information is to be displayed about all lines and channel links (regardless of their status) within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted).
SCOPE=IACTIVE
Specifies that information is to be displayed about all lines and channel links within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted) which are ISTATUS=ACTIVE.
SCOPE=IINACT
Specifies that information is to be displayed about all lines and channel links within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted) which are STATUS=INACTIVE.
SCOPE=INACT
Specifies that information is to be displayed about all inactive lines and channel links within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted). 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 lines and channel links within the specified major nodes (or within all major nodes if the ID operand is omitted). 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 lines and channel links within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted). A pending state is a transient state to or from the fully active state.
SCOPE=RESET
Specifies that information is to be displayed about all lines and channel links in a RESET state within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted).
USE
Specifies whether information is to be displayed about lines that are currently designated as DEFINED or SPARE. If you do not specify USE, information about both spare and defined lines is displayed.
USE=DEFINED
Specifies that information is to be displayed only about lines that are currently usable.
USE=SPARE
Specifies that information is to be displayed only about spare lines.

Resulting display

VTAM displays the name and status of each line within the specified major node (or within all major nodes containing lines if ID is omitted). The display is limited to active, inactive, or pending minor nodes if specified on the SCOPE operand.

Examples

Displaying all lines: 
d net,lines
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = LINES
IST354I PU T4/5 MAJOR NODE = ISTPUS
IST170I LINES:
IST080I 0016-L   ACTIV----I 0017-L   ACTIV----I
IST354I PU T4/5 MAJOR NODE = A0462ZC
IST170I LINES:
IST080I A04B00   NEVAC      A04B01   NEVAC      A04B03   NEVAC
IST080I A04B32   NEVAC      A04B33   NEVAC      A04B35   NEVAC
IST080I A04VXX   NEVAC----T A04S02   NEVAC      A04S34   NEVAC
IST080I A04S04   NEVAC      A04S16   NEVAC      A04S20   NEVAC
IST080I A04S36   NEVAC      A04S48   NEVAC      A04S52   NEVAC
IST080I A04S128  NEVAC      A04S136  NEVAC      A04PT88  ACTIV
IST080I A04PT89  NEVAC      A04PT92  NEVAC      J0004001 ACTIV
IST080I J0004003 ACTIV      J0004005 ACTIV      J0004007 ACTIV
IST080I J0004009 ACTIV      J000400B ACTIV      J000400D ACTIV
IST080I J000400F ACTIV      J0004011 ACTIV      J0004013 ACTIV
IST080I A04C00   NEVAC      A04C02   NEVAC
IST1454I 32 RESOURCE(S) DISPLAYED
IST314I END
Displaying all lines within a specific major node: 
d net,lines,id=a0362zc
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = LINES
IST354I PU T4/5 MAJOR NODE = A0362ZC
IST170I LINES:
IST080I A03B00   NEVAC      A03B01   NEVAC      A03B32   NEVAC
IST080I A03B33   NEVAC      A03VXX   NEVAC----T A03S02   NEVAC
IST080I A03S16   ACTIV      A03S20   ACTIV      A03S128  NEVAC
IST080I A03PT88  ACTIV      A03PT89  ACTIV      J0003001 ACTIV
IST080I J0003003 ACTIV      J0003005 ACTIV      J0003007 ACTIV
IST080I J0003009 ACTIV      J000300B ACTIV      J000300D ACTIV
IST080I J000300F ACTIV      J0003011 ACTIV      J0003013 ACTIV
IST080I J0003015 ACTIV      J0003017 ACTIV      J0003019 ACTIV
IST080I J000301B ACTIV      J000301D ACTIV      J000301F NEVAC
IST080I J0003021 NEVAC      J0003023 NEVAC      J0003025 NEVAC
IST080I J0003027 NEVAC      J0003029 NEVAC      J000302B NEVAC
IST080I J000302D NEVAC      J000302F NEVAC      J0003031 ACTIV
IST080I J0003033 ACTIV      J0003035 ACTIV      J0003037 ACTIV
IST080I J0003039 ACTIV      J000303B ACTIV      J000303D ACTIV
IST080I J000303F ACTIV      J0003041 ACTIV      J0003043 ACTIV
IST080I J0003045 ACTIV      J0003047 ACTIV      J0003049 ACTIV
IST080I J000304B ACTIV      J000304D ACTIV      J000304F NEVAC
IST080I A03C08   NEVAC      A03C10   NEVAC      A03C00   NEVAC
IST080I A03C02   NEVAC
IST1454I 55 RESOURCE(S) DISPLAYED FOR ID=A0362ZC
IST314I END
Displaying all lines owned by a specific SSCP: 
d net,lines,owner=sscp1a
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = LINES
IST354I PU T4/5 MAJOR NODE = NCP3AA1
IST170I LINES:
IST080I LN3A1    NEVAC      LN3A7    NEVAC      LN3A4    NEVAC
IST080I LN3A4A1  NEVAC      LN3A4A2  NEVAC      LN3A4A3  NEVAC
IST080I LN3A4A4  NEVAC      LN3A4AM  NEVAC      LN3A5A1  NEVAC
IST080I LN3A5A2  NEVAC      LN3A8A1  NEVAC
IST1454I 11 RESOURCE(S) DISPLAYED
IST314I END
Displaying lines, limiting output to three resources: 
d net,lines,max=3
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = LINES
IST354I PU T4/5 MAJOR NODE = NCP3AA1
IST170I LINES:
IST080I LN3A1    NEVAC      LN3A6    NEVAC      LN3A7    NEVAC
IST1315I DISPLAY TRUNCATED AT MAX = 3
IST1454I 3 RESOURCE(S) DISPLAYED
IST314I END
Displaying LIST=COUNT: 
d net,lines,id=ncp3ab8,list=count
IST097I DISPLAY ACCEPTED                                   
IST350I DISPLAY TYPE = LINES                               
IST354I PU T4/5 MAJOR NODE = NCP3AB8                               
IST1747I SUMMARY OF STATE INFORMATION:                             
IST1748I RESET =          1  INACT =         67  ACTIV =          1
IST1454I 69 RESOURCE(S) DISPLAYED FOR ID=NCP3AB8                   
IST314I END
Parent topic: VTAM operator commands