DISPLAY CDRMS command


>>-DISPLAY-- --NET--,--CDRMS------------------------------------>

>--+----------------------------------+------------------------->
   |                              (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 CDRMS (cross-domain resource managers) command displays the status of active cross-domain resource manager (CDRM) major nodes and their subordinate minor nodes.

Note: To display cross-domain resource managers independently of the major nodes that contain them, use the DISPLAY RSCLIST command with IDTYPE=CDRMS.

Operands

ID=name

Specifies the name of one or more active CDRM major nodes whose subordinate resources 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 CDRM major node in the network.

MAX

Specifies the maximum number of CDRM minor nodes 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 CDRM minor nodes 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 CDRM program minor nodes are found than you have specified on MAX, VTAM displays only the CDRM minor nodes 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 CDRM minor nodes 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 CDRM minor nodes 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 CDRMs in pending or connectable states. If no CDRMs 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=ACTSESS: Specifies that information is to be displayed about all CDRM minor nodes 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 CDRM minor nodes (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 CDRM minor nodes in a CONCT (connectable) state within the specified major nodes (or within all major nodes if the ID operand is omitted). If no CDRMs 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=INACT: Specifies that information is to be displayed about all inactive CDRM minor nodes 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 CDRM minor nodes 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 CDRM minor nodes 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 CDRM minor nodes in a RESET state within the specified major nodes (or within all major nodes if the ID operand is omitted).

Resulting display

The resulting display shows:

The name and status of the specified active CDRM major nodes (or all active CDRM major nodes if the ID operand is omitted).
For each active CDRM major node:
- The name, status, subarea number, element address, and network identification is displayed for each minor node. This is limited to active, inactive, or pending minor nodes if specified on the SCOPE operand.
- The network address within the gateway NCP used for the cross-network SSCP-SSCP session is displayed if you are displaying a CDRM in another network.

Examples

Displaying all CDRM major nodes and their minor nodes:

d net,cdrms
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = CDRMS
IST089I CDRM1A   TYPE = CDRM SEGMENT     , ACTIV
IST1546I CDRM     STATUS    SUBAREA ELEMENT NETID    SSCPID
IST1547I SSCP1A    ACTIV          1      1  NETA          1
IST1547I SSCPAA    NEVAC         10      1  NETA        N/A
IST1547I SSCP2A    NEVAC          2      1  NETA        N/A
IST1547I SSCPBA    NEVAC         11      1  NETA        N/A
IST1547I SSCPCA    NEVAC         12      1  NETA        N/A
IST1547I SSCP7B    ACTIV          5      1  NETB          7
IST1547I SSCP9C    ACTIV          8      3  NETC          9
IST1454I 7 RESOURCE(S) DISPLAYED
IST314I END

Displaying a specific CDRM major node and its minor nodes:

d net,cdrms,id=cdrm1a
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = CDRMS
IST089I CDRM1A   TYPE = CDRM SEGMENT     , ACTIV
IST1546I CDRM     STATUS    SUBAREA ELEMENT NETID    SSCPID
IST1547I SSCP1A    ACTIV          1      1  NETA          1
IST1547I SSCPAA    NEVAC         10      1  NETA        N/A
IST1547I SSCP2A    NEVAC          2      1  NETA        N/A
IST1547I SSCPBA    NEVAC         11      1  NETA        N/A
IST1547I SSCPCA    NEVAC         12      1  NETA        N/A
IST1547I SSCP7B    ACTIV          5      1  NETB          7
IST1547I SSCP9C    ACTIV          8      3  NETC          9
IST1454I 7 RESOURCE(S) DISPLAYED
IST314I END

Displaying CDRM major nodes and their minor nodes, limiting output to five resources:

d net,cdrms,max=5
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = CDRMS
IST089I CDRM1A   TYPE = CDRM SEGMENT     , ACTIV
IST1546I CDRM     STATUS    SUBAREA ELEMENT NETID    SSCPID
IST1547I SSCP1A    ACTIV          1      1  NETA          1
IST1547I SSCPAA    NEVAC         10      1  NETA        N/A
IST1547I SSCP2A    NEVAC          2      1  NETA        N/A
IST1547I SSCPBA    NEVAC         11      1  NETA        N/A
IST1547I SSCPCA    NEVAC         12      1  NETA        N/A
IST1454I 5 RESOURCE(S) DISPLAYED
IST314I END