Installation and Maintenance Utilities › ACFRGP - Grouping Resources

ACFRGP - Grouping Resources

The Resource Grouping utility provides a list of resource group names that a specified resource belongs to. Examples of resources include DIAL, autologon, and group logon validations.

Place resources with the same access requirements together so that only one resource rule is required. Resources can belong to more than one group, and groups can belong to other groups.

ACFRGP searches an in-storage structure record that a cache of the cross‑reference (XREF) resource group records created, and an index of those records, to find the resource group names. The utility prints the resource group names in the order that resource validation takes place (that is, from most specific to least specific). If the structure of the groups has changed and a current configuration is required, you must restart CA ACF2 for z/VM or refresh the XREF records with the ACFSERVE RELOAD XREF RGP command. Since this utility depends on the internal structure CA ACF2 for z/VM creates, run it when CA ACF2 for z/VM is active.

See the cross-reference chapter in the Administrator Guide for more information about resource grouping.

Files

SYSPRINT

Directs output to your terminal (the default), printer, or a minidisk file. See Defining Report Files in “The Reports” chapter for more information about this file.

Running ACFRGP

Enter the ACFRGP command on the command line. The syntax is:

ACFRGP RESOURCE(resourcename) TYPE(type)

RESOURCE(resourcename)

Specifies the 1- to 40-character resource name that identifies the resource protected. This field is not maskable for this utility.

TYPE(type)

Specifies a three-character resource rule set type. CA ACF2 for z/VM selects the resource groups that contain the resource of this type. For example, if you specify DIA for TYPE in this utility, CA ACF2 for z/VM lists only the resource groups of type DIA for DIAL validations.

Example

The following example shows how the ACFRGP utility is executed:

FILEDEF SYSPRINT DISK=,
ACFGRP TYPE(DIA) RESOURCE(VSE)

Sample Output

The following report shows sample output that ACFRGP generates:

RESOURCE GROUPING UTILITY
 
TYPE: DIA     RESOURCE: VSE
 
RESOURCE GROUP NAMES:
                    TEST21
                    TEST2
                    TEST1
                    TEST31
                    TEST3
                    TEST222
                    TEST23
                    TEST41
                    TEST4
                    TEST32
 
*** END OF XREF RESOURCE GROUP LIST ***