Modification Statements

Contents
idms
Contents
The CA IDMS DLI Transparency syntax generator modification statements allow you to override area, record, and set definitions in generated schema, DMCL, subschema, and IPSB source. The modification statements can be used in conjunction with any of the four GENERATE statements.
Make sure that the schema, subschema, and IPSB source definitions remain consistent. That is, any modifications made to a subschema must also be made to the associated schema. Any modifications made to an IPSB must also be made to its associated schema and subschema. For example, if you add an area to the generated IPSB source, you must also add the same area to both the associated schema and subschema source.
Different Types
The modification statements are as follows:
  • ADD AREA statement
    -- Generates source statements for defining a CA IDMS/DB database area
  • MODIFY AREA statement
    -- Overrides a generated area name or changes the usage mode for a generated area
  • MODIFY RECORD statement
    -- Overrides a generated record name
  • MODIFY SET statement
    -- Overrides a generated set name
Each statement is described separately below.
ADD AREA Statement
The ADD AREA statement generates the source statements needed to define a CA IDMS/DB database area.
If you want to maintain index records in a separate area, you must include one ADD AREA statement for each index area. Specify the ADD AREA statement with the GENERATE statement for the IPSB and with the GENERATE statements for the associated schema and subschema.
Syntax
►►─┬────────────────────────────────┬────────────────────────────────────────►    └─ ADD AREA NAME is area-name ───┘    ►─┬──────────────────────────────────────────────────────────────┬──────────►◄    └─ USAGE-mode is ──┬─ PROTECTED ──┬──┬─ RETRIEVAL ◄──┬─── . ───┘                       └─ EXCLUSIVE ──┘  └─ UPDATE ──────┘
Parameters
  • ADD AREA NAME IS
    area-name
    Specifies the CA IDMS/DB database area to be added.
    Area-name
    must be a 1- to 16-character 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
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
MODIFY RECORD Statement
The MODIFY RECORD statement allows you to specify a name for a generated record. The specified name overrides the name supplied by the syntax generator. Note that the default record names are derived from the corresponding DL/I segment names.
If the name of a record in the associated schema is different from the syntax generator-supplied name, you must include the MODIFY RECORD statement to supply the correct schema-specific record name.
Syntax
►►─┬──────────────────────────────────────┬──────────────────────────────────►    └─ MODify RECord NAME is record-name ──┘    ►─┬──────────────────────────────────────┬──────────────────────────────────►◄    └─ NEW NAME is new-record-name ─── . ──┘
Parameters
  • MODify RECord NAME is
    record-name
    Identifies the record for which you want to specify a new name.
    Record-name
    must be a 1- to 16-character name.
  • NEW NAME is
    new-record-name
    Specifies the new CA IDMS/DB database record name.
    New-record-name
    must be a valid 1- to 16-character CA IDMS/DB record name.
MODIFY SET Statement
The MODIFY SET statement allows you to specify a name for a generated set. The specified name overrides the name supplied by the syntax generator. Note that the default set names are derived from the DL/I parent segment names and their associated child segment names. The syntax generator concatenates each parent/child name pair with the literal "-".
If the name of a set in the associated schema is different from the syntax generator-supplied name, you must include the MODIFY SET statement to supply the correct schema-specific set name.
Syntax
►►─┬────────────────────────────────┬────────────────────────────────────────►    └─ MODify SET NAME is set-name ──┘    ►─┬───────────────────────────────────┬─────────────────────────────────────►◄    └─ NEW NAME is new-set-name ─── . ──┘
Parameters
  • MODify SET NAME is
    set-name
    Identifies the set for which you want to specify a new name.
    Set-name
    must be a 1- to 16-character name.
  • NEW NAME is
    new-set-name
    Specifies the new CA IDMS/DB database set name.
    New-set-name
    must be a valid 1- to 16-character CA IDMS/DB set name.