DISPLAY LINES command
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.
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
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
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
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
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
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