Defining and initializing the Archive Database, Cloud Definition Database, and Restore Queue files

The Archive Database, Cloud Definition Database, and the Restore processing queue files must be defined and initialized before they can be used by the product functions.

Procedure

  1. Verify that appropriate values have been set for these parameters in the AXQUSETS member of the product parameter library:
    • ARCHIVE-DATABASE-CLUSTER-NAME
    • ARCHIVE-DATABASE-NUMBER-OF-RECORDS
    • CLOUDDEF-DATABASE-CLUSTER-NAME
    • CLOUDDEF-DATABASE-NUMBER-OF-RECORDS
    • RESTORE-QUEUE-CLUSTER-NAME
    • RESTORE-QUEUE-NUMBER-OF-RECORDS
    • DYNAMIC-ALLOCATION-VSAM-DATA-CLASS
    • DYNAMIC-ALLOCATION-VSAM-MANAGEMENT-CLASS
    • DYNAMIC-ALLOCATION-VSAM-STORAGE-CLASS
    If you intend to allocate to non-SMS DASD, verify also that appropriate values have been set for these parameters in the AXQUSETS member of the product parameter library:
    • DYNAMIC-ALLOCATION-VSAM-DATA-VOLSER
    • DYNAMIC-ALLOCATION-VSAM-INDEX-VOLSER
  2. Open for editing the AXQDBINI member of the Advanced Archive for DFSMShsm JCL sample library.
  3. Specify valid job card information.
  4. Replace all occurrences of @HLQ with your data set prefix.
  5. Delete the asterisk (*) in column 1 from the INITIALIZE_ARCHIVE_DATABASE SYSIN DD control statement.
  6. Delete the asterisk (*) in column 1 from the INITIALIZE_RESTORE_QUEUE SYSIN DD control statement.
  7. If you intend to archive data to a cloud storage environment, delete the asterisk (*) in column 1 from the INITIALIZE_CLOUD_DEFINITIONS_DB SYSIN DD control statement.
    The modified job should resemble the example shown in the following figure:
    //AXQDBINI JOB (ACCT1,ACCT2),'PROG.NAME',REGION=0M,TYPRUN=HOLD,       
//             NOTIFY=&SYSUID,CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1)       
//*                                                                   
//*----------------------------------------------------------------*//
//*                                                                *//
//*      © ROCKET SOFTWARE, INC. OR ITS AFFILIATES 2014-2018.      *//
//*      ALL RIGHTS RESERVED.                                      *//
//*                                                                *//
//*      ARCHIVE MANAGER - DATABASE AND REQUEST QUEUE              *//
//*                        DEFINITION AND INITIALIZATION           *//
//*      ---------------------------------                         *//
//*                                                                *//
//*      THIS SAMPLE JOB WILL INVOKE THE DATABASE AND REQUEST      *//
//*      QUEUE DEFINTION AND INITIALIZATION FUNCTIONS              *//
//*                                                                *//
//*      BEFORE YOU RUN THIS JOB, DO THE FOLLOWING:                *//
//*         1) ENSURE THAT THE JOBCARD IS VALID FOR YOUR           *//
//*            ENVIRONMENT                                         *//
//*         2) SUBSTITUTE YOUR DATA SET PREFIX FOR @HLQ            *//
//*                                                                *//
//*----------------------------------------------------------------*//
//*                                                                   
//S010   EXEC PGM=AXQDBINI                                            
//*                                                                   
//STEPLIB  DD DISP=SHR,DSN=@HLQ.SAXQLOAD                              
//AXQPRLIB DD DISP=SHR,DSN=@HLQ.SAXQPARM                              
//*                                                                   
//SYSIN   DD *                                                        
INITIALIZE_ARCHIVE_DATABASE     <<<== UNCOMMENT TO PERFORM FUNCTION   
INITIALIZE_RESTORE_QUEUE        <<<== UNCOMMENT TO PERFORM FUNCTION   
INITIALIZE_CLOUD_DEFINITIONS_DB <<<== UNCOMMENT TO PERFORM FUNCTION
//                                                                 
    //AXQDBINI JOB (ACCT1,ACCT2),'PROG.NAME',REGION=0M,TYPRUN=HOLD,       
//             NOTIFY=&SYSUID,CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1)       
//*                                                                   
//*----------------------------------------------------------------*//
//*                                                                *//
//*      5698-AAD                                                  *//
//*      © ROCKET SOFTWARE, INC. OR ITS AFFILIATES 2014-2018.      *//
//*      ALL RIGHTS RESERVED.                                      *//
//*                                                                *//
//*      ADVANCED ARCHIVE - DATABASE, AND REQUEST QUEUE AND CLOUD  *//
//*                         DEFINITIONS DATABASE DEFINITIONS AND   *//
//*                         INITIALIZATION                         *//
//*      ---------------------------------                         *//
//*                                                                *//
//*      THIS SAMPLE JOB WILL INVOKE THE DATABASE. REQUEST QUEUE   *//
//*      AND CLOUD DEFINTIONS DATABASE DEFINITION AND              *//
//*      INITIALIZATION FUNCTIONS                                  *//
//*                                                                *//
//*      BEFORE YOU RUN THIS JOB, DO THE FOLLOWING:                *//
//*         1) ENSURE THAT THE JOBCARD IS VALID FOR YOUR           *//
//*            ENVIRONMENT                                         *//
//*         2) SUBSTITUTE YOUR DATA SET PREFIX FOR @HLQ            *//
//*                                                                *//
//*----------------------------------------------------------------*//
//*                                                                   
//S010   EXEC PGM=AXQDBINI                                            
//*                                                                   
//STEPLIB  DD DISP=SHR,DSN=@HLQ.SAXQLOAD                              
//AXQPRLIB DD DISP=SHR,DSN=@HLQ.SAXQPARM                              
//*                                                                   
//SYSIN   DD *                                                        
INITIALIZE_ARCHIVE_DATABASE     <<<== UNCOMMENT TO PERFORM FUNCTION   
INITIALIZE_RESTORE_QUEUE        <<<== UNCOMMENT TO PERFORM FUNCTION   
INITIALIZE_CLOUD_DEFINITIONS_DB <<<== UNCOMMENT TO PERFORM FUNCTION
//
  8. Submit the job and verify that it completes successfully.

What to do next

If you will be archiving data to a cloud storage environment, go on to Creating cloud definitions and loading them into storage. Otherwise, ignore the Creating cloud definitions and loading them into storage topic and go directly to Restricting access to product files.