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

$RMDB04D OPT=APPLY

This utility option applies a fix to a RAMDB or verify a fix against a RAMDB.

This option has the following format:

$RMDB04D OPT=APPLY
         FIX=fix-number
        [DDNAME=ddname | DATASET=dataset-name]
        [CHECK={NO | YES]
        [DIFF={YES | NO}]
        [FORCE={NO | YES}]
        [CONFIRM={YES | NO}]
        [DB=file-id [DBDSN=db-dataset-name]]

OPT=APPLY

Specifies that a fix is being applied to a RAMDB.

FIX=fix-number

Specifies the fix number. This number is used as the member name of the input partitioned data set.

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.

CHECK={NO | YES}

(Optional) Specifies whether the fix is checked. If you specify YES, the fix is checked only for compatibility with the database. The fix is not applied to the database. The verification phase is always performed regardless of the value specified. However, this parameter determines whether the phase is the only phase to be performed.

DIFF={YES | NO}

(Optional) Specifies whether differences are displayed. If you specify YES, the differences between the target objects and the new objects in the fix are displayed for each updated object. This report applies to any SET (update) and CREATE (add) actions in the fix member where the target objects already exist.

Default: YES

FORCE={NO | YES}

(Optional) Specifies whether the fix is applied regardless of the success or failure of the verification phase. However, if CHECK=YES is specified, the FORCE parameter has no effect.

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 enables you to view the fix and confirm the application. After you confirm, the fix is applied, and the message log displays another panel for browsing. If you specify NO, the fix is applied 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.

DB=file-id [DBDSN=db-dataset-name]

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