Dumping integrated catalog facility user catalogs

Another important use of DFSMSdss as a backup tool is the backing up of integrated catalog facility user catalogs and their aliases (using logical data set dump). The user catalog name must be fully qualified with the INCLUDE keyword on the DUMP command. The LOCK attribute of an integrated catalog facility user catalog is dumped. The LOCK status is preserved if the catalog does not exist at restore time. Otherwise, the LOCK status of the existing catalog is used.

The following example shows the JCL used to dump an integrated catalog facility user catalog. RACF® access to the catalog is not required if you have RACF DASDVOL update access or if the installation authorization exit routine bypasses authorization checking.

//STEPT006 EXEC PGM=ADRDSSU
//SYSPRINT DD SYSOUT=*
//TAPE     DD DISP=(NEW,PASS),LABEL=(1,SL)
      VOL=SER=(A00760),DSN=PUBSEXMP.DUMP,
      UNIT=3590,DCB=(BLKSIZE=32760)
//SYSIN    DD *
  DUMP DS(INC(TEST.CAT.PUBSEXMP)) -
           OUTDDNAME (TAPE)
/*

Figure 1 shows printed output produced by the dump.

Figure 1. Output from a Dump of an Integrated Catalog Facility User Catalog

PAGE 0001     5695-DF175  DFSMSDSS V2R10.0 DATA SET SERVICES     1999.211 14:54                                                     
   DUMP                           -                                                                                                 
      DS(INCL(TEST.CAT.PUBSEXMP)) -                                                                                                 
      OUTDDNAME (TAPE)                                                                                                              
ADR101I (R/I)-RI01 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'DUMP '                                                            
ADR109I (R/I)-RI01 (01), 1999.211 14:54:32 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED.                                       
ADR016I (001)-PRIME(01), RACF LOGGING OPTION IN EFFECT FOR THIS TASK                                                                
ADR006I (001)-STEND(01), 1999.211 14:54:32 EXECUTION BEGINS                                                                         
ADR801I (001)-DTDSC(01), DATA SET FILTERING IS COMPLETE. 1 OF 1 DATA SETS WERE SELECTED: 0 FAILED
                         SERIALIZATION AND 0 FAILED FOR OTHER REASONS.                                                                                             
ADR454I (001)-DTDSC(01), THE FOLLOWING DATA SETS WERE SUCCESSFULLY PROCESSED                                                        
                          CLUSTER NAME   TEST.CAT.PUBSEXMP                                                                          
                          CATALOG NAME   SYS1.MVSRES.MASTCAT                                                                        
                          COMPONENT NAME TEST.CAT.PUBSEXMP                                                                          
                          COMPONENT NAME TEST.CAT.PUBSEXMP.CATINDEX                                                                 
ADR006I (001)-STEND(02), 1999.211 14:54:32 EXECUTION ENDS                                                                           
ADR013I (001)-CLTSK(01), 1999.211 14:54:32 TASK COMPLETED WITH RETURN CODE 0000                                                     
ADR012I (SCH)-DSSU (01), 1999.211 14:54:32 DFSMSDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0000

For more information about the LOCK attribute, refer to z/OS DFSMS Managing Catalogs.

For more information about the installation authorization exit routine, refer to z/OS DFSMS Installation Exits.