Examples of how to code the ARECOVER command

The following examples reflect the simplified ARECOVER commands, which require the user only to know the name of the aggregate group that has been backed up. You do not need to enter the control file data set name (and VOLUMES/UNIT, if XMIT is not specified) each time an aggregate recovery is performed.

Note: Any values specified here are only examples and should not be interpreted as the values to be used for your system.

Preparing a new ABR record

In this example, the ARECOVER command for the aggregate group, PAY1.C.C01V0001, is prepared. This preparation eliminates the overhead of verification processing or data movement associated with the VERIFY or EXECUTE parameter. TAPE23 is specified as the volume for the aggregate group, and 3590-1 is specified as the tape unit type to be allocated for the aggregate group. INSTRUCTION recovers the instruction data set and ACTIVITY recovers the activity log data set.

   ARECOVER DATASETNAME(PAY1.C.C01V0001) VOLUMES(TAPE23) +
   UNIT(3590-1) PREPARE INSTRUCTION ACTIVITY

Verifying aggregate recovery

In this example, the ARECOVER command for the aggregate group, PAY1.C.G0001V00, is verified. This verification ensures that the command can complete successfully with no errors. The data sets to be recovered, as indicated by the aggregate group, are checked to ensure that no like-named data set conflicts exist. No data sets are recovered.

   ARECOVER AGGREGATE(PAY1) VERIFY

Recovering the aggregated data sets

In this example, the data sets to be recovered, as indicated by the aggregate group, PAY1.C.G0001V00, are recovered. 3590-1 is specified as the tape unit type for receiving data sets recovered to tape devices.

   ARECOVER AGGREGATE(PAY1) EXECUTE TARGETUNIT(3590-1)

Replacing like-named aggregated data sets during recovery

In this example, the data sets specified by the aggregate group, PAY1.C.G0001V00, are recovered. Any like-named data set that exists at the aggregate recovery site is deleted and is replaced with the corresponding aggregate backup data set. DATASETCONFLICT (REPLACE) is the proper parameter which deletes the existing data set at the ARECOVER site and recovers the ABACKUP data set.

   ARECOVER AGGREGATE(PAY1) EXECUTE DATASETCONFLICT(REPLACE)

Recovering RACF-protected aggregated data sets

In this example, the data sets to be recovered as indicated by the aggregate group, PAY1.C.G0001V00, are recovered. When those data sets previously protected by discrete profiles and defined to RACF® before aggregate backup are recovered, they are protected by the predefined model entity, USRT004.MODEL.PROF.

   ARECOVER AGGREGATE(PAY1) EXECUTE MENTITY(USRT004.MODEL.PROF)

Specifying the percentage of DASD space for non-SMS volumes

This example shows how to fill NON-SMS Level 0 volumes to 90% of capacity during ARECOVER processing.

   ARECOVER AGGREGATE(PAY1) EXECUTE PERCENTUTILIZED(090)

Specifying the migration level of recovered migrated data sets

This example shows how to recover all migrated data sets to ML2 tape volumes during ARECOVER processing.

   ARECOVER AGGREGATE(PAY1) EXECUTE MIGRATEDDATA(ML2)

Specifying a high-level qualifier

This example shows how to rename all data sets that are recovered from ABACKUP output files with the high level qualifier of PAY1. The existing high level qualifier will be replaced.

   ARECOVER AGGREGATE(PAY1) EXECUTE RECOVERNEWNAMELEVEL(PAY1)

Recovering an aggregate containing L0 data sets in the include list which failed due to inadequate space

In this example, L0 data sets were not recovered successfully by DFSMSdss because an inadequate space condition occurred. The ARECOVER command can be issued again with the VOLCOUNT parameter, allowing the failing data sets to be recovered to as many volumes as needed (maximum of 59) for successful allocation.

   ARECOVER DSNAME(PAY1.C.C01V0002) VOLUMES(TAPE24) VOLCOUNT(ANY) EXECUTE

Sample activity log output for the ARECOVER command

Figure 1 is sample activity log output for the ARECOVER command.

Figure 1. ARECOVER sample activity log output

PAGE 0001  Z/OS DFSMSHSM        DATA  FACILITY  HIERARCHICAL  STORAGE  MANAGER   06.081  09:34
ARC6102I AGGREGATE RECOVERY STARTING USING CONTROL FILE DATA SET PAY1.C.C01V0002, AT 18:16:00,
 STARTED TASK = DFHSMABR.ABAR0154
ARC6030I ACTIVITY LOG FOR CONTROL FILE DATA SET PAY1.C.C01V0002 WILL BE ROUTED TO SYSOUT=A
ARC6115I AGGREGATE RECOVERY USING CONTROL FILE DATA SET PAY1.C.C01V0002 WILL USE VOLUMES
  A00020
  A00016
ARC6120I CONFLICT RESOLUTION ACTION 'REPLACE' WILL BE USED FOR DATA SET PAY1.PY001.NAMES DURING AGGREGATE RECOVERY
ARC6120I CONFLICT RESOLUTION ACTION 'REPLACE' WILL BE USED FOR DATA SET PAY2.PY002.RETIRE DURING AGGREGATE RECOVERY
ARC6120I CONFLICT RESOLUTION ACTION 'REPLACE' WILL BE USED FOR DATA SET PAY2.PY002.SOCSEC DURING AGGREGATE RECOVERY
ARC6120I CONFLICT RESOLUTION ACTION 'REPLACE' WILL BE USED FOR DATA SET PAY2.PY002.STATUS.G0002V00 DURING AGGREGATE RECOVERY
ARC6120I CONFLICT RESOLUTION ACTION 'REPLACE' WILL BE USED FOR DATA SET PAY1.INSTRUCT DURING AGGREGATE RECOVERY
ARC6120I CONFLICT RESOLUTION ACTION 'REPLACE' WILL BE USED FOR DATA SET PAY1.PY002.IRA DURING AGGREGATE RECOVERY
ARC6108I DATA SET PAY1.PY001.NAMES HAS BEEN UNCATALOGED DURING AGGREGATE RECOVERY
ARC6108I DATA SET PAY2.PY002.RETIRE HAS BEEN UNCATALOGED DURING AGGREGATE RECOVERY
ARC6108I DATA SET PAY2.PY002.SOCSEC HAS BEEN DELETED DURING AGGREGATE RECOVERY
ARC6108I DATA SET PAY2.PY002.STATUS.G0002V00 HAS BEEN DELETED DURING AGGREGATE RECOVERY
ARC6108I DATA SET PAY1.INSTRUCT HAS BEEN DELETED DURING AGGREGATE RECOVERY
ARC6108I DATA SET PAY1.PY002.IRA HAS BEEN DELETED DURING AGGREGATE RECOVERY
ARC6004I 000{ ARECOVER PAGE 0001         5695-DF175  DFSMSdss V1R1.0  Data Set Services          92.238  18:16
ARC6004I 000{ ARECOVER ADR035I (SCH)-PRIME(06), INSTALLATION EXIT ALTERED BYPASS FAC CLASS CHK DEFAULT TO YES
ARC6004I 000{ ARECOVER  RESTORE DATASET(FILTERDD(SYS00016)) -
ARC6004I 000{ ARECOVER  INDDNAME(SYS00015) -
ARC6004I 000{ ARECOVER  OUTDYNAM( -
ARC6004I 000{ ARECOVER   (DUMPDS) -
ARC6004I 000{ ARECOVER   ) -
ARC6004I 000{ ARECOVER  PERCENTUTILIZED( -
ARC6004I 000{ ARECOVER  080 -
ARC6004I 000{ ARECOVER   ) -
ARC6004I 000{ ARECOVER  SPHERE  -
ARC6004I 000{ ARECOVER  TGTGDS(SOURCE) -
PAGE 0002  Z/OS DFSMSHSM 1.9.0        DATA  FACILITY  HIERARCHICAL  STORAGE  MANAGER   06.081  09:34
ARC6004I 000{ ARECOVER  CATALOG FORCE
ARC6004I 000{ ARECOVER ADR101I       RI01 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'RESTORE '
ARC6004I 000{ ARECOVER ADR109I       RI01 (01), 92238 18:16:41 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED.
ARC6004I 000{ ARECOVER ADR006I (001)-SETUP(01), 92238 18:16:42 EXECUTION BEGINS
ARC6004I 000{ ARECOVER ADR780I (001)-TDDS (01), THE INPUT DUMP DATA SET BEING PROCESSED IS IN LOGICAL DATA SET FORMAT
ARC6004I 000{ ARECOVER ADR396I (001)-NEWDS(01), DATA SET PAY2.PY002.SOCSEC ALLOCATED, ON VOLUME(S): DUMPDS
ARC6004I 000{ ARECOVER ADR465I (001)-DALOC(01), DATA SET PAY2.PY002.SOCSEC HAS BEEN CATALOGED IN CATALOG TPCMAST1
ARC6004I 000{ ARECOVER ADR489I (001)-TDLOG(01), DATA SET PAY2.PY002.SOCSEC WAS RESTORED
ARC6004I 000{ ARECOVER ADR396I (001)-NEWDS(01), DATA SET PAY2.PY002.STATUS.G0002V00 ALLOCATED, ON VOLUME(S): DUMPDS
ARC6004I 000{ ARECOVER ADR465I (001)-DALOC(01),
ARC6004I 000{ ARECOVER DATA SET PAY2.PY002.STATUS.G0002V00 HAS BEEN CATALOGED IN CATALOG TPCMAST1
ARC6004I 000{ ARECOVER ADR489I (001)-TDLOG(01), DATA SET PAY2.PY002.STATUS.G0002V00 WAS RESTORED
ARC6004I 000{ ARECOVER ADR396I (001)-NEWDS(01), DATA SET PAY1.INSTRUCT ALLOCATED, ON VOLUME(S): DUMPDS
ARC6004I 000{ ARECOVER ADR465I (001)-DALOC(01), DATA SET PAY1.INSTRUCT HAS BEEN CATALOGED IN CATALOG TPCMAST1
ARC6004I 000{ ARECOVER ADR489I (001)-TDLOG(01), DATA SET PAY1.INSTRUCT WAS RESTORED
ARC6004I 000{ ARECOVER ADR454I (001)-TDLOG(01), THE FOLLOWING DATA SETS WERE SUCCESSFULLY PROCESSED
ARC6004I 000{ ARECOVER                           PAY2.PY002.SOCSEC
ARC6004I 000{ ARECOVER                           PAY2.PY002.STATUS.G0002V00
ARC6004I 000{ ARECOVER                           PAY1.INSTRUCT
ARC6004I 000{ ARECOVER PAGE 0002         5695-DF175  DFSMSdss V1R1.0  Data Set Services          92.238  18:16
ARC6004I 000{ ARECOVER ADR013I (001)-CLTSK(01), 92238 18:17:00 TASK COMPLETED WITH RETURN CODE 0000
ARC6004I 000{ ARECOVER ADR012I (SCH)-DSSU (01), 92238 18:17:00 DFSMSdss PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0000
ARC6109I REPLACE OPTION SPECIFIED,
 GDG DATA SET PAY2.PY002.STATUS.G0002V00 HAS BEEN RESTORED USING EXISTING GDG ATTRIBUTES
ARC6116I THE FOLLOWING DATA SETS WERE SUCCESSFULLY RECOVERED USING AGGREGATE GROUP PAY1:
  PAY1.PY001.NAMES
  PAY2.PY002.RETIRE
  PAY2.PY002.SOCSEC
  PAY2.PY002.STATUS.G0002V00
  PAY1.INSTRUCT
    PAY1.PY002.IRA
ARC6116I THE FOLLOWING DATA SETS WERE SUCCESSFULLY ALLOCATED USING AGGREGATE GROUP PAY1:
  PAY2.PY001.BENEFIT
ARC6116I THE FOLLOWING DATA SETS WERE SUCCESSFULLY CATALOGED USING AGGREGATE GROUP PAY1:
  PAY2.PY001.TAXES
ARC6103I AGGREGATE RECOVERY HAS COMPLETED FOR AGGREGATE GROUP PAY1, USING CONTROL FILE DATA SET PAY1.C.C01V0002,
 AT 18:17:31, RETCODE = 000