Basic System DMS PROC › DFSMS and DSCL › Additional Select Parameter › SGNAME=

SGNAME=

This parameter is only valid when IBM's Storage Management Subsystem (SMS) is active on the system. It allows selection at the DFSMS storage group level. Volumes and/or data sets will be selected for processing based on whether or not their volser belongs to a particular storage group name specified in the SGNAME= parameter.

For example, SELECT SGNAME=(SGLARGE,SG1/) would select all volumes and/or data sets that reside on the volumes, in the storage group of SGLARGE and in storage group names matching the pattern name of SG1/.

There are four DSCL SELECT command volume-oriented parameters. They are VOLUMES=, UNIT=, VAMPOOL=, and SGNAME=, which are each mutually exclusive. This means that SGNAME= cannot be specified with VOLUMES=, UNIT=, or VAMPOOL= on the same SELECT statement. On each SELECT statement, you can specify up to 22 DFSMS storage group names or DFSMS storage group name patterns.

You can add the DSNAMES=, COMPONENTS, TABLE=, VTOCS, CATALOGS= or CRITERIA= parameters on the same SELECT statement.

An example of how to use this parameter is as follows:

SCAN REALVOLS

SELECT SGNAME=(LARGE,SMALL),CRI=(DSORG,EQ,AM)
BACKUP

The previous example accomplishes an incremental and guaranteed backup of VSAM clusters in an SMS environment. CA Disk will scan the VTOC's of the SMS storage groups called LARGE and SMALL and will back up the clusters which have the change bit turned on, or which meet the criteria for guaranteed backup. The SMS information for each cluster will be used as criteria when determining whether the cluster will be backed up or not.