Version 8.1.3
 —  Adabas Utility Functions for Delta Save  —

ADAFRM Utility

The Delta Save Facility introduces two new functions to the database formatting utility ADAFRM:


DSIMFRM: Format DSIM Dataset

Before a Delta Save Images (DSIM) dataset can be used in an online save/merge operation, it must be formatted using the DSIMFRM function.

graphics/adafrmd1.png

Essential Parameter

SIZE: Size of Area to be Formatted

SIZE specifies the size of the area to be formatted. Blocks (a decimal value followed by "B") or cylinders may be specified.

Optional Parameters

DEVICE: Device Type

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: Starting RABN

FROMRABN specifies the RABN at which formatting is to begin. This parameter may only be used for an existing dataset.

NOUSERABEND: Termination without ABEND

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.

Example


  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.

Top of page

DSIMRESET: Reset the DSIM Dataset

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.

graphics/adafrmd2.png

Essential Parameters

FROMRABN: Starting RABN

FROMRABN specifies the RABN at which the resetting is to begin. This parameter must be specified.

SIZE: Size of Area to be Reset

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.

Optional Parameters

DEVICE: Device Type

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.

NOUSERABEND: Termination without ABEND

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.

Example


  ADAFRM DSIMRESET SIZE=1B,FROMRABN=1

A DSIM dataset is to be reset, making it again usable for online save/merge operation.

Top of page