Backup and Restore Utilities › ACFDBSYN - Synchronizing Databases

ACFDBSYN - Synchronizing Databases

The ACFDBSYN utility synchronizes backup copies of CA ACF2 for z/VM databases with the online databases. It accepts input from one of three types of files: CMS databases, CMS backup files, or VSAM backup files in REPRO format.

Prerequisites

Before you can run this utility, you must define the input files with FILEDEFs. The syntax to define the input files is:

FILEDEF ddname DISK fn ft fm

ddname

The ddname of the CMS file where the data to be synchronized resides. Valid options are LID, RULES, or INFO.

DISK

The filedef of a disk file (always DISK).

fn

The filename of the input file to be synchronized.

ft

The filetype of the input file. The filetype chosen defines the format of the input file. Valid options are:

DATABASE

If you are using CMS format databases as input.

BACKUPDB

If you are using CMS backup files as input.

FILE

If you are using VSAM backup files in REPRO format as input.

fm

The filemode of the minidisk containing the input file to synchronize.

Running ACFDBSYN

ACFDBSYN synchronizes all three, or any combination of, CA ACF2 for z/VM databases. The syntax for this utility is:

             {       [ LID            ]}
ACFDBSYN     { ALL | [ RULES  [NOUPD] ]}
             {       [ INFO           ]}

ALL

Indicates you want to synchronize all three CA ACF2 for z/VM databases (Logonid, Rule, and Infostorage).

LID

Indicates you want to synchronize the Logonid database.

RULES

Indicates you want to synchronize the Rule database.

INFO

Indicates you want to synchronize the Infostorage database.

NOUPD

Indicates you do not want to update the specified database. You can use this parameter for a test run.

Execute ACFDBSYN with the NOUPD option before actually synchronizing the databases. Executing this utility with the NOUPD option produces a report highlighting the records that are affected without actually updating them.

When the utility successfully executes, CA ACF2 for z/VM displays messages to indicate which records it replaced or inserted.

Sample Utility

A sample of the ACFDBSYN utility (ACFSYN 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.

Output

After running ACFDBSYN, the online databases have the following characteristics.

Logonid Database

ACFDBSYN does not alter any records that existed only in the online database. It inserts records that existed only in the input file into the online database.

If any logonid records existed in both the input file and the online database, the online database record remains unmodified with the following exception; if someone updated the password of the record in the input file more recently than the password of the online database record, ACFDBSYN uses the password from the input record.

Rule Database

ACFDBSYN does not alter any rule record that existed only on the online database. It inserts rules that existed only on the input file into the online database.

If a rule existed in both the input file and the online database, ACFDBSYN compares the last update time and date of both records. If the record in the input file is more recent, the entire record from the input file replaces the online version.

Infostorage Database

ACFDBSYN does not alter records that existed only on the online database. It inserts records that existed only on the input file into the online database.

If a record existed in both the input file and the online database, ACFDBSYN compares the last update time and date of both records. If the record in the input file is more recent, the entire record from the input file replaces the online version.