ACFDBRST - Restoring Databases

Backup and Restore Utilities › ACFDBRST - Restoring Databases

ACFDBRST - Restoring Databases

The ACFDBRST utility restores CA ACF2 for z/VM database information from sequential backups into new CMS format databases or VSAM databases.

Terminology

The following terminology is used throughout this section.

Database: One of the three CA ACF2 for z/VM databases (Logonid, Rules, or Infostorage).
INFO: The CA ACF2 for z/VM Infostorage database.
LID: The CA ACF2 for z/VM Logonid database.
RULES: The CA ACF2 for z/VM Rule database.

Prerequisites

Before you restore into CMS databases, you must reserve minidisks through the CMS RESERVE command. The syntax is:

RESERVE fn DATABASE fm

fn: The filename of the minidisk to reserve.
DATABASE: The filetype (always DATABASE).
fm: The filemode of the minidisk to reserve.

If you are restoring into VSAM databases, you just delete and define the VSAM clusters using IDCAMS. ACFDBRST rebuilds the databases into the newly‑created clusters.

You might also need to run the ACFLINIT utility before you can restore the VSAM databases. See ACFLINIT ‑ Initializing VSAM Databases later in this chapter for information.

Defining the Input File

The syntax to define the input backup files is:

FILEDEF ddname DISK fn BACKUPDB fm

ddname: The ddname of the CMS file where the backup data resides. Valid options are BKPLID, BKPRULES, or BKPINFO.
DISK: The filedef of a disk file (always DISK).
fn: The filename of the backup file to restore.
BACKUPDB: The filetype of the backup file (must be BACKUPDB).
fm: The filemode of the minidisk containing the backup file to restore.

Defining the Output File

To define the new output files, use the following syntax:

For CMS Databases

The syntax for FILEDEFs for CMS databases is:

FILEDEF ddname DISK fn DATABASE fm

ddname: The ddname of the database to restore into. Valid options are LID, RULES, or INFO.
DISK: The filedef of a disk file (always DISK).
fn: The filename of the database to restore to.
DATABASE: The filetype of the database to restore to (must be DATABASE).
fm: The filemode of the database to restore to.

You must have reserved this minidisk (fn DATABASE fm) through the CMS RESERVE command before you can run the utility.

For VSAM Databases

Enter the following command to create a DLBL for the VSAM catalog:

DLBL IJSYSCT fm DSN catname (VSAM

You must define this file.

fm: The filemode of the disk the catalog is on.
catname: The DSN of the catalog.

Enter the following command to specify a DLBL for each restored VSAM file:

DLBL ddname fm DSN dsn (VSAM

ddname: The ddname of the VSAM database to restore into. Valid options are LID, RULES, or INFO.
fm: The filemode of the disk the VSAM database is on.
dsn: The actual IDCAMS‑defined VSAM data set name to restore.

Running ACFDBRST

You can use this utility to restore all three, or any combination of, CA ACF2 for z/VM databases. The syntax for running this utility is:


             {       [ LID   ]}
ACFDBRST     { ALL | [ RULES ]}
             {       [ INFO  ]}

ALL: Indicates you want to restore all three CA ACF2 for z/VM databases (Logonid, Rule, and Infostorage).
LID: Indicates you want to restore the Logonid database.
RULES: Indicates you want to restore the Rule database.
INFO: Indicates you want to restore the Infostorage database.

CA ACF2 for z/VM displays the following message when the utility has successfully executed:

ACFRST361I <nn db> records processed

nn: The number of records processed.
db: The type of records processed.

Sample Utility

A sample of the ACFDBRST utility (ACFREST SAMPEXEC) is provided with this release of CA ACF2 for z/VM Security for VM. To use the sample exec, edit it and make appropriate modifications to the FILEDEF statements.