Previous Topic: ADD AREA StatementNext Topic: MODIFY RECORD Statement


MODIFY AREA Statement

The MODIFY AREA statement allows you to specify a name for a generated area. The specified name overrides the name supplied by the syntax generator. Note that the default area name consists of the DL/I DBD name concatenated with the literal "-REGION".

If the name of an area in the associated schema is different from the syntax generator-supplied name, you must include the MODIFY AREA statement to supply the correct schema-specific area name.

Syntax

►►─┬───────────────────────────────────┬─────────────────────────────────────►
   └─ MODify AREA NAME is area-name ───┘

 ►─┬──────────────────────────────┬──────────────────────────────────────────►
   └─ NEW NAME is new-area-name ──┘

 ►─┬──────────────────────────────────────────────────────────────┬──────────►◄
   └─ USAGE-mode is ──┬─ PROTECTED ──┬──┬─ RETRIEVAL ◄──┬─── . ───┘
                      └─ EXCLUSIVE ──┘  └─ UPDATE ──────┘

Parameters

MODify AREA NAME is area-name

Identifies the generated area for which you want to specify a new name. Area-name must be a 1- to 16-character name.

NEW NAME is new-area-name

Specifies the new CA IDMS/DB database area name. New-area-name must be a valid 1- to 16-character CA IDMS/DB area name.

USAGE-mode is

Specifies the usage mode in which an application can ready the area. The usage mode specifies the run-time operations that an application can perform against the CA IDMS/DB database area.

If neither PROTECTED nor EXCLUSIVE is specified, SHARED is the default. SHARED specifies that other concurrently executing applications can access the named area.

PROTECTED

PROTECTED prohibits update of the area by another concurrently executing application.

EXCLUSIVE

EXCLUSIVE prohibits access to the area by another concurrently executing application.

RETRIEVAL

Permits only retrieval (read-only) access for the database area

UPDATE

Allows all DML functions (STORE, ERASE, MODIFY, etc.) for the database area