SVTSUTIL Batch Commands › SVTSUTIL Batch Commands › RECOVER=BACKSTORE

RECOVER=BACKSTORE

This command is used when running the SVTSUTIL program to recover z/OS catalog information for CA Vtape Backstore Volumes that were deleted. The catalog information is obtained by reading and processing SMF input volumes and analyzing Type 65 records based on the defined command attributes.

The output of this command creates IDCAMS control statements that are used as input to re-catalog Backstore data sets that were previously deleted. The IDCAMS control statements include the Block-ID that is required for high speed open. A report of the candidate volumes based on the selection criteria coded is also produced.

Syntax

RECOVER=BACKSTORE,
      [CPU|LPAR]=[nnnn|n*|*],
      JOB=[nnnnnnnn|nnn*|*],
      FROM=[*|([YYYY/DDD|MM/DD/YY|
                MM/DD/YYYY|YYYY/MM/DD],hh:mm])]
      TO=[*|([YYYY/DDD|MM/DD/YY|
                MM/DD/YYYY|YYYY/MM/DD],hh:mm])]
      PVOLSER=[volser|vol*|*]
      PVOLSER=(volser1,volser2,…..,vol*|*)
      VVOLSER=[volser|vol*|*]
      VVOLSER=(volser1,volser2,…..,vol*|*)
      ORDER_BY_VOLTYPE=[PHYSICAL|VIRTUAL]

Where:

CPU|LPAR

Filters SMF Type 65 records based on the processor identification. Only SMF records with matching processor identification will be selected. Default: LPAR=*.

JOB

Filters SMF Type 65 records based on job name. SMF records assigned to the job name identification of this attribute will be processed. Only SMF records with a matching job name will be selected. Default: JOB=*.

FROM

Filters SMF Type 65 records based on FROM Date and Time. All SMF Type 65 records with a time stamp lower than the FROM date and time will be ignored. Default: FROM=*.

TO

Filters SMF Type 65 records based on a TO Date and Time. All SMF Type 65 records with a time stamp higher than the TO date and time will be ignored. Default: TO=*.

PVOLSER

Filters SMF Type 65 records based on Backstore Tape Volume Serial Number. Only SMF records with a matching VOLSER will be selected. The PVOLSER command attribute is mutually exclusive with the VVOLSER command attribute. Default: PVOLSER=*.

VVOLSER

Filters SMF Type 65 records based on Virtual Volume Serial Number. Only SMF records with a Backstore Tape data set name containing a matching Virtual VOLSER will be selected. The VVOLSER command attribute is mutually exclusive with the PVOLSER command attribute. Default: VVOLSER=*.

ORDER_BY_VOLTYPE

Defines the order in which IDCAMS control statements and report output are written. Default: VIRTUAL.

Sample JCL can be found in PREFIX.CCUUJCL(RCVBKSTR).

Sample output – SYSUT2 DD Statement File

IDCAMS Control Statements

/*----------------------------------------------------------*/
/* SVTSUTIL RECOVER=BACKSTORE IDCAMS CONTROL STATEMENTS     */
/*  CA VTAPE 12.6  XE61.SVT3                                */
/*  WED JUN 12, 2013  10:32:12                              */
/*----------------------------------------------------------*/
/* ENTRY CREATION DATE:                                     */
/*  WED JUN 12, 2013  10:32:12                              */
DEFINE NONVSAM(NAME                           -               
  (CAVTAPE1.VVE.V101602.DUPLEX                 ) -             
  VOLUMES(542983)                              -               
  FSEQN(00003)                                 -               
  OWNER(X'0000006FFFFFFF91')                   -               
  DEVT(3590-1  ))                                              
 /* ENTRY CREATION DATE:                                     */
/*  WED JUN 12, 2013  10:32:12                              */
DEFINE NONVSAM(NAME                           -               
  (CAVTAPE1.VVE.V101602.PRIMARY                ) -             
  VOLUMES(600147)                              -               
  FSEQN(00003)                                 -               
  OWNER(X'0000006FFFFFFF91')                   -               
  DEVT(3590-1  ))                                              
                                                    

Note: The ENTRY CREATION DATE in the comment is the date and time the catalog entry was created by the Backstore Engine, Recycle, or someone executing IDCAMS DEFINE commands.

Sample output report

   SMF DATE    SMF TIME   JOBNAME   CPU           DATA SET NAME                         VOLSER  FSEQ   DEVTYPE   OWNER (HEX DATA)
   2013/162  14.28.03.38  SVTSXE61  XE61  CAVTAPE1.VVE.V101602.DUPLEX                   542983  00003  3590-1    0000006FFFFFFF91
   2013/162  14.28.03.44  SVTSXE61  XE61  CAVTAPE1.VVE.V101602.PRIMARY                  600147  00003  3590-1    0000006FFFFFFF91
     *** End of Report

The following is an explanation for the columns in the report:

SMF DATE

The date the entry was uncataloged.

SMF TIME

The time the entry was uncataloged.

JOBNAME

Who uncataloged the entry.

CPU

The system on which the uncatalog action occurred.

DATA SET NAME

What was uncataloged.

VOLSER

The Backstore Tape it was uncataloged from.

FSEQ

The file sequence number on that Backstore Tape.

DEVTYPE

The type of device used to mount the Backstore Tape.

OWNER

The starting block-ID of the file (X’0000006F’) on the Backstore Tape and the checksum (X’FFFFFF91’). The two values added together will equal X’10000000’.