DISPLAY RSCLIST command

Abbreviations

When using abbreviations in commands, code the abbreviation exactly as shown in the table. Do not use the operand name in the command unless it is shown as part of the abbreviation in the table. For example, when coding the abbreviation for SCOPE=ALL, use E or EVERY. SCOPE=E is not a valid option.

Purpose

The DISPLAY RSCLIST command displays information about resources whose names match a particular pattern.

Operands

EXCLUDE=name

Specifies a maximum of five names or patterns of resources to be excluded from the display. The names or patterns can be network-qualified. If you do not specify the network identifier, VTAM® uses the identifier of the host from which you are issuing the command.

You can specify wildcard values for this operand, but * and *.* are not valid for the list of resources to be excluded. For more information about using wildcards, see Using wildcard names.

ID=name

Specifies the name of one or more resources to be displayed. The resource name can be network qualified. If you do not specify the network identifier, VTAM uses the identifier of the host from which you are issuing the command. If the host network identifier is used, VTAM also displays resources with other network identifiers, if they are also known by the host network identifier.

You can specify * as the network ID portion of a network-qualified name. The * is useful for displaying information about a resource for which you do not know the network ID. The * is also useful for displaying information about several resources with the same name that are found in multiple networks, if you also specify the MAX operand on the command.

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.

Guideline: Specifying a wildcard name, IDTYPE=*, SCOPE=ALL, or SCOPE=RESET might degrade performance because VTAM checks every network resource known to this VTAM, unless limited by the MAJNODE operand.

Note: If model application program definition names match the pattern you specify on the ID operand of the DISPLAY RSCLIST command when IDTYPE specifies an asterisk (*) or APPLS, those model application program names appear in your display output. In addition, any dynamic application programs built from those model application program definitions also appear in your display output.

If model CDRSC definition names match the pattern you specify on the ID operand when IDTYPE specifies an asterisk (*) or CDRSCS, those model CDRSCs appear in your display output. In addition, any clone CDRSCs built from those model CDRSCs also appear in your display output.

A model application program will be identified in the TYPE column of message IST1418I as MODEL APPL. A dynamic application program will be identified in the TYPE column of message IST1418I as DYNAMIC APPL. A model CDRSC will be identified in the TYPE column of message IST1418I as MODEL CDRSC. A clone CDRSC will be identified in the TYPE column of message IST1418I as CLONE CDRSC.

For example, if you issue the following command:

DISPLAY NET,RSCLIST,ID=APPL*,IDTYPE=*

and model resources (APPLs or CDRSCs) have been defined using names that match the pattern specified on the ID operand (APPL*), you will get the following output:

IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID    NAME     STATUS     TYPE              MAJNODE
IST1418I NETA     APPLA*   ACTIV      MODEL CDRSC       CDRSC1A
IST1418I NETA     APPLQ?   CONCT      MODEL APPL        APPL1A
IST1418I NETA     APPL1    ACT/S      APPL              APPL1A
IST1418I NETA     APPLA01  ACTIV      CLONE CDRSC       CDRSC1A
IST1418I NETA     APPLQ1   ACTIV      DYNAMIC APPL      APPL1A
IST1454I 5 RESOURCE(S) DISPLAYED FOR ID=APPL*
IST314I END

The wildcard character used in APPL* on the ID operand of the DISPLAY RSCLIST command tells VTAM to display any resource whose name begins with APPL, followed by zero to four valid characters. The names APPLA* and APPLQ?, even though they contain wildcard characters, both begin with APPL, followed by zero to four valid characters [an asterisk (*) and a question mark (?) are valid characters in an application program minor node name and in a CDRSC minor node name]. Therefore, they are included in the display output, as are the clone CDRSC, APPLA01, which was built from APPLA*, and the dynamic application program, APPLQ1, which was built from APPLQ?.

Tip: To limit the display to model application program definitions, specify IDTYPE=APPLMOD when you issue the DISPLAY RSCLIST command. To limit the display to dynamic application programs, specify IDTYPE=APPLDYN or IDTYPE=APPLCLN when you issue the DISPLAY RSCLIST command. To limit the display to model CDRSCs, specify IDTYPE=CDRSCMOD when you issue the DISPLAY RSCLIST command. To limit the display to clone CDRSCs, specify IDTYPE=CDRSCCLN when you issue the DISPLAY RSCLIST command.

IDTYPE

Specifies the type of resource 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=ADJCPS

Displays only adjacent control points.

IDTYPE=ADJCPSEG

Displays only adjacent control point major nodes.

IDTYPE=APPLCLN

Displays only dynamic (clone) application programs. (IDTYPE=APPLCLN is synonymous with IDTYPE=APPLDYN.)

IDTYPE=APPLDYN

Displays only dynamic (clone) application programs. (IDTYPE=APPLDYN is synonymous with IDTYPE=APPLCLN.)

IDTYPE=APPLMOD

Displays only model application programs.

IDTYPE=APPLS

Displays only application minor nodes, including model application program definitions and dynamic application programs.

IDTYPE=APPLSEG

Displays only application major nodes.

IDTYPE=CDRMS

Displays only cross-domain resource managers known to this host processor.

IDTYPE=CDRMSEG

Displays only CDRM major nodes.

IDTYPE=CDRSCCLN

Displays only clone cross-domain resources known to this domain.

IDTYPE=CDRSCMOD

Displays only model cross-domain resources known to this domain.

IDTYPE=CDRSCS

Displays only cross-domain resources known to this domain.

IDTYPE=CDRSCSEG

Displays only CDRSC major nodes.

IDTYPE=CLSTRS

Displays only physical units in this domain.

IDTYPE=DLURS

Displays only dependent LU requesters (DLURs).

IDTYPE=GENERIC

Displays only generic resources.

GENERIC USERVAR in the TYPE column of message IST1418I indicates that a USERVAR representation of the generic resource exists locally on the host where the display was issued. You can use this information to determine whether you should issue a MODIFY GR,OPTION=DELETE command on a given host when trying to delete a generic resource from the sysplex.

IDTYPE=GROUPS

Displays only groups in this domain.

IDTYPE=LCLSNA

Displays only local SNA major nodes.

IDTYPE=LCL3270

Displays only local non-SNA major nodes.

IDTYPE=LINES

Displays only lines in this domain.

IDTYPE=LINKSTA

Displays link stations only in this domain.

IDTYPE=LUGROUPS

Displays only LU group major nodes.

IDTYPE=MAJNODES

Displays only major nodes.

IDTYPE=MODELSEG

Displays only model major nodes.

IDTYPE=PUT45

Displays only type 4 and type 5 PUs.

IDTYPE=SWSEG

Displays only switched major nodes.

IDTYPE=TERMS

Displays only logical units.

IDTYPE=TRLSEG

Displays only the transport resource list (TRL) major node.

IDTYPE=XCASEG

Displays only external communication adapter (XCA) major nodes.

IDTYPE=*

Displays all resources, including model application program definitions and dynamic application programs.

MAJNODE=nodename

Specifies the name of the major node to be searched for resources matching the ID operand. The nodename cannot be a network-qualified name.

You can specify a wildcard value for the MAJNODE operand. For more information about using wildcards, see Using wildcard names.

MAX

Specifies the maximum number of resources 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 resources 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 resources are found than you have specified on MAX, VTAM displays only the resources 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 resources. 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 resources in an active state. The display does not include resources in pending or connectable states. If no resources are found in an active state, you can use SCOPE=ACT to broaden the scope of the display to active, connectable, and pending resources.

SCOPE=ACTSESS

Specifies that information is to be displayed about all resources that are active with sessions.

SCOPE=ALL

Specifies that information is to be displayed about all resources (regardless of their status).

SCOPE=CONCT

Specifies that information is to be displayed about all resources in a CONCT (connectable) state. If no applications are found in a connectable state, you can use SCOPE=ACT to broaden the scope of the display to active, connectable, and pending resources.

SCOPE=INACT

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

SCOPE=RESET

Specifies that information is to be displayed about all resources in a RESET state.

Resulting display