How to copy/move the ACF2 database from one catalog to another in a shared environment

Products

• ACF2 - z/OS

Issue/Introduction

How to copy/move the ACF2 database from one catalog to another in a shared environment?

Sites running ACF2 in a shared database environment should ensure that the ACF2 databases are in their own User Catalog (USERCAT). The USERCAT should not contain any other data sets. In addition, the USERCAT should not be on the same device as any of the ACF2 databases.

Environment

Release : 16.0

Resolution

 The following steps can be followed to copy/move the ACF2 databases to a new catalog/volume.

1. Make a copy of the ACFBKUP* job which can be found in the ACF2 installation CAX1PROC library. Name the copied job ACFBKUP2. Make changes to the ACFBKUP2 JCL copy to:
   
   
   1. Delete the alternate backup databases.
   2. Redefine the alternate backup databases on the new catalog.
   3. Copies the primary (currently active) backup databases to the redefined alternate backup databases.
      
      
2. Make another copy of the ACFBKUP* Name the copied job ACFBKUP3. Make changes to the ACFBKUP3 JCL copy to:
   
   
   1. Delete the primary databases.
   2. Redefine the primary databases on the new catalog.
   3. Copies the primary (currently active) backup database to the redefined primary databases. 

3. Run the ACF backup command, which is defined in the GSO BACKUP record. This command backs up the primary (active) database to the primary backup database.
   
   F ACF2,BACKUP
   
   
4. Run the ACFBKUP2 job to define/copy the alternate backup database to the new catalog. 

5. Switch from the primary databases to the alternate backup databases by a. stopping and starting ACF2 or b. by issuing the SWITCH** command. Use the SWITCH** command only when increasing the ACF2 database size, not the ACF2 database record size.
   
   
   1. To stop and restart ACF2:
      
      P ACF2
      S ACF2,PARM='DDSN(ALT)'
      
      ALT Specifies the alternate database name, as defined in the ACFFDR @DDSN macro.
      
      
   2. To run the SWITCH** command:
      
      F ACF2,SWITCH(ALT) 

6. Run the ACFBKUP3 job to define/copy the primary databases to the new catalog.
   
   
7. Switch from the alternate backup databases to the primary databases by a. stopping and starting ACF2 or b. by issuing the SWITCH** command. Use the SWITCH** command only when increasing the ACF2 database size, not the ACF2 database record size.
   
   
   1. To stop and restart ACF2:
      
      P ACF2
      S ACF2,PARM='DDSN(PRIMARY)'
      
      PRIMARY Specifies the primary database name, as defined in the ACFFDR @DDSN macro.
      
      
   2. To run the SWITCH** command:
      
      F ACF2,SWITCH(PRIMARY)
      

 * NOTE:   For details on the ACFBKUP job see ACF2 documentation section:
                ‘Database Recovery’ sub-section: ‘ACFBKUP Procedure’.

 ** NOTE: For details on the SWITCH command see ACF2 documentation section:
                ‘Console Operator Commands Summary’ sub-section: ‘Switch Databases’.