DISPLAY RSCLIST command
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=RELSD | RELSD |
SCOPE=RESET | RESET |
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:
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:DISPLAY NET,RSCLIST,ID=APPL*,IDTYPE=*
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
- The NETID and name of each resource that matches the pattern specified on the ID operand and the status specified on the SCOPE operand
- The current resource status
- The resource type
- The name of the major node where the resource is defined
- If model application program definitions are included in the display, any dynamic application programs built from those models that have been deactivated are not displayed. This is because dynamic application programs cannot exist in an inactive state. When a dynamic application program is deactivated and CLOSE macro processing is complete for the dynamic application program, the definition of the dynamic application program is deleted. The dynamic application program is no longer known by VTAM and will not appear in the output of any DISPLAY commands.
- If model CDRSCs are included in the display, any clone CDRSCs that were built from those models that have been deleted are not displayed. Clone CDRSCs can exist in the inactive state, but whether they do or not is governed by the value of the DELETE operand that was on the model CDRSC at the time of the deactivation of the clone CDRSC or the value of the DELETE parameter that was on the VARY INACT operator command.
Examples
app, including dynamic application programs built from model application program definitions. Model application programs do not appear in the display output because they are always in a connectable (CONCT) state.
d net,rsclist,id=app*,scope=actonly
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID NAME STATUS TYPE MAJNODE
IST1418I NETA APPLAA3 ACTIV CDRSC ISTPDILU
IST1418I NETA APPLAA2 ACTIV CDRSC ISTPDILU
IST1418I NETA APPLCA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPLBA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPLDA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPL1A ACTIV APPL SEGMENT APPL1A
IST1418I NETA APPL1 ACT/S APPL APPL1A
IST1418I NETA APPL8 ACTIV--S-- CDRSC CDRSC1A
IST1418I NETA APPLAA1 ACTIV CDRSC CDRSC1A
IST1418I NETA APPLA01 ACTIV DYNAMIC APPL APPL1A
IST1418I NETA APPLQ1 ACTIV DYNAMIC APPL APPL1A
IST1454I 11 RESOURCE(S) DISPLAYED FOR ID=APP*
IST314I END
d net,rsclist,id=app*,scope=act
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID NAME STATUS TYPE MAJNODE
IST1418I NETA APPLAA3 ACTIV CDRSC ISTPDILU
IST1418I NETA APPLAA2 ACTIV CDRSC ISTPDILU
IST1418I NETA APPLCA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPLBA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPLDA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPL1A ACTIV APPL SEGMENT APPL1A
IST1418I NETA APPLA* CONCT MODEL APPL APPL1A
IST1418I NETA APPLQ? CONCT MODEL APPL APPL1A
IST1418I NETA APPL1 ACT/S APPL APPL1A
IST1418I NETA APPLQ1 ACTIV DYNAMIC APPL APPL1A
IST1418I NETA APPLA01 ACTIV DYNAMIC APPL APPL1A
IST1418I NETA APPLAA* ACTIV MODEL CDRSC CDRSC1A
IST1418I NETA APPLAA1 ACTIV CLONE CDRSC CDRSC1A
IST1454I 13 RESOURCE(S) DISPLAYED FOR ID=APP*
IST314I END
d net,rsclist,id=applb*,idtype=cdrscmod
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID NAME STATUS TYPE MAJNODE
IST1418I NETB APPLB* ACTIV MODEL CDRSC CDRSC1A
IST1454I 1 RESOURCE(S) DISPLAYED FOR ID=APPLB*
IST314I END
d net,rsclist,id=applb*,idtype=cdrsccln
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID NAME STATUS TYPE MAJNODE
IST1418I NETB APPLB12 ACTIV CLONE CDRSC CDRSC1A
IST1454I 1 RESOURCE(S) DISPLAYED FOR ID=APPLB*
IST314I END
app:
d net,rsclist,id=app*,idtype=applmod,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1418I NETA APPLA* CONCT MODEL APPL APPL1A
IST1418I NETA APPLQ? CONCT MODEL APPL APPL1A
IST1454I 2 RESOURCE(S) DISPLAYED FOR ID=APP*
IST314I END
app:
d net,rsclist,id=app*,idtype=appldyn,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1418I NETA APPLQ1 ACTIV DYNAMIC APPL APPL1A
IST1418I NETA APPLA01 ACTIV DYNAMIC APPL APPL1A
IST1454I 2 RESOURCE(S) DISPLAYED FOR ID=APP*
IST314I END
app, limiting output to six resources:
d net,rsclist,id=app*,max=6
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID NAME STATUS TYPE MAJNODE
IST1418I NETA APPLAA3 ACTIV CDRSC ISTPDILU
IST1418I NETA APPLAA2 ACTIV CDRSC ISTPDILU
IST1418I NETA APPLCA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPLBA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPLDA1 ACT/S----Y CDRSC ISTCDRDY
IST1418I NETA APPL1A ACTIV APPL SEGMENT APPL1A
IST1315I DISPLAY TRUNCATED AT MAX = 6
IST1454I 6 RESOURCE(S) DISPLAYED FOR ID=APP*
IST314I END
d net,rsclist,id=cnr*
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID NAME STATUS TYPE MAJNODE
IST1418I NETA CNR00004 ACTIV--LX- PU_T2.1 ISTRTPMN
IST1418I NETA CNR00003 ACTIV--LX- PU_T2.1 ISTRTPMN
IST1418I NETA CNR00002 ACTIV--LX- PU_T2.1 ISTRTPMN
IST1418I NETA CNR00001 ACTIV--LX- PU_T2.1 ISTRTPMN
IST1454I 4 RESOURCE(S) DISPLAYED FOR ID=CNR*
IST314I END
d net,rsclist,id=*,idtype=generic
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = RSCLIST
IST1417I NETID NAME STATUS TYPE MAJNODE
IST1418I NETA GRAPPL INACT GENERIC RESOURCE **NA**
IST1418I NETA GRAPPL *NA* GENERIC USERVAR **NA**
IST1418I NETA GRCICS ACT/S GENERIC RESOURCE **NA**
IST1418I NETA GRIMS ACTIV GENERIC RESOURCE **NA**
IST1454I 4 RESOURCE(S) DISPLAYED FOR ID=*
IST314I END