INIT CXX/FXX/IXX/LXX/Data Area › INIT Data Area (Format Data Area) › How to Use

How to Use

You can execute this command in either Single User or Multi-User mode. Execute the DBUTLTY function using the following command format:

►►─ INIT AREA=a,DBID=n ─┬───────────────────────┬─────────────────────────────►
                        └─ ,VERIFY= ─┬─ NO ◄ ─┬─┘
                                     └─ YES ──┘

 ►─┬────────────────────────┬─────────────────────────────────────────────────►◄
   └─ ,MULTUSE= ─┬─ NO ◄ ─┬─┘
                 └─ YES ──┘

Command

INIT

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

Required Keywords

AREA=

Identifies the data area to be formatted.

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)

Optional Keywords

,MULTUSE=

(For area level DBUTLTY control only.) In support of area level DBUTLTY control, specifying MULTUSE=YES in the INIT function for a data area allows a single area in a database to be initialized with no disabling of the other areas in the database. When MULTUSE=YES, the function executes in a format that is a combination of Multi-User Facility and Single User modes. The database involved must be able to be opened for update in the Multi-User Facility address space. The area, however, must have no tables open. Once begun, the function does not allow other tasks to open any tables in the area being processed. Other tables in the database, but not in the area, may be open for read or update in the same Multi-User Facility. The actual data set open is performed in the utility region, and the JCL requirements are applied to the utility region.

When you specify or allow the default of MULTUSE=NO in the INIT function for data areas, the function executes completely in Single User mode.

For more information on area level DBUTLTY control, see Area Level DBUTLTY Control.

Valid Entries:

NO or YES

Default Value:

NO

,VERIFY=

If you do not specify the VERIFY= option, or if you specify VERIFY=NO (the default), an INIT opens the data set for output, builds a new control block, and initializes the extents.

If you specify VERIFY=YES, an INIT opens the data set for update, reads and updates an existing control block, and initializes the extents.

Because a new control block is always built with VERIFY=NO, specifying VERIFY=YES when the INIT is not for a new data set brings several benefits, including the following:

• Because an existing control block is read and updated instead of a new one being built, the data area history (in the control block) documenting activities such as backups and loads is not lost. Data area history information can be a valuable aid when troubleshooting various problems.
• VERIFY=YES prevents the unintentional overlaying of important information because of a JCL error, such as writing over files in PRODuction status that should have been in TEST status, or the inadvertant overlaying of the Directory (CXX) or Log Area (LXX).

Note: Even with VERIFY=YES specified, the last extent and the number of extents is lost during an initialize.

You can specify both VERIFY=YES and DISP=NEW, but if you specify both the VERIFY=YES is ignored. (Prior to Version 12.0, you were not allowed to specify YES for both VERIFY= and DISP=.)

Valid Entries:

YES or NO

Default Value:

NO