Previous Topic: Successful Execution Requirements and ControlsNext Topic: Examples


How to Use PREINIT data area

To pre-format a data area, execute DBUTLTY using the following command format:

►►─ PREINIT AREA=aaa,DBID=n,BLKSIZE=size ─┬─────────────┬───────────►◄
                                          └─ VOLUMES=n ─┘

Command

PREINIT

Invokes the function to pre-format data areas for CA Datacom/DB use.

Required Keywords

AREA=aaa

You can PREINIT a data area with PREINIT AREA=aaa where aaa Identifies the data area to be pre-formatted. To PREINIT a data area, the aaa cannot be IXX.

Valid Entries:

DATACOM-NAME of the area in the specified database

Default Value:

(No default)

,DBID=

Identifies the database containing the area that is to be initialized.

Valid Entries:

DATACOM-ID of the database

Default Value:

(No default)

,BLKSIZE=size

BLKSIZE is the size of the data area blocks within the data area. The size is based upon the tables that are to be stored in the area. For PREINIT data area, specify the size in BLKSIZE=size to match the block size that you intend to provide in the CA Datacom Datadictionary definition for the data area.

Valid Entries:

512 - 32767

a valid block size

Default Value:

(No default)

Optional Keywords

,VOLUMES=n

The n in VOLUMES=n is the maximum number of volumes to initialize. Without the VOLUMES= option, the number of volumes having specific VOLSER information is initialized. The VOLUMES= option allows more volumes to be catalogued as part of the data set and available to an EXTEND or dynamic EXTEND, while being effectively held in reserve without a specific allocation.

For example, you could specify VOLUMES=3 when using a PREINIT to initialize an area that needs 3 volumes, intending to only initialize the space on 3 volumes. But the JCL could specify 6 specific volumes, for example, VOL=SER=(VOL001,VOL002,VOL003,VOL004,VOL005,VOL006), so that volumes 4/5/6 are not allocated or used during the INIT but are available to a dynamic extend. In this case, the extra volumes would not need to be removed before another INIT.

Valid Entries:

the number n of volumes to be catalogued

Default Value:

(No Default)