Copy pool backup with background copy - Examples of DFSMShsm fast replication tasks

Chapter 5. DFSMShsm fast replication commands

5.3 Examples of DFSMShsm fast replication tasks

5.3.3 Copy pool backup with background copy

The usage of copy pools that are defined to hold 1 - 85 fast replication DASD backup versions with background copy is described.

By using this type of copy pool, you can create non-incremental and incremental backups, depending on the parameters that you specify with the FRBACKUP command.

ARC1801I FAST REPLICATION BACKUP IS STARTING FOR COPY POOL CP1, AT 14:51:31 ON 2010/10/08

ARC0640I ARCFRTM - PAGE 0001 5695-DF175 DFSMSDSS V1R12.0 DATA SET SERVICES 2010.281 14:51 ARC0640I ARCFRTM - ADR035I (SCH)-PRIME(06), INSTALLATION EXIT ALTERED BYPASS FAC CLASS CHK DEFAULT TO YES ARC0640I ARCFRTM - COPY IDY(MHL0A0) ODY(YYDF20) DUMPCOND FR(REQ) PUR ALLX ALLD(*) -

ARC0640I ARCFRTM - FCFVR -

ARC0640I ARCFRTM - DEBUG(FRMSG(DTL))

ARC0640I ARCFRTM - ADR101I (R/I)-RI01 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'COPY '

ARC0640I ARCFRTM - ADR109I (R/I)-RI01 (01), 2010.281 14:51:31 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED ARC0640I ARCFRTM - ADR405E (001)-DYNA (02),

DYNAMIC ALLOCATION OF VOLUME YYDF20 FAILED. ERROR CODE 0218. INFORMATION CODE 0000

ARC0640I ARCFRTM - ADR017E (001)-CLTSK(01), 2010.281 14:51:31 TASK NOT SCHEDULED DUE TO ERROR. TASK RETURN CODE 0008 ARC0640I ARCFRTM - ADR012I (SCH)-DSSU (01),

2010.281 14:51:31 DFSMSDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0008 FROM: ARC0640I ARCFRTM - TASK 001

ARC1812I OPERATION=CAPTURE FOR CATALOG INFORMATION DATA SET=HSM.HSMCIDS.D10281.T145131.C001 FOR COPY POOL=CP1 HAS COMPLETED WITH RETURN CODE=0004 AND REASON CODE=0012

ARC1803E THE FOLLOWING 00001 VOLUME(S) FAILED DURING FAST REPLICATION BACKUP OF COPY POOL CP1 ARC1803E (CONT.) MHL0A0, ADR****

ARC1802I FAST REPLICATION BACKUP HAS COMPLETED FOR COPY POOL CP1, AT 14:51:34 ON 2010/10/08, FUNCTION RC=0008, MAXIMUM VOLUME RC=0008, CAPTURE CATALOG RC=0004

Non-incremental fast replication backup

The FRBACKUP ... EXECUTE command creates fast replication DASD backups by establishing FlashCopy relationships (that are automatically withdrawn as soon as the background copy completes) between the source and target volumes.

The command that is shown in Example 5-12 starts the fast replication backup process for copy pool CP1.

Example 5-12 FRBACKUP command that includes EXECUTE

HSEND FRBACKUP CP(CP1)EXECUTE

The messages in the backup log describe the details (Figure 5-9).

Figure 5-9 Excerpt from the DFSMShsm backup log that shows FRBACKUP ... EXECUTE details

Fast replication backup always results in execution of the DFSMSdss COPY FULL command, which is physical processing. DFSMSdss is being called by using ADRXMAIA (a). The target volumes look exactly like the source volumes because COPY FULL occurs together with the parameter DUMPCONDITIONING. The only part that is not being copied is the volume serial number of the source volume (Figure 5-10).

When a target volume is being dumped to tape, the result looks exactly as though the source volume was dumped directly.

Target data sets are not cataloged. Because the DFSMSdss COPY FULL during fast replication backup was a physical processing, no catalog information was captured by DFSMSdss. To support the individual recovery of moved or deleted data sets from a fast replication backup, DFSMShsm captures the catalog information during fast replication backup (c). Catalog information is captured only if it is requested by the copy pool definition. The captured catalog information can be displayed by using the COPY FULL

DUMPCONDITIONING command as shown in Example 5-15 on page 79.

ARC1801I FAST REPLICATION BACKUP IS STARTING FOR COPY POOL CP1, AT 20:46:05 ON 2010/10/08

ARC0640I ARCFRTM - PAGE 0001 5695-DF175 DFSMSDSS V1R12.0 DATA SET SERVICES 2010.281 20:46 ARC0640I ARCFRTM - ADR035I (SCH)-PRIME(06), INSTALLATION EXIT ALTERED BYPASS FAC CLASS CHK DEFAULT TO YES ARC0640I ARCFRTM - COPY IDY(MHL0A0) ODY(YYDF20) DUMPCOND FR(REQ) PUR ALLX ALLD(*) -

ARC0640I ARCFRTM - FCFVR - b ARC0640I ARCFRTM - DEBUG(FRMSG(DTL))

ARC0640I ARCFRTM - ADR101I (R/I)-RI01 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'COPY '

ARC0640I ARCFRTM - ADR109I (R/I)-RI01 (01), 2010.281 20:46:05 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED ARC0640I ARCFRTM - ADR050I (001)-PRIME(02), DFSMSDSS INVOKED VIA CROSS MEMORY APPLICATION INTERFACE a

ARC0640I ARCFRTM - ADR016I (001)-PRIME(01), RACF LOGGING OPTION IN EFFECT FOR THIS TASK ARC0640I ARCFRTM - ADR006I (001)-STEND(01), 2010.281 20:46:05 EXECUTION BEGINS

ARC0640I ARCFRTM - ADR241I (001)-DDTFP(01), TARGET VTOC BEGINNING AT 000000003:00 AND ENDING AT 000000008:14 IS OVERLAID ARC0640I ARCFRTM - ADR806I (001)-T0MI (02), VOLUME MHL0A0 WAS COPIED USING A FAST REPLICATION FUNCTION

ARC0640I ARCFRTM - ADR006I (001)-STEND(02), 2010.281 20:46:06 EXECUTION ENDS

ARC0640I ARCFRTM - ADR013I (001)-CLTSK(01), 2010.281 20:46:06 TASK COMPLETED WITH RETURN CODE 0000

ARC0640I ARCFRTM - ADR012I (SCH)-DSSU (01), 2010.281 20:46:06 DFSMSDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0000 ARC1805I THE FOLLOWING 00001 VOLUME(S) WERE SUCCESSFULLY PROCESSED BY FAST REPLICATION BACKUP OF COPY POOL CP1

ARC1805I (CONT.) MHL0A0

ARC1802I FAST REPLICATION BACKUP HAS COMPLETED FOR COPY POOL CP1, AT 20:46:06 ON 2010/10/08, FUNCTION RC=0000, MAXIMUM VOLUME RC=0000, CAPTURE CATALOG RC=0000 c

Figure 5-10 DFSMSdss COPY DUMPCONDITIONING

Because the copy pool definition includes a request for fast reverse restore, the

FCFULLVOLUMERELATION parameter (b) is used. Therefore, the FlashCopy relationships can be reversed even before the relationships are ending and enables recoverability for the copy pool after the FlashCopy relationships are being established.

DFSMSdss processing ends after successful establishment of FlashCopy relationships, which usually only takes seconds.

You can query active FlashCopy relationships due to the fast replication processing of a copy pool by using the QUERY command (Example 5-13).

Example 5-13 QUERY CP command

HSEND Q CP(CP1)

The output of a QUERY CP command shows all active FlashCopy relationships that are associated with the requested copy pool. The display includes the progress (1) for each volume pair (Figure 5-11).

Figure 5-11 Q CP command output

ARC1820I THE FOLLOWING VOLUMES IN COPY POOL CP1, VERSION 001, HAVE AN ACTIVE ARC1820I (CONT.) FLASHCOPY BACKGROUND COPY ARC1820I (CONT.) SGNAME FR-PRIMARY FR-BACKUP PCT-COMP 1

ARC1820I (CONT.) SG1 MHL0A0 YYDF20 009 ***

VOLSRC

VOLTGT

SYS1.VTOCIX.VOLSRC SYS1.VVDS.VVOLSRC SYS1.VTOCIX.VOLSRC SYS1.VVDS.VVOLSRC COPY FULL … DUMPCONDITIONING

DU M P F U L L … DUMP SYS1.VTOCIX.VOLSRC SYS1.VVDS.VVOLSRC

VOLSRC

RE_ST OR E F_UL L/D AT_AS ET_…

A LIST COPYPOOL command (as shown in Example 5-14) returns status information about the newly created backup version as soon as the FlashCopy relationships are being

established.

Example 5-14 LIST COPYPOOL command

HSEND LIST CP(CP1) ALLVOL ODS(MHLRES1.OUT.LIST)

Because we specified ALLVOL, which includes a default for GEN(0), only status information of the latest backup version with volume pairs is displayed (Figure 5-12).

Figure 5-12 Output of LIST COPYPOOL command

Another example of how to use the LIST CP command to gather information about copy pool backups is to request data set information (Example 5-15).

Example 5-15 LIST COPYPOOL DATASETS command

HSEND LI CP(CP1) DATASETS ODS(MHLRES1.OUT.LIST)

-- DFSMShsm CONTROL DATASET --COPY POOL--LISTING --- AT 20:47:35 ON 10/10/ COPYPOOL=CP1 ALLOWPPRCP FRB=NO FRR=NO VERSION VTOCENQ DATE TIME FASTREPLICATIONSTATE DUMPSTATE 001 Y 2010/10/08 20:46:05 RECOVERABLE NONE TOKEN(C)=C'' TOKEN(H)=X'' TOTAL NUM OF VOLUMES=00001,INCREMENTAL=N,CATINFO=Y,FCFRR=Y,RECOVERYINCOMPLETE=N SGNAME SOURCE - TARGET SOURCE - TARGET SOURCE - TARGET SOURCE - TARGET SG1 MHL0A0 - YYDF20 --- END OF -- COPY POOL -- LISTING ---

The output is created from catalog-captured information but returns only data set names that are sorted by catalog (Figure 5-13).

Figure 5-13 Output of LIST COPYPOOL DATASETS command

Catalog information is captured in a data set (1) during fast replication backup. The naming convention for a catalog information data set (CIDS) is shown:

BPREFIX.HSMCIDS.Dyyddd.Thhmmss.Cnumseq

The various parts of this expression have the following meanings:

BPREFIX The value of the BACKUPPREFIX parameter of the SETSYS

command, if specified. Otherwise, BPREFIX is the DFSMShsm default user identifier (UID).

yyddd The year and day of the backup.

hhmmss The time in hours, minutes, and seconds when the fast replication backup was created.

numseq The qualifier that ensures that the data set name is unique. The qualifier is a three-digit number in the range 001 - 255 that is increased by 1 in a data set name collision.

During the processing of the FRBACKUP command, one CIDS is created for each copy pool version. Each CIDS is allocated on an ML1 volume and cataloged. Figure 5-14 on page 81 is a list of CIDS that were available after the FRBACKUP command that is shown in

Example 5-12 on page 77 was executed. The catalog data sets are treated similarly to the way that VTOC copy data sets are treated. Catalog information data sets are deleted when their associated versions are rolled off, deleted, expired, or withdrawn.

-- DFSMShsm CONTROL DATA SET -- COPY POOL -- LISTING -- AT 21:11:54 ON 10/10/08 COPYPOOL=CP1 ,VER=001,GEN=000,CATINFO=Y CATALOG INFORMATION DATA SET NAME=HSM.HSMCIDS.D10281.T204605.C001 1 ,

TKN(C)=C'' TKN(H)=X'' CATALOG NAME = UCAT.TESTFR DATA SET NAME TESTFR.CMD.CLIST TESTFR.CMD.CLIST.NEW TESTFR.CNTL.JCL TESTFR.CX TOTAL NUMBER OF DATA SETS = 4

CIDS: A CIDS might contain information from up to 10 catalogs. The actual size of a CIDS

depends on the type and number of catalog entries that are contained in each catalog. CIDS are allocated on 50 primary and 50 secondary cylinders, unless this setting is modified by patches as described in the z/OS V1R12.0 DFSMShsm Implementation and Customization Guide, SC35-0418.

Figure 5-14 List of CIDS

Incremental fast replication backup

The FRBACKUP ... FCINCREMENTAL command creates fast replication DASD backups by establishing FlashCopy relationships between source and target volumes that will be persistent with change recording.

For the next example, we used copy pool CP2. By setting the number of backup versions to 1 in the copy pool construct, we can refresh the incremental backup of the copy pool with every future execution of FRBACKUP.

By using the command that is shown in Example 5-16, we can start the fast replication backup process for copy pool CP2.

Example 5-16 FRBACKUP command that includes FCINCREMENTAL

HSEND FRBACKUP CP(CP2) FCINCREMENTAL

The messages in the backup log describe the details of the process (Figure 5-15).

DSLIST - Data Sets Matching HSM.HSMCIDS Row 1 of 9 Command ===> Scroll ===> PAGE Command - Enter "/" to select action Message Volume --- HSM.HSMCIDS.D10235.T160051.C001 SBXHS5 HSM.HSMCIDS.D10235.T160207.C001 SBXHS5 HSM.HSMCIDS.D10267.T212439.C001 SBXHS5 HSM.HSMCIDS.D10267.T213136.C001 SBXHS5 HSM.HSMCIDS.D10267.T213801.C001 SBXHS5 HSM.HSMCIDS.D10274.T130019.C001 SBXHS5 HSM.HSMCIDS.D10280.T124026.C001 SBXHS5 HSM.HSMCIDS.D10280.T124229.C001 SBXHS5 HSM.HSMCIDS.D10281.T204605.C001 SBXHS5

ARC1801I FAST REPLICATION BACKUP IS STARTING FOR COPY POOL CP2, AT 21:50:29 ON 2010/10/13

ARC0640I ARCFRTM - PAGE 0001 5695-DF175 DFSMSDSS V1R12.0 DATA SET SERVICES 2010.286 21:50 ARC0640I ARCFRTM - ADR035I (SCH)-PRIME(06), INSTALLATION EXIT ALTERED BYPASS FAC CLASS CHK DEFAULT TO YES ARC0640I ARCFRTM - COPY IDY(MHL0A0) ODY(YYDF20) DUMPCOND FR(REQ) PUR FCINCREMENTAL -

ARC0640I ARCFRTM - FCFVR -

ARC0640I ARCFRTM - DEBUG(FRMSG(DTL))

ARC0640I ARCFRTM - ADR101I (R/I)-RI01 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'COPY '

ARC0640I ARCFRTM - ADR109I (R/I)-RI01 (01), 2010.286 21:50:29 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED ARC0640I ARCFRTM - ADR050I (001)-PRIME(02), DFSMSDSS INVOKED VIA CROSS MEMORY APPLICATION INTERFACE

ARC0640I ARCFRTM - ADR016I (001)-PRIME(01), RACF LOGGING OPTION IN EFFECT FOR THIS TASK ARC0640I ARCFRTM - ADR006I (001)-STEND(01), 2010.286 21:50:29 EXECUTION BEGINS

ARC0640I ARCFRTM - ADR006I (001)-STEND(02), 2010.286 21:50:29 EXECUTION ENDS

ARC0640I ARCFRTM - ADR013I (001)-CLTSK(01), 2010.286 21:50:29 TASK COMPLETED WITH RETURN CODE 0000

ARC0640I ARCFRTM - ADR012I (SCH)-DSSU (01), 2010.286 21:50:29 DFSMSDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0000 ARC1805I THE FOLLOWING 00001 VOLUME(S) WERE SUCCESSFULLY PROCESSED BY FAST REPLICATION BACKUP OF COPY POOL CP2

ARC1805I (CONT.) MHL0A0

ARC1802I FAST REPLICATION BACKUP HAS COMPLETED FOR COPY POOL CP2, AT 21:50:29 ON 2010/10/13, FUNCTION RC=0000, MAXIMUM VOLUME RC=0000, CAPTURE CATALOG RC=0000

The LIST CP command (Example 5-17) returns a display (Figure 5-16) that confirms that incremental backup (a) processing is in use.

Example 5-17 LIST CP command

HSEND LI CP(CP2)

Figure 5-16 Output of LIST CP command with incremental backup

In document DFSMShsm Fast Replication Technical Guide (Page 94-100)