VSAM and RAMDB Maintenance › Individual RAMDB Maintenance › RAMDB Maintenance Utility Syntax › $RMDB04D OPT=RESTORE

$RMDB04D OPT=RESTORE

This utility option reverses the effect of a fix.

This option has the following format:

$RMDB04D OPT=RESTORE
         FIX=fix-number
        [DDNAME=ddname | DATASET=dataset-name]
        [CONFIRM={YES | NO}]
        [TDB=target-file-id [TDBDSN=target-dataset-name]]
        [DDB=source-file-id [DDBDSN=source-dataset-name]]

OPT=RESTORE

Specifies that a fix, which has been applied to the target RAMDB, is being reversed.

FIX=fix-number

Specifies the fix number that you want to back out of the RAMDB. This number is used as the member name of the fix data set. The number is verified against the contents of the member for the correct fix.

DDNAME=ddname | DATASET=dataset-name

(Optional) Specifies one of the following parameters:

• DDNAME parameter if you have already allocated the data set containing the fix to the system
• DATASET parameter if you want to allocate the data set containing the fix and to free the data set after the fix has been retrieved

These two parameters are mutually exclusive and, therefore, you cannot specify both of them. If neither is specified, the COMMANDS DD concatenation in the region is used.

CONFIRM={YES | NO}

(Optional) Specifies whether the fix is retrieved and the syntax is checked before being presented as a panel for browsing. The panel lets you view the fix and confirm the restoration process. After you confirm, the fix is removed and the original data restored. The message log is presented as another panel for browsing. If you specify NO, the restoration process proceeds without presenting any confirmation panel. The message log is written to the terminal rather than being displayed as a panel.

The message log is always written to the activity log regardless of the options specified.

TDB=target-file-id [TDBDSN=target-dataset-name]

(Optional) Reverses a fix in a database other than the currently allocated RAMDB. This parameter specifies the file ID of the target database. If you also specify the TDBDSN parameter, the specified data set is allocated a ddname, target-file-id.The data set is then opened and started. The database is not freed after the restoration process. If the database is already allocated, the specified data set name is verified as allocated to the ddname, target-file-id. The data set is opened to the same file ID.

DDB=source-file-id [DDBDSN=source-dataset-name]

(Optional) Specifies the file ID of the source database.

Note: Restoration requires the specification of the distribution (source) database through the DDB parameter.

The source database must be a copy of the original database. If you also specify the DDBDSN parameter, the specified data set is allocated a ddname, source-file-id. The data set is then opened and started. The database is not freed after the restoration process. If the database is already allocated, the specified data set name is verified as allocated to the ddname, source-file-id. The data set is opened to the same file ID.