ICF Catalog Backup and Recovery: A Practical Guide

Chapter 7. Case studies 125

Fix #4 is more complicated. In that instance, it was found that the alias ICSF was

found in each master catalog. But in one master, it was related to the user

catalog UCAT.VSBOX09. In the other master, it was related to the user catalog

UCAT.VSBOX01. This is considered to be an error situation, but since there is no

way for the DEFINE ALIAS command processor to know which is correct, it

builds two sets of commands that you can choose from, once you determine

which fix is correct for your situation.

Finally, note that all the fixes in Example 7-8 were generated as comment

statements, and as such, are not directly executable as IDCAMS commands until

the /* at the beginning of each command is removed. Since the fix file is a

physical sequential file, that can be done with TSO ISPF edit. In many situations,

this might be a laborious task, so the DIAGNOSE ALIAS command has the

keywords DEFINE-ALIAS and DELETE-ALIAS. If you know in advance which

command is more appropriate for your environment, the command processor will

build those commands as “ready to execute”.

7.4 Case study #4: VVDS backup and forward recovery

This case study demonstrates how to use the Catalog RecoveryPlus BACKUP

and RECOVER VVDS command first, to produce backup copies for VVDSs on

critical volumes, and secondly, to forward recover a VVDS if it “breaks”. The

following examples do not show an actual problem with the VVDS being

recovered, but rather, the job streams that perform VVDS backup and recovery.

It is frequently asked, “How often do VVDSs break?” The answer is “more often

than most people realize”, but since a DIAGNOSE VVDS command is rarely

performed, any errors encountered are probably credited to other causes.

Interestingly, during system testing for this redbook, we discovered a broken

VVDS on one of our ITSO volumes. Since this volume was heavily in use by

other redbook projects at the time, and was only causing intermittent failures

during data set allocation, its recovery was left for a later time. Below is a

re-creation of the steps that would have been used in our recovery on the ITSO

system, assuming it was a VVDS failure on volume SBOX79.

As shown in Example 7-9, the VVDSs on all of the SBOX

xx

volumes were

backed up with a single Catalog RecoveryPlus BACKUP command, with the

backup records for all VVDSs being written out to a single output file identified by

the DD statement OUT1. In a production environment, this would presumably be

a regularly-scheduled job, possibly run at the same time as all BCSs are backed

up.

126 ICF Catalog Backup and Recovery: A Practical Guide

Example 7-9 BACKUP VVDS job stream and output listing

20.11.15 JOB10237 IEF403I YCJRES1Z - STARTED - ASID=0019

20.13.12 JOB10237 IEF404I YCJRES1Z - ENDED - ASID=0019

20.13.12 JOB10237 ---TIMINGS (MINS.)--

20.13.12 JOB10237 -JOBNAME STEPNAME RC EXCP CPU SRB CLOCK

20.13.12 JOB10237 -YCJRES1Z S1 04 33667 .11 .01 1.9

//YCJRES1Z JOB MSGCLASS=X,NOTIFY=YCJRES1,RESTART=*

//S2 EXEC PGM=CAT00010

//OUT1 DD DSN=YCJRES1.BACKUP(+1),DISP=(,CATLG),

// UNIT=SYSALLDA,SPACE=(CYL,(10,10),RLSE)

//SYSPRINT DD SYSOUT=*

//SYSOUT DD SYSOUT=*

//SYSIN DD *

BACKUP VVDS(SBOX*) -

OUTFILE(OUT1)

/*

Output Listing:

CAT01001I Catalog RecoveryPlus MAINSTAR SOFTWARE CORPORATION 24 SEP 2001 PAGE:1

CAT02061W VVDS SYS1.VVDS.VSBOX07 IS NOT ON THE VOLUME

CAT02061W VVDS SYS1.VVDS.VSBOX34 IS NOT ON THE VOLUME

... and 29 more volumes where VVDSs were not found on the volume,

... followed by a list of 66 volumes that were selected for the BACKUP

CAT02045I START OF DATA UNLOAD FOR SYS1.VVDS.VSBOX01 ON 24 SEP 2001 AT 20.11.16

CAT02092I CALLING IDCAMS TO PERFORM DIAGNOSE VVDS

IDC11367I THE FOLLOWING VVDS REFERENCED CATALOGS WERE NOT ENCOUNTERED:

CATALOG.TOTICF1.VTOTCAT

CAT02050W IDCAMS (8) ISSUED RETURN CODE 4

CAT02046I RECORD SUMMARY FOR SYS1.VVDS.VSBOX01

PRIMARY SECONDARY NONVSAM VVCR/VVCN OTHER TOTAL TOTAL BYTES

295 39 0 1 0 335 179,560

CAT02047I END OF DATA UNLOAD FOR SYS1.VVDS.VSBOX01 ON 24 SEP 2001 AT 20.11.48

... additional volume unloads removed from listing

CAT02045I START OF DATA UNLOAD FOR SYS1.VVDS.VSBOX79 ON 24 SEP 2001 AT 20.11.51

CAT02092I CALLING IDCAMS TO PERFORM DIAGNOSE VVDS

CAT02046I RECORD SUMMARY FOR SYS1.VVDS.VSBOX79

PRIMARY SECONDARY NONVSAM VVCR/VVCN OTHER TOTAL TOTAL BYTES

1,032 0 0 1 0 1,033 378,834

CAT02047I END OF DATA UNLOAD FOR SYS1.VVDS.VSBOX79 ON 24 SEP 2001 AT 20.11.57

CAT02009I BACKUP FUNCTION COMPLETE. RETURN CODE 4

CAT01009I Catalog RecoveryPlus EXECUTION COMPLETE. HIGHEST RETURN CODE WAS 4