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