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

How to Use

Multi-User mode is required to execute this command. 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 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 EXTEND 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

IXXAREA=aaa

The IXXAREA= keyword is optional 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)

When you execute the EXTEND function, you receive the operator console message:

Verify that the dtfname and file-name displayed are the names associated with the file you want to extend. Issue the following command, substituting the partition number for n:

n DELETE

Your file is not to be deleted. It is to be extended with the newly allocated space.