Previous Topic: VRM Device Control Functions - Definition StructureNext Topic: VRM Device Control Functions - Submission Control


VRM Device Control Functions - Definition Control

Definitions for VRM Devices can be entered manually using the RM.1 panel. However, we recommend that VRM devices be defined dynamically. Dynamic definition is indicated by VRMDD=D or VRMDD=Y on the OPTIONS statement in the initialization file. With dynamic VRM device definition, CA WA CA 7 Edition adds or deletes the resource count resource definitions that correspond to devices detected by SASSJJCL during the LOAD completion process.

The Database Load program (SASSJJCL) scans each DD statement in the job and extracts the device code and unit name information. The SASSDTAB table is used to determine which device code/unit name combinations are eligible to be considered VRM Devices. If no entry is found in SASSDTAB for the device code/unit name, no resource count resource is created for the device.

Entries in the SASSDTAB table are created using the L2VDD macro. Each entry declares a device code and unit name combination that is to be tracked using VRM device definitions.

SASSJJCL selects devices for dynamic definition based upon a scan of the SASSDTAB table from top to bottom. Thus, selection depends on the order of L2VDD macro statements. L2VDD requires a group name. The DEVICE and UNIT parameters are optional. The value of the DEVICE and UNIT parameters is considered fully qualified unless an asterisk (*) is coded. If the asterisk is coded, any value is considered eligible for dynamic definition.

The following example illustrates significant features of the SASSDTAB module:

                column
                10    16                                     72
                |     |                                      |
   SASSDTAB     CSECT
                SASSVRSN VRSN=DOC
   ENTRY1       L2VDD GROUP=SYSDISK,                         +
                      DEVICE=3033000E,                       +
                      UNIT=SYSDA
   *
   ENTRY2       L2VDD GROUP=ANYDISK,                         +
                      DEVICE=3033000F,                       +
                      UNIT=*
   *
   ENTRY3       L2VDD GROUP=SOME3380,                        +
                      DEVICE=*,                              +
                      UNIT=3380
   *
   ENTRY4       L2VDD GROUP=ANYUNIT,                         +
                      DEVICE=*,                              +
                      UNIT=*
   *
   ENTRY5       L2VDD GROUP=LAST
                END

CAL2OPTN includes a SASSDTAB sample in member AL2UM44.

L2VDD macro statements that include an asterisk are placed lower in the module. In this example, all devices detected with a device code of 3033000E and a UNIT name of SYSDA are selected for definition and associated with the group SYSDISK. ENTRY2 ensures that devices with a device code 3033000F are selected for definition regardless of UNIT name value. Such devices are placed in the ANYDISK group. A device that is not considered eligible according to the aforementioned criteria will be selected for definition if the UNIT name of 3380 is detected for it by SASSJJCL. It will be placed in the SOME3380 group. ENTRY4 in the table ensures that any device not already covered by a L2VDD entry will be selected for definition and placed in the ANYUNIT group.

L2VDD GROUP=LAST terminates the table and is required. LAST is a reserved group name.