The Delta Save Facility introduces two new functions to the database formatting utility ADAFRM:
Before a Delta Save Images (DSIM) dataset can be used in an online save/merge operation, it must be formatted using the DSIMFRM function.
SIZE specifies the size of the area to be formatted. Blocks (a decimal value followed by "B") or cylinders may be specified.
DEVICE is the physical or logical device type to be assigned to the DSIM dataset. If FROMRABN is also specified, DEVICE must specify the device type of the existing DSIM dataset. If DEVICE is not specified, the device type specified by the ADARUN DEVICE parameter is used.
FROMRABN specifies the RABN at which formatting is to begin. This parameter may only be used for an existing dataset.
When an error is encountered while the function is running, the utility prints an error message and terminates with user ABEND 34 (with a dump) or user ABEND 35 (without a dump).
If NOUSERABEND is specified, the utility will not ABEND after printing the error message. Instead, the message "utility TERMINATED DUE TO ERROR CONDITION" is displayed and the utility terminates with condition code 20.
ADAFRM DSIMFRM SIZE=20,DEVICE=8381
A DSIM dataset is to be formatted. It is 20 cylinders large. Its device type is to be 8381.
The DSIMRESET function resets the specified blocks of the Delta Save Images (DSIM) dataset to binary zeros. DSIMRESET can be used to reinitialize the DSIM dataset for further use. If some exceptional condition left a DSIM dataset ineligible for use by an online save operation, the dataset can be made available again using the DSIMRESET function. This can be achieved by resetting only the first block (RABN 1).
Software AG recommends that you specify the DSIM dataset for exclusive use by the ADAFRM utility to avoid accidentally destroying information in a DSIM dataset currently in use by another utility.
FROMRABN specifies the RABN at which the resetting is to begin. This parameter must be specified.
SIZE specifies the size of the area to be reset. Either cylinders (a numerical value alone) or blocks (a value followed by "B") can be specified. The SIZE parameter must be specified.
DEVICE is the physical or logical device type of the DSIM dataset. If DEVICE is not specified, the device type specified by the ADARUN DEVICE parameter is used.
When an error is encountered while the function is running, the utility prints an error message and terminates with user ABEND 34 (with a dump) or user ABEND 35 (without a dump).
If NOUSERABEND is specified, the utility will not ABEND after printing the error message. Instead, the message "utility TERMINATED DUE TO ERROR CONDITION" is displayed and the utility terminates with condition code 20.
ADAFRM DSIMRESET SIZE=1B,FROMRABN=1
A DSIM dataset is to be reset, making it again usable for online save/merge operation.
