DISPLAY CLSTRS command

Abbreviations

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 CLSTRS (clusters) command displays the status of physical units (PUs) subordinate to an NCP node, a local SNA node, or a switched subarea node.

Operands

ID=name

Specifies the name of one or more active NCP, local SNA, or switched major nodes whose subordinate PUs 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.

Attention: Specifying a wildcard name might degrade performance because VTAM® checks every NCP, local SNA, and switched major node in the network.

IDTYPE

Specifies the type of major node that the ID operand names. If several types of resources share the same name, IDTYPE can be used to identify which resource the command should act on. The default is IDTYPE=*.

IDTYPE=LCLSNA

Displays only the subordinate PUs defined in local SNA major nodes.

IDTYPE=PUT45

Displays only the subordinate PUs defined in PU type 4 and PU type 5 major nodes.

IDTYPE=SWSEG

Displays only the subordinate PUs defined in switched major nodes.

IDTYPE=*

Displays the subordinate PUs defined in NCP major nodes, local SNA major nodes, and switched major nodes.

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 PUs to display 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 PUs are found than you have specified on MAX, VTAM displays only the PUs that are found.

OWNER

Specifies whether PUs 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 PUs whose owning SSCP (as determined by the OWNER operand on the GROUP, LINE, or PU definition statements) matches the host_name specified are to be displayed.

OWNER=*NONE

Specifies that only PUs without an OWNER operand on the GROUP, LINE, or PU 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 PUs within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted). The information is displayed for the major node as well. 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 PUs in an active state within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted). The display does not include PUs in pending or connectable states. If no PUs 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 PUs (regardless of status) within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted). The information is displayed for the major node as well.

SCOPE=CONCT

Specifies that information is to be displayed about all PUs in a CONCT (connectable) state within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted). If no PUs 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=IACTIVE

Specifies that information is to be displayed about all PUs within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted) for which the minor node is ISTATUS=INACTIVE.

SCOPE=IINACT

Specifies that information is to be displayed about all PUs within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted) for which the minor node is ISTATUS=ACTIVE.

SCOPE=INACT

Specifies that information is to be displayed about all inactive PUs within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted). The information is displayed for the major node as well. 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 PUs 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 PUs within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted). 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 all PUs in a RESET state within the specified major nodes (or within all NCP, local SNA, and switched major nodes if the ID operand is omitted).

Resulting display