>>-DISPLAY-- --NET--,--TERMS------------------------------------> >--+----------------------------------+-------------------------> | (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---+ '-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=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 TERMS
(terminals) command displays the status of device-type logical units
(terminals) that are in active major nodes. The command does not display information about
independent LUs.
Note:
- In a domain that has many terminals, this command might result in an undesirably large display, especially if the SCOPE=ALL operand, which is the default, is used. You can limit the display by using a more restrictive SCOPE value and by specifying the required major node or nodes on the ID operand.
- To display device-type logical units independently of the major nodes that contain them, use the DISPLAY RSCLIST command with IDTYPE=TERMS.
Operands
- ID=name
- Specifies the name of one or more active NCP, local SNA, local
non-SNA, or switched major nodes whose device-type LUs are to be displayed.
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 in the network. - MAX
- Specifies the maximum number of terminals 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 terminals 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 terminals are found than you have specified on MAX, VTAM displays only the terminals 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 device-type logical units within the specified major nodes (or within all major nodes if the ID operand is omitted). 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 device-type logical units in an active state within the specified major nodes (or within all major nodes if the ID operand is omitted). The display does not include terminals in pending or connectable states. If no terminals are found in an active state, you can use SCOPE=ACT to broaden the scope of the display to include terminals in active, connectable, and pending states.
- SCOPE=ACTSESS
- Specifies that information is to be displayed about all device-type logical units that are active with sessions within the specified major nodes (or within all major nodes if the ID operand is omitted).
- SCOPE=ALL
- Specifies that information is to be displayed about all device-type logical units (regardless of their status) within the specified major nodes (or within all major nodes if the ID operand is omitted).
- SCOPE=CONCT
- Specifies that information is to be displayed about all device-type logical units in a CONCT (connectable) state within the specified major nodes (or within all major nodes if the ID operand is omitted). If no terminals are found in a connectable state, you can use SCOPE=ACT to broaden the scope of the display to include terminals in active, connectable, and pending states.
- SCOPE=INACT
- Specifies that information is to be displayed about all inactive device-type logical units within the specified major nodes (or within all 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 device-type logical units 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 device-type logical units within the specified major nodes (or within all 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 device-type logical units in a RESET state within the specified major nodes (or within all major nodes if the ID operand is omitted).
Resulting display
For each
major node with terminals, the resulting display shows:
- The major node name
- The line name and status (if the terminal is attached over a line)
- The name and status of the associated physical unit (if any)
- The name and status of the logical unit
Note: Physical units and logical units in a switched major
node are always listed under the switched major node and never under
the NCP or channel-attachment major node containing the switched link
through which they are attached. To determine the name of this NCP
or channel-attachment major node and line, enter a "DISPLAY ID command" with ID=pu_name or
ID=lu_name.
Examples
Displaying terminals
within a specific node:
d net,terms,id=a50local
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = LOGICAL UNITS/TERMS
IST351I LOCAL 3270 MAJOR NODE = A50LOCAL
IST089I A50A720 TYPE = LOGICAL UNIT , NEVAC ,CUA=0720
IST089I A50A721 TYPE = LOGICAL UNIT , ACTIV ,CUA=0721
IST089I A50A722 TYPE = LOGICAL UNIT , ACT/S ,CUA=0722
IST089I A50A723 TYPE = LOGICAL UNIT , ACTIV ,CUA=0723
IST089I A50A724 TYPE = LOGICAL UNIT , ACTIV ,CUA=0724
IST089I A50A725 TYPE = LOGICAL UNIT , ACTIV ,CUA=0725
IST089I A50A726 TYPE = LOGICAL UNIT , NEVAC ,CUA=0726
IST1454I 7 RESOURCE(S) DISPLAYED FOR ID=A50LOCAL
IST314I ENDDisplaying all terminals:
d net,terms
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = LOGICAL UNITS/TERMS
IST353I SWITCHED SNA MAJOR NODE = ISTDSWMN
IST146I LINE NAME = J000400B, STATUS = ACTIV
IST359I ATTACHMENT = SWITCHED
IST089I A04P88A TYPE = PU_T2 , ACTIV---X-
IST355I LOGICAL UNITS:
IST080I A04D88A1 ACTIV---X- A04D88A2 ACTIV---X- A04D88A3 ACT/S---X-
IST080I A04D88A4 ACTIV---X- A04D88A5 ACTIV---X- A04D88A6 ACTIV---X-
IST080I A04D88A7 ACTIV---X- A04D88A8 ACTIV---X- A04D88A9 ACTIV---X-
IST080I A04D88AA ACTIV---X- A04D88AB ACT/S---X- A04D88AC ACT/S---X-
IST080I A04D88AD ACT/S---X- A04D88AE ACT/S---X- A04D88AF ACT/S---X-
IST146I LINE NAME = J0004011, STATUS = ACTIV
IST359I ATTACHMENT = SWITCHED
IST089I A04P887 TYPE = PUT_2 , ACTIV---X-
IST355I LOGICAL UNITS:
IST080I A04D8871 ACTIV---X- A04D8872 ACTIV---X- A04D8873 ACTIV---X-
IST080I A04D8874 ACTIV---X- A04D8875 ACTIV---X- A04D8876 ACTIV---X-
IST080I A04D8877 ACTIV---X- A04D8878 ACTIV---X- A04D8879 ACTIV---X-
IST080I A04D887A ACTIV---X- A04D887B ACT/S---X- A04D887C ACT/S---X-
IST080I A04D887D ACT/S---X- A04D887E ACT/S---X- A04D887F ACT/S---X-
IST146I LINE NAME = J0004017, STATUS = ACTIV
IST359I ATTACHMENT = SWITCHED
IST089I A04P884 TYPE = PUT_2 , ACTIV---X-
IST355I LOGICAL UNITS:
IST080I A04D8841 ACTIV---X- A04D8842 ACT/S---X- A04D8843 ACT/S---X-
IST080I A04D8844 ACT/S---X- A04D8845 ACTIV---X- A04D8846 ACTIV---X-
IST080I A04D8847 ACTIV---X- A04D8848 ACTIV---X- A04D8849 ACTIV---X-
IST080I A04D884A ACTIV---X- A04D884B ACT/S---X- A04D884C ACT/S---X-
IST080I A04D884D ACT/S---X- A04D884E ACT/S---X- A04D884F ACT/S---X-
IST146I LINE NAME = J000401D, STATUS = ACTIV
IST359I ATTACHMENT = SWITCHED
IST089I A04P881 TYPE = PUT_2 , ACTIV---X-
IST355I LOGICAL UNITS:
IST080I A04D8811 ACTIV---X- A04D8812 ACT/S---X- A04D8813 ACTIV---X-
IST080I A04D8814 ACTIV---X- A04D8815 ACT/S---X- A04D8816 ACTIV---X-
IST080I A04D8817 ACTIV---X- A04D8818 ACTIV---X- A04D8819 ACTIV---X-
IST080I A04D881A ACTIV---X- A04D881B ACTIV---X- A04D881C ACTIV---X-
IST080I A04D881D ACT/S---X- A04D881E ACT/S---X- A04D881F ACTIV---X-
IST1454I 60 RESOURCE(S) DISPLAYED
IST314I ENDDisplaying terminals, limiting output
to three resources:
d net,terms,max=3
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = LOGICAL UNITS/TERMS
IST354I PU T4/5 MAJOR NODE = NCP3AA1
IST146I LINE NAME = LN3A1, STATUS = NEVAC
IST359I ATTACHMENT = LEASED
IST089I P3A3767A TYPE = PU_T1 , NEVAC
IST355I LOGICAL UNITS:
IST080I L3A3767A NEVAC
IST089I P3A3274A TYPE = PU_T2 , NEVAC
IST355I LOGICAL UNITS:
IST080I L3A3278A NEVAC L3A3279A NEVAC
IST1315I DISPLAY TRUNCATED AT MAX = 3
IST1454I 3 RESOURCE(S) DISPLAYED
IST314I END