Installing Your Product from Pax-Enhanced ESD › Maintenance › Individual RAMDB Maintenance › RAMDB Maintenance Utility Syntax › $RMDB04D OPT=APPLY

$RMDB04D OPT=APPLY

Use this procedure to apply a fix to a RAMDB or check a fix against a RAMDB.

This procedure 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]

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.

[CHECK={NO | YES}]

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

[DIFF={YES | NO}]

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

[FORCE={NO | YES}]

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

[CONFIRM={YES | NO}]

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

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

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