Previous Topic: $RMDB04D OPT=APPLY

Next Topic: Configuring Your Product


$RMDB04D OPT=RESTORE

Use this procedure to reverse the effect of a fix.

This procedure 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 to back out of the RAMDB. This number is used as the member name of the fix data set and is verified against the contents of the member for the correct fix.

[DDNAME=ddname | DATASET=dataset-name]

Specifies the DDNAME parameter if the data set containing the fix is already allocated to the system, or the DATASET parameter if the data set containing the fix is to be allocated and freed 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}]

Specifies whether the fix is retrieved and the syntax 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, and 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]]

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 that is the same as the specified file ID, and is 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 (that is the same as the specified file ID) and opened to the same file ID.

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

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 that is the same as the specified file ID, and is 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 (that is the same as the specified file ID) and opened to the same file ID.