Application and Dialog Utilities › ADSOBCOM › COMPILE

COMPILE

Purpose

Either specifies the dialogs to be recompiled based on information in the load module, or specifies the dialogs to be added, modified, or deleted, based on information in the dialog statements that accompany the COMPILE statement.

There is no limit to the number of COMPILE statements that can be submitted to each run of ADSOBCOM.

Syntax

►►─── COMpile from ───────────────────────────────────────────────────────────►

               ┌──────────────────────┐
 ►─┬─ SOUrce ──▼── dialog-expression ─┴───────────────────────────────────────►─
   │
   └─ LOAD ─┬─ ALL ───────────────────────────────────────────────────────────
            │                       ┌────────────────────────┐
            └─ DIALog ─┬──────┬─ ( ─▼─  dialog-name-options ─┴─ ) ────────────
                       ├─ IS ─┤
                       └─ = ──┘

─►─────────────────────────────────────────────────────────────────┬── . ─────►◄
  ───────────────────────────────────────────────────────────────┬─┘
  ─┬───────────────────────────────────────────────────────────┬─┘
   │                         ┌───────────────────────────┐     │
   └─ VERsion ─┬──────┬── ( ─▼── version-number-options ─┴─ ) ─┘
               ├─ IS ─┤
               └─ =  ─┘

Expansion of dialog-name-options

►►─┬─ dialog-name ───────────────────────────────────────┬────────────────────►◄
   ├─ dialog-mask-value ─────────────────────────────────┤
   ├─ ( low-dialog-name  high-dialog-name ) ─────────────┤
   └─ ( low-dialog-mask-value  high-dialog-mask-value ) ─┘

Expansion of version-number-options

►►─┬─ version-number ──────────────────────────────┬──────────────────────────►◄
   └─ ( low-version-number  high-version-number ) ─┘

Parameters

SOUrce dialog-expression

Specifies that dialogs to be added, modified, or deleted based on information in the dialog expression.

Repeated dialog expressions can be used to process several dialogs. Each expression must end with a period.

See the explanation of dialog-expression on the following pages.

LOAD

Specifies that the dialogs are to be recompiled based on the information in the dialog load modules.

ALL

Specifies that all dialogs in the dictionary load area are to be recompiled.

DIALog is dialog-name-options

Specifies the dialogs in the dictionary load area to be recompiled. See expansion of dialog-name-options below.

VERsion is version-number-options

Specifies the version numbers of the dialogs to be recompiled. See expansion of version-number-options below.

dialog-name

Specifies the 1 to 8-character name of a single dialog.

dialog-mask-value

Specifies any dialog with a name that matches the mask criteria.

The mask character is the asterisk (*); it matches any character. For example, DIALOG IS (DCB*****) causes all dialogs beginning with DCB to be recompiled.

If the mask contains fewer than eight characters, the remaining character positions are treated as blanks.

(low-dialog-name high-dialog-name)

Specifies all dialogs within the dialog-name range (inclusive).

Note: Parentheses are needed when using a range of values.

(low-dialog-mask-value high-dialog-mask-value)

Specifies all dialogs within the dialog-mask range (inclusive).

Note: Parentheses are needed when using a range of values.

version-number

Specifies a single version number for the selected dialogs.

(low-version-number high-version-number)

Specifies all versions of the selected dialogs within the version-number range (inclusive).

Note: Parentheses are needed when using a range of values.

The default version number is 1.

Usage

Considerations

ADSOBCOM does not update a dialog's program definition element (PDE) to indicate that a new copy of the dialog exists in the load area. If a dialog is recompiled by ADSOBCOM and then executed during a single DC/UCF run, the application developer should update the PDE by issuing the following command:

DCMT VARY PROGRAM dialog-name NEW COPY

Note: For more information about the DCMT VARY PROGRAM command, see the CA IDMS System Tasks and Operator Commands Guide.