DISPLAY LUGROUPS command


Display all LUGROUP major nodes:

>>-DISPLAY-- --NET--,--LUGROUPS--------------------------------->

   .-,--SCOPE--=--ONLY------------------------------------------------.   
>--+------------------------------------------------------------------+-><
   '-,--SCOPE--=--+-ONLY--------------------------------------------+-'   
                  |      .-,--MAX--=--DSPLYDEF_start_option_value-. |     
                  '-ALL--+----------------------------------------+-'     
                         '-,--MAX--=--+-*-------------------+-----'       
                                      '-number_of_resources-'


Display a specific LUGROUP major node:

>>-DISPLAY-- --NET--,--LUGROUPS--------------------------------->

>--,--ID--=--lugroup_major_node_name---------------------------->

   .-,--SCOPE--=--ONLY------------------------------------------------.   
>--+------------------------------------------------------------------+-><
   '-,--SCOPE--=--+-ONLY--------------------------------------------+-'   
                  |      .-,--MAX--=--DSPLYDEF_start_option_value-. |     
                  '-ALL--+----------------------------------------+-'     
                         '-,--MAX--=--+-*-------------------+-----'       
                                      '-number_of_resources-'


Display a model LU group:

>>-DISPLAY-- --NET--,--LUGROUPS--,--ID--=--model_lu_group------->

   .-,--SCOPE--=--ONLY------------------------------------------------.   
>--+------------------------------------------------------------------+-><
   '-,--SCOPE--=--+-ONLY--------------------------------------------+-'   
                  |      .-,--MAX--=--DSPLYDEF_start_option_value-. |     
                  '-ALL--+----------------------------------------+-'     
                         '-,--MAX--=--+-*-------------------+-----'       
                                      '-number_of_resources-'


Display a model LU:

>>-DISPLAY-- --NET--,--LUGROUPS--,--ID--=--model_lu_name-------->

>--,--GROUP--=--model_lu_group---------------------------------->

   .-,--SCOPE--=--ONLY------------------------------------------------.   
>--+------------------------------------------------------------------+-><
   '-,--SCOPE--=--+-ONLY--------------------------------------------+-'   
                  |      .-,--MAX--=--DSPLYDEF_start_option_value-. |     
                  '-ALL--+----------------------------------------+-'     
                         '-,--MAX--=--+-*-------------------+-----'       
                                      '-number_of_resources-'

Abbreviations

Operand	Abbreviation
DISPLAY	D
SCOPE=ALL	EVERY or E
SCOPE=ONLY	NONE or N

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 LUGROUPS (logical unit groups) command provides information about LUGROUP major nodes, model LU groups, and specific model LUs within an LU group.

Operands

GROUP=model_lu_group

Specifies the name of a model LU group. This operand is valid only if the ID operand specifies a model LU. It is required if the ID operand specifies a model LU to indicate which model LU group to search. Because two different model LU groups can contain model LUs with the same name, this specification of which model LU group to search is necessary.

ID=name

Specifies one of the following names:

LUGROUP major node name
Model LU group name
Model LU name

MAX

Specifies the maximum number of resources that VTAM® displays for this command.

The MAX operand is valid only when SCOPE=ALL is specified.

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

SCOPE

Specifies what LUGROUP resources are displayed. The results depend on whether an ID is specified and whether SCOPE is specified as ONLY or ALL.

SCOPE=ALL: Specifies that the requested node and all its subordinate nodes be displayed.
SCOPE=ONLY: Specifies that only the requested nodes be displayed.

Resulting display

The resulting VTAM display shows:

If ID is not specified:
- For SCOPE=ONLY, all LUGROUP major nodes
- For SCOPE=ALL, all LUGROUP major nodes, their model LU groups, and their model LUs
If ID specifies an LUGROUP major node:
- For SCOPE=ONLY, each of the LU groups within the specified LUGROUP major node
- For SCOPE=ALL, the specified LUGROUP major node, its model LU groups, and their model LUs
If ID specifies a model LU group:
- For SCOPE=ONLY, the specified model LU group, verifying that it is active
- For SCOPE=ALL, the specified model LU group and its model LUs
If ID specifies a model LU and GROUP specifies a model LU group:
- For SCOPE=ONLY, the specified model LU, verifying that it exists within the specified model LU group
- For SCOPE=ALL, the characteristics of the specified model LU

Examples

Displaying all LU groups:

d net,lugroups,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = LUGROUP MAJOR NODES
IST1060I LUGROUP MAJOR NODE = LUGRP50
IST075I NAME = LARRY, TYPE = MODEL LU GROUP
IST355I LOGICAL UNITS:
IST080I 3194@00             3194000             @@90001
IST080I 329000@             327@@01             9373@
IST080I 9375@               3270@               @
IST075I NAME = CURLY, TYPE = MODEL LU GROUP
IST355I LOGICAL UNITS:
IST080I 3194@               3290@               3270001
IST080I 3270@               @
IST075I NAME = MOE, TYPE = MODEL LU GROUP
IST355I LOGICAL UNITS:
IST080I 3194@               3290@               3270001
IST080I 3270@               @
IST1454I 19 RESOURCE(S) DISPLAYED
IST314I END

Displaying a specific LUGROUP major node:

d net,lugroups,id=lugrp50
IST097I DISPLAY ACCEPTED
IST1060I LUGROUP MAJOR NODE = LUGRP50
IST075I NAME = LARRY, TYPE = MODEL LU GROUP
IST075I NAME = CURLY, TYPE = MODEL LU GROUP
IST075I NAME = MOE, TYPE = MODEL LU GROUP
IST314I END

Displaying a model LU group:

d net,lugroups,id=larry,scope=all
IST097I DISPLAY ACCEPTED
IST075I NAME = LARRY, TYPE = MODEL LU GROUP
IST355I LOGICAL UNITS:
IST080I 3194@00             3194000             @@90001
IST080I 329000@             327@@01             9373@
IST080I 9375@               3270@               @
IST1454I 9 RESOURCE(S) DISPLAYED
IST314I END

Displaying a specific LU in a lugroup major node:

d net,lugroups,id=3194@00,group=larry,scope=all
IST097I DISPLAY ACCEPTED
IST075I NAME = NETA.3194@00, TYPE = MODEL LU
IST977I MDLTAB=***NA*** ASLTAB=***NA***
IST861I MODETAB=***NA*** USSTAB=***NA*** LOGTAB=***NA***
IST934I DLOGMOD=***NA*** USS LANGTAB=***NA***
IST228I ENCRYPTION = NONE, TYPE = DES
IST1563I CKEYNAME = 3194@00 CKEY = PRIMARY CERTIFY = NO
IST1552I MAC = NONE MACTYPE = NONE
IST314I END