EXTEND (Extend Data or Index Areas) › How to Use

How to Use

Execute the EXTEND function using the following command format:

►►─ EXTEND AREA= ─┬─ aaa ─┬────────────────────────┬─┬─ ,DBID=n ──────────────►◄
                  │       └─ ,MULTUSE= ─┬─ NO ◄ ─┬─┘ │
                  │                     └─ YES ──┘   │
                  └─ index-area ─┬───────────────┬───┘
                                 └─ IXXAREA=aaa ─┘

Command

EXTEND

Invokes the function for Index or data area expansion and formatting.

Required Keywords

AREA=

Identifies the area to be extended, where aaa is the name of the area to extend, and where index-area indicates that the index area of the database is to be extended.

Valid Entries:

the index area of the database or the DATACOM-NAME of the data area in the database

Default Value:

(No default)

,DBID=

Identifies the database for which the area expansion is required.

Valid Entries:

DATACOM-ID of the database

Default Value:

(No default)

Optional Keyword

,MULTUSE=

(For area level DBUTLTY control only.) In support of area level DBUTLTY control, specifying MULTUSE=YES in the EXTEND function for a data area allows a single area in a database to be extended with no disabling of the other areas in the database. When MULTUSE=YES, the function executes in a format that is a combination of MUF and Single User modes. The database involved must be able to be opened for update in the MUF 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 MUF. The actual data set open is performed in the utility region, and the JCL requirements are applied to the utility region.

Note: The operating system performs the catalog portion of the DD statement DISP option when the DD statement is removed. This occurs at job step termination. Therefore, if you were to change the volume list during an extend, do not expect the MUF to correctly open this area until after the step completes. This restricts the DBUTLTY functions that succeed when following a catalog change.

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

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

Valid Entries:

NO or YES

Default Value:

NO

IXXAREA=aaa

The IXXAREA= keyword is optional when AREA=IXX is also specified and if the database has a single index area, but if specified, it must be specified as IXX. If the database has a Multi-Dataset Index, however, the keyword is required and must be set to a single index area, that is, the name of one of the index areas (IXX or Inn, where nn can be 00 to 99).

Valid Entries:

IXX or I00 to I99

Default Value:

(No default)