Saving catalog information at the time of backup

At the time of backup, DFSMShsm can save the catalog information for the data sets within a copy pool and store it in a DFSMShsm-managed data set. During fast replication recovery processing, saved catalog information is used to recover and re-catalog data sets that are either deleted or moved.

You can use the COPY POOL DEFINE and COPY POOL ALTER panels to specify up to 10 catalog names. The catalog names can have up to 44 alphanumeric characters, including a delimiter. The catalogs must reside on volumes within the copy pool, collectively represent all data sets in the copy pool, and cannot contain any data sets outside of the copy pool in which they are defined.

You can specify whether catalog information for all catalogs should be collected at time of backup by changing the value in the Capture Catalog Information for Data Set Recovery field. If you enter R (required), the fast replication backup request fails if the catalog specified in the copy pool definition cannot be found or if the catalog information cannot be retrieved and captured in its entirety. If you enter P (preferred), under the same conditions, the backup copy pool version is valid, but you might not be able to recover some data sets in the version. Entering N (no) disables the recovery of moved or deleted data sets, this is the default.

Because mature or highly utilized catalogs often contain logical errors, capturing catalog information from a catalog with errors fails and causes the catalog search interface to return an error. When the catalog search interface returns an error, message ARC1812I is issued.

When required is specified, all catalog errors must be corrected to allow fast replication backup to succeed. Alternatively, if preferred is specified, capturing the catalog information will fail, but the fast replication backup request will continue processing.

You can also specify whether fast reverse restore is allowed by changing the value in the Allow Fast Reverse Restore field. If you enter Y (yes), recovery of a FlashCopy® source from the FlashCopy target can occur without waiting for the background copy to complete. Entering N (no) disables fast revere restore and requires you to wait for the original FlashCopy operation to complete prior to starting recovery, this is the default.

The following example shows the second page of the COPY POOL DEFINE and COPY POOL ALTER panels:
Figure 1. COPY POOL DEFINE/ALTER panel, Page 2.
  Panel  Utilities  Scroll  Help
-------------------------------------------------------------------------------
DGTDCPP5                  COPY POOL DEFINE/ALTER                  Page 2 of 5
Command ===>

SCDS Name  . . : IBMUSER.SCDS
Copy Pool Name : COPYPL1

To DEFINE/ALTER Copy Pool, Specify:
Catalog Name ==> ____________________________________________
             ==> ____________________________________________
             ==> ____________________________________________
             ==> ____________________________________________
             ==> ____________________________________________
             ==> ____________________________________________
             ==> ____________________________________________
             ==> ____________________________________________
             ==> ____________________________________________
             ==> ____________________________________________

  Capture Catalog Information for Data Set Recovery . . N   (R, P or N)
  Allow Fast Reverse Restore  . . . . . . . . . . . . . N   (Y or N)

Use ENTER to Perform Verification; Use UP/DOWN Command to View next Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.

You can use the FRBACKUP command to create a fast replication backup version for sets of storage groups followed by a dump of each fast replication target volume. During FRBACKUP processing, information from the catalogs specified in the copy pool definition in SMS is captured and saved to a DFSMShsm-managed data set, called catalog information data set (CIDS). If preferred is specified and the catalog specified in the copy pool definition cannot be found or the catalog information cannot be retrieved, a warning message is issued, indicating that only partial catalog information is captured, and all catalog information that can be saved is saved. This allows you to recover the entire copy pool, individual copy pool volumes, cataloged data sets, and moved or deleted data sets for which the catalog information was captured. If required is specified and the catalog specified in the copy pool definition cannot be found or the catalog information cannot be retrieved, the FRBACKUP request is failed and terminates.

During processing of the FRBACKUP command, one CIDS is created for each copy pool version. Because you can specify 10 catalog names in the copy pool definition, each CIDS might contain information from up to 10 catalogs. The size of a CIDS depends on the number and type of catalog entries contained in each of the catalogs specified in the copy pool definition. Each CIDS is allocated on an ML1 volume and is cataloged. The catalog data sets are treated similarly to the way VTOC copy data sets are treated. They are not eligible for SDSPs and cannot be migrated to ML2 volumes. When you enter the FRBACKUP command, you must ensure that you have sufficient space available on ML1 volumes to accommodate the catalog information data sets. Catalog information data sets are deleted when their associated versions are rolled off, deleted, expired, or withdrawn.

Note: Catalog information data sets are allocated on 50 primary and 50 secondary cylinders, unless this setting is modified by patches described in the Tuning DFSMShsm topic of z/OS DFSMShsm Implementation and Customization Guide.

To move valid backup versions and migration copies from DFSMShsm-owned DASD volumes, you can use the FREEVOL command. FREEVOL allows you to move the catalog data sets from a single ML1 volume to other ML1 volumes. Catalog information data sets are moved from the freed volume to other ML1 volumes, regardless of the target level of the FREEVOL command.

The naming convention for a CIDS is as follows:
PREFIX.HSMCIDS.Dyyddd.Thhmmss.Cnumseq
where:
PREFIX
is the value of the BACKUPPREFIX parameter of the SETSYS command, if specified. Otherwise, PREFIX is the DFSMShsm default UID.
yyddd
is the year and day of the backup.
hhmmss
is the time in hours, minutes, and seconds of when the fast replication backup was created.
numseq
is the qualifier that ensures that the data set name is unique. It is a 3 digit number in the range 001 - 255 that is increased by 1 in the event of a data set name collision.
Note: HSMCIDS, D, T, and C are constants.