Data Set Group definitions reside in the GDEFS member of PARMLIB. Use the statements shown below, in the Example of GDEF member, to define a group. Only one statement is allowed for providing the group's authorized capacity (quota), another statement for providing its description (part A), and another for extending the description (part B).
If a group definition statement contains the keyword parameter FLTDTOC=fltDtoc, it defines a primary group (the identified data sets reside on primary storage). Such a statement is not required, but if present, the fltDtoc value must be a member name in the external filter library that filters the DTOC (object=DTOC4SYS) records.
If a group definition statement contains the keyword parameter FLTMCDS=fltMcds, FLTBCDS=fltBcds, or FLTDISK=fltDisk, it defines a secondary group (the identified data sets reside on secondary storage). The fltMcds value must be a member name in the external filter library that filters the DFSMShsm MCDS Data Set Records (object=HSMCD). Similarly, the fltBcds value must be a member name that filters the DFSMShsm Backup Version Records (object=HSMCC), and the fltDisk value must be a member name that filters the CA Disk Dsnindex Records (object=DMSINDEX). Only one statement is allowed for the FLTMCDS, only one additional statement for the FLTBCDS, and only one more for the FLTDISK. None are required.
If a group definition statement contains the keyword parameter FLTCCA1=fltCA1, FLTTLMS=fltTlms, FLTRRMM=fltRmm or FLTZARA=fltZara, it defines a tape group (the identified data sets reside on tape storage). The fltCA1 value must be a member name in the external filter library that filters the CA 1 Files Records (object=VISTMCD). The fltTlms value must be a member name that filters the CA TLMS Files Records (object=VISTLMSF), the fltRmm value must be a member name that filters the DFSMSrmm Files Records (object=VISRMMF), and the fltZara value must be a member name that filters the ASG-Zara Files Records (object=VISZDSNB). Only one statement is allowed for the FLTCCA1, only one additional statement for the FLTTLMS, only one additional statement for the FLTRRMM, and only one more for the FLTZARA. None of these are required.
Note: For additional information, see topics External Filters and Filter Syntax Rules.
As just explained, the GDEFS member itself does not contain the actual filter statements, but only refers to the appropriate filter members in the external filter library. The following seven statements are the maximum that can be used to define a group. Only the first is required. However, at least one of the statements identifying a filter member must be present in order to find the group's data sets and calculate group statistics.
Example of GDEF member:
GNAME=group1name,AUTHCAP=nnnnnnnnnnnnnnn Authorized capacity (quota) in bytes. GNAME=group1name,DESA=free text a Part A of its description (optional). GNAME=group1name,DESB=free text b Part B of its description (optional). GNAME=group1name,FLTDTOC=fltDtoc External filter member name for object=DTOC4SYS. GNAME=group1name,FLTMCDS=fltMcds External filter member name for object=HSMCD. GNAME=group1name,FLTBCDS=fltBcds External filter member name for object=HSMCC. GNAME=group1name,FLTDISK=fltDisk External filter member name for object=DMSINDEX. GNAME=group1name,FLTCCA1=fltCa1 External filter member name for object=VISTMCD. GNAME=group1name,FLTTLMS=fltTlms External filter member name for object=VISTLMSF. GNAME=group1name,FLTRRMM=fltRmm External filter member name for object=VISRMMF. GNAME=group1name,FLTZARA=fltZara External filter member name for object=VISZDSNB.
If no groups in GDEFS are defined using an FLTMCDS filter, or if system parameter EXTRMCDS is N, the MCDS records are not read, and the total and unassigned groups will not be updated with the MCDS information. In the same way, if no groups are defined using an FLTBCDS filter, or if system parameter EXTRBCDS is N, the BCDS Backup Version records are not read, and the total and unassigned groups are not updated with BCDS information. Also, if no groups are defined using an FLTDISK filter, or if system parameter EXTRDISK is N, the CA Disk Dsnindex Records are not read, and the total and unassigned groups will not be updated with CA Disk Dsnindex information.
If no groups in GDEFS are defined using an FLTCCA1 filter, the CA 1 Files records are not read, and the total and unassigned groups will not be updated with the CA 1 Files information. In the same way, if no groups are defined using an FLTTLMS filter, the CA TLMS Files records are not read, and the total and unassigned groups are not updated with CA TLMS information. The same applies to DFSMSrmm and ASG-Zara.
The special groups for totals and unassigned data sets are also defined as groups in the GDEFS member, but without any filter statements. The data sets in these groups are determined automatically.
If group UNASSIGNDP is defined in GDEFS like in the following model, it will contain (represent) the unassigned data sets on Primary Storage, that is, all the data sets not assigned to other primary groups.
GNAME=UNASSIGNDP,AUTHCAP=nnnnnnnnnnnnnnn GNAME=UNASSIGNDP,DESA=free text a GNAME=UNASSIGNDP,DESB=free text b
If group ZTOTSYSTMP is defined in GDEFS like in the following model, it will contain (represent) the totals for all data sets on Primary Storage.
GNAME=ZTOTSYSTMP,AUTHCAP=nnnnnnnnnnnnnnn GNAME=ZTOTSYSTMP,DESA=free text a GNAME=ZTOTSYSTMP,DESB=free text b
If group UNASSIGNDS is defined in GDEFS like in the following model, it will contain (represent) the unassigned data sets on Secondary Storage, that is, all the data sets not assigned to other secondary groups.
GNAME=UNASSIGNDS,AUTHCAP=nnnnnnnnnnnnnnn GNAME=UNASSIGNDS,DESA=free text a GNAME=UNASSIGNDS,DESB=free text b
If group ZTOTSYSTMS is defined in GDEFS like in the following model, it will contain (represent) the totals for all data sets on Secondary Storage.
GNAME=ZTOTSYSTMS,AUTHCAP=nnnnnnnnnnnnnnn GNAME=ZTOTSYSTMS,DESA=free text a GNAME=ZTOTSYSTMS,DESB=free text b
If group UNASSIGNDT is defined in GDEFS like in the following model, it will contain (represent) the unassigned data sets on Tape Storage, that is, all the data sets not assigned to other tape groups.
GNAME=UNASSIGNDT,AUTHCAP=nnnnnnnnnnnnnnn GNAME=UNASSIGNDT,DESA=free text a GNAME=UNASSIGNDT,DESB=free text b
If group ZTOTSYSTMT is defined in GDEFS like in the following model, it will contain (represent) the totals for all data sets on Tape Storage.
GNAME=ZTOTSYSTMT,AUTHCAP=nnnnnnnnnnnnnnn GNAME=ZTOTSYSTMT,DESA=free text a GNAME=ZTOTSYSTMT,DESB=free text b
Analysis of the unassigned groups allows you to quickly determine whether the definitions for the other groups are as accurate or complete as they need to be. If they are not, the group definitions can be updated, and then the unassigned groups can be examined again, repeating the process as needed.
Note: The Group Definitions within the GDEFS member do not have to be sorted in alphanumeric order. All the statements for a specific group should be together, but they can be placed anywhere within the GDEFS member. For performance reasons, you should define the largest groups first (place those groups with the highest number of data sets at the top of the GDEFS member), and set system parameters GRPOVLAP, EXTOVLAP, and TAPOVLAP to N. This arrangement means that the minimum number of group filters will be executed to find the group to which each data set belongs. This saves CPU and elapsed time.
|
Copyright © 2014 CA.
All rights reserved.
|
|