Volume Backup SELECT, EXCLUDE, and MOUNT Statements

SELECT and EXCLUDE statements syntax

SELECT and EXCLUDE statements

These statements select additional data sets to be backed up. They are ignored for full-volume backups except for EXCLUDE ALLDSN statements used to exclude whole volumes. For incremental backups (DUMP TYPE=ABR or AUTO) data sets to be backed up are selected by the rules in Data Set Selection and SELECT statements are normally not required. However, you may use SELECT statements to include data sets that would not normally be included in an incremental backup. For DUMP TYPE=DSF, SELECT statements are required to identify the data sets to be included.

A SELECT statement identifies an individual data set or group of data sets to be processed. ABR looks for these data sets on every volume processed unless the VOL= or VOLG= operand is included; if CATDSN= is used, only the volume identified from the z/OS catalogs is checked for the data sets.

An EXCLUDE statement identifies data sets from within those selected by SELECT statements that are not to be processed; it can also be used to exclude data sets that would otherwise be included in an incremental backup by the rules in Data Set Selection.

One and only one DSN=, CATDSN=, DD=, or ALLDSN operand must be specified on each SELECT or EXCLUDE Statement.

All data sets in the VTOCs of DASD volumes processed by ABR are compared to these statements to identify those to be processed; each data set is compared to each control statement until a match is found. It must match all criteria specified on the statement to qualify, for example, if DSN= and DSORG= are both specified, it must be a data set with the right name, having the indicated organization. A maximum of 100 of these control statements may be used in one execution unless overridden by MAXCARDS=.

The control statements are always scanned in the order in which they were input, so in general, EXCLUDE statements should precede SELECT statements. Since ABR only dumps data sets that are selected, EXCLUDE statements can be used to exclude certain data sets from within a larger group on a SELECT statement.

Example 1: Select all data sets with a first index of “A” except those with a second index of “B”:

EXCLUDE DSN=A.B.** 
SELECT  DSN=A.**

Example 2: Select all data sets except partitioned (PDSs):

EXCLUDE ALLDSN,DSORG=PO 
SELECT  ALLDSN

You can also use an EXCLUDE ALLDSN statement with VOL= or VOLG= to specify entire volumes that are not to be processed by ABR. This works even with full-volume backups. This is a way to exclude certain volumes that would otherwise be selected by the ONLINE or ONLVOL operands or MOUNT statements.

MOUNT statement syntax

You can also use an EXCLUDE ALLDSN statement with VOL= or VOLG= to specify entire volumes that are not to be processed by ABR. This works even with full-volume backups. This is a way to exclude certain volumes that would otherwise be selected by the ONLINE or ONLVOL operands or MOUNT statements.

MOUNT statement

The MOUNT statement is used to specify additional volumes to be processed by ABR. VOL=, VOLG=, or STORGRP= must be specified. STORGRP= selects all volumes in the specified SMS storage group. MOUNT statements must follow SELECT and EXCLUDE statements, if any.

When used with FDRINSTANT, following a SNAP, CONSNAP, PSPLIT, CONPSPLIT, FCOPY, or CONFCOPY statement, the MOUNT statement is used to identify the offline target device on which FDRINSTANT is to create the frozen point-in-time image of the online volume.

Dumping VSAM files

VSAM clusters can be selected by specifying the fully-qualified base cluster name or matching on the base cluster with generic data set selection. When selected, all components of that cluster that exist on the volumes being processed are dumped or printed, including Alternate Indexes (AIXs) and key range components. ABR does not examine VSAM component names when processing SELECT and EXCLUDE statements; components are selected only if their cluster name is selected. For further information, see VSAM Special Considerations.

SELECT, EXCLUDE, and MOUNT statement operands

DSN=

Specifies a fully-qualified data set name or a filter used for generic data set selection, as described in Generic Data Set Name Selection. This name or filter is used when scanning the VTOCs of selected volumes. For VSAM clusters, only the cluster name is compared; you cannot select by component name. For example:

DSN=USER1.JCL.CNTL

DSN=**LIST

DSN=PROD++.**.LIB*

DSN= cannot select GDGs by relative generation number; use DD= for that purpose.

CATDSN=

Specifies a fully-qualified data set name or a filter to be used for generic data set selection from system catalogs, as described in Generic Data Set Name Selection.

If a fully-qualified name is specified, that name is located in the system catalogs, and the volume serials from the catalog become an implied VOL= operand (specify the ONLVOL operand so that those volumes are automatically added to the ABR volume list for processing). Specification of a relative generation number for GDG data sets is supported, for example, CATDSN=A.B(-1).

If a filter is specified, then catalogs are scanned for all cataloged data sets matching the filter, and they are processed as if a SELECT CATDSN=dsname was present for each of them. It may be necessary to specify MAXCARDS=nnnnn if a large number of data sets are selected by the filter.

Additional considerations for CATDSN=filter are explained in Generic Data Set Name Selection. For VSAM clusters, the filter is only compared to the base cluster name. Component names, PATH names and AIX (alternate index) cluster and component names are not tested.

CATDSN= is supported only on SELECT statements. However, a preceding EXCLUDE statement with DSN= and/or VOL= can exclude data sets from selection by CATDSN=.

If the VOL= operand is also specified on a SELECT statement with CATDSN=, then only data sets cataloged to those volumes are selected. For example:

CATDSN=USER1.JCL.CNTL

CATDSN=PAY**MASTER(0)

CATDSN=PROD++.**.LIB*

Normally CATDSN= does not display the data sets it selects from the catalogs, you see the names only when ABR actually finds and selects the data sets in the VTOCs of the volumes they are cataloged to. To display all of the data sets selected specify PCATDSN=filter.

DD=

ddn

Specifies that a data set name is to be taken from a DD statement. The value is the ddname of a JCL statement in the ABR step. Using this option lets you specify a non-standard data set name or a Generation Data Group (GDG) relative generation. For example:

SELECT  DD=DD1

//DD1   DD DSN=A.B.C(0),DISP=SHR

ALLDSN

Specifies that ABR is to backup all data sets on the volumes specified. If TYPE=DSF is specified, SELECT ALLDSN does not dump the VTOC and EXCLUDE ALLDSN with the VOL= or VOLG= operand excludes those volumes from ABR processing.

CATALOG=

MCATALOG=

Specifies the name of a user catalog (CATALOG=) or alternate master catalog (MCATALOG=) to search when CATDSN= is specified. See Generic Data Set Name Selection for details.

Default: The catalog search starts with the active master catalog. User catalogs are searched if their assigned aliases match the CATDSN=filter.

CATLIMITGDG=

May be used with CATDSN=filter to limit the selection of GDGs from the catalogs. It does not affect the selection of cataloged non-GDG data sets, but if the filter selects a GDG then:

n

Causes only the most recently created “n” generations to be selected.

–n

Causes only generation (–n) to be selected.

Default: All the generations of selected GDGs are selected unless a relative generation number is specified at the end of the filter, for example, CATDSN=filter(-2).

DATA=

ALL

Specifies that ABR backs up the entire allocated space of the selected data sets. Normally it only processes up to the last block pointer (end-of-file) on input PS or PO data sets for incremental (data set) backups. Use if the last block pointer of certain data sets is invalid.

NONE

No data tracks are backed up for any type of data sets selected. The backup data set consists only of the FDR control records necessary to allocate and update the characteristics of the output data sets during a restore. A DATA=NONE backup can be used to allocate all the data sets on the backup on output volumes, as long as the data in those data sets is recovered by other means (such as database backups). Member DATANONE in the FDR Installation FDRSAMP has more information on the use of DATA=NONE.

DSORG=

Specifies that these data sets are not to be selected unless the DSORG matches one of the specified DSORG= values. If more than one DSORG= is specified, they must be enclosed in parenthesis. Valid DSORG= values are:

DA

BDAM

EF

VSAM

PS

Sequential

PO

Partitioned

UM

Unmovable

UN

Undefined

DSNENQ=

NONE

The data set enqueue is not done for the selected data sets. This can be used to override the DSNENQ= operand on the DUMP statement for certain data sets that you know are probably enqueued by another task.

Default: Determined by the DSNENQ= option on the DUMP statement.

FLASHUNIT=

Can only be used on a MOUNT statement following an FCOPY or CONFCOPY statement and must be preceded by a VOL= operand, for example, MOUNT VOL=PROD01,FLASHUNIT=07CA

VOL= specifies an online volume and FLASHUNIT= specifies the 4-digit z/OS device address of the target volume to which it is to be copied.

Ordinarily, the FlashCopy is done directly from the VOL= volume. However, if REMOTEINSTANT=INBAND is specified on the FCOPY or CONFCOPY statement, then the FlashCopy is done from the Metro Mirror secondary unit of the VOL= volume.

PPRCUNIT=

Can only be used on a MOUNT statement following a PSPLIT or CONPSPLIT statement and must be preceded by a VOL= operand, for example, MOUNT VOL=PROD01,PPRCUNIT=07CA

VOL= specifies an online volume and PPRCUNIT= specifies the 4-digit z/OS device address of the ShadowImage device currently assigned to the online volume. PPRCUNIT= is optional; if not specified, FDR locates the ShadowImage address from information provided by the Hitachi Vantara subsystem. However, this may require a lengthy search through many offline DASD volumes; PPRCUNIT= eliminates that search time.

PRTALIAS

When used on a SELECT statement with CATDSN=, displays all of the alias names and user catalogs that were searched, if the mask provided causes the search to start in the master catalog.

SNAPUNIT=

Can only be used on a MOUNT statement following a SNAP or CONSNAP statement and must be preceded by a VOL= operand, for example, MOUNT VOL=PROD01,SNAPUNIT=07CA

VOL= specifies the online volume to be snapped and SNAPUNIT= specifies the 4-digit z/OS device address of the target volume to which it is to be snapped.

STORGRP=

storg

Can only be used on the MOUNT statement, and only on systems with System Managed Storage (SMS) active. Selects all online volumes in the specified SMS storage group. For example, MOUNT STORGRP=DBLARGE causes ABR to process all volumes in that storage group.

UPDATE

Specifies that the data sets or VSAM clusters that match this control statement are only dumped if the update indicator is set in their Format 1 DSCB, indicating that the data set has been updated since the last ABR Volume Backup. Note that a SELECT statement with UPDATE is not required in an incremental backup step (DUMP TYPE=ABR) since this is the normal operation of such a backup. For example:

DUMP    TYPE=DSF,COMPRESS=ALL

SELECT  DSN=USER**,UPDATE

SELECT  DSN=XYZ**,VOLG=vvvvv,UPDATE

VOL=

VOLG=

Specifies a volume serial number (VOL=) or volume serial prefix (VOLG=) to which this statement applies. If not specified, ABR examines all volumes processed for the data sets named on this statement. For MOUNT statements, it adds the named volumes to the ABR volume list if it is online.