AREA SECTION

The AREA SECTION identifies the CA IDMS/DB database areas that are to be readied by the CA IDMS DLI Transparency run-time interface in any usage mode other than shared retrieval (the default). Specify one AREA SECTION statement for each database area that is not to be readied in shared retrieval mode.

Note: Make sure that all database areas to be accessed by the run-time interface are included in the subschema. The run-time interface automatically readies those areas required by this IPSB. Areas included in the subschema but not required by the IPSB are not readied.

Syntax

►►─── AREA SECTION ── . ─────────────────────────────────────────────────────►

   ┌─────────────────────────────────────────────────────────────────────────
 ►─▼─┬────────────────────────────────┬──────────────────────────────────────►─
     └─ AREA name is idms-area-name ──┘

  ──────────────────────────────────────────────────────────────┐
-►─┬──────────────────────────────────────────────────────┬─ . ─┴────────────►◄
   └─ USAGE-MODE is ──┬─ SHARED ◄───┬──┬─ RETRIEVAL ◄───┬─┘
                      ├─ PROTECTED ─┤  └─ UPDATE ───────┘
                      └─ EXCLUSIVE ─┘

Parameters

AREA SECTION.

AREA SECTION must be the first entry in the section, followed by as many AREA statements as required. You must include the AREA SECTION clause whether or not the section contains any AREA statements.

AREA name is idms-area-name

Identifies the CA IDMS/DB database area to be readied.

Idms-area-name is the 1- to 16-character area name and included in the subschema named in the IPSB SECTION.

USAGE-MODE is

Specifies the usage mode in which the run-time interface is to ready the named area. The usage mode options specify the conditions for readying and accessing the named area.

PROTECTED

Specifies that the named area, once readied by CA IDMS/DB, cannot be readied in update usage mode by other concurrently executing run units.

EXCLUSIVE

Specifies that the named area, once readied by CA IDMS/DB, cannot be accessed by other concurrently executing run units.

RETRIEVAL

Specifies that the named area is to be readied for retrieval only. Other concurrently executing run units can ready the area in any usage mode other than one that is qualified as EXCLUSIVE.

RETRIEVAL is the default.

UPDATE

Specifies that the named area is to be readied for both retrieval and update. Other concurrently executing run units can ready the area in any usage mode other than one that is qualified as EXCLUSIVE or PROTECTED.

Example

 AREA SECTION.
      AREA NAME IS IDMSDB-1
           USAGE-MODE IS EXCLUSIVE UPDATE.
      AREA NAME IS SPFAREA1.
      AREA NAME IS SPFAREA2
           USAGE-MODE IS PROTECTED UPDATE.
      AREA NAME IS IDSMDB-2
           USAGE-MODE IS RETRIEVAL.

Figure 35. Sample AREA SECTION