DISPLAY GROUPS 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 GROUPS command provides information about line groups.

Operands

ID=name

Specifies the name of one or more active NCP, channel-attachment, or XCA major nodes whose subordinate line groups 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 NCP, channel-attachment, and XCA major node in the network.

MAX

Specifies the maximum number of line groups 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 line groups 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 line groups are found than you have specified on MAX, VTAM displays only the line groups 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 line groups 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 line groups 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 line groups in pending or connectable states. If no line groups 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 line groups (regardless of status) within the specified major nodes (or within all NCP, channel-attachment, and XCA major nodes if the ID operand is omitted).

SCOPE=INACT

Specifies that information is to be displayed about all inactive line groups 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 line groups 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 line groups 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 line groups 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).

Resulting display

The resulting display lists the group's major node with its type and status, and the name, type, and status of each line group subordinate to the major node.