Introduction to Process Commands › INCLUDE

INCLUDE

Purpose

Inserts stored process source code into another process at compile time.

Syntax

►►────── INClude ───┬────────────┬───┬──────┬── process-name ─────────────────►
                    └┬─ MODule ─┬┘   ├─ IS ─┤
                     └─ PROCESS─┘    └─ =  ─┘

 ►────┬──────────────────────────────────────────┬── . ───────────────────────►◄
      └─┬────────────────────┬── version-number ─┘
        └─ VERsion ─┬──────┬─┘
                    ├─ IS ─┤
                    └─ = ──┘

Parameters

MODule is process-name

Causes the source code of the named process module to be inserted logically in the current process source code at compile time. The process module itself is not changed. At runtime, CA ADS executes the process as if the included code were coded in the process itself.

Process-name must name a module occurrence in the data dictionary. The module is defined with an IDD DDDL ADD PROCESS statement or an ADD MODULE statement with the attribute LANGUAGE IS PROCESS.

VERsion is version-number

Indicates the version number associated with the included process module. If not specified, version-number defaults to the default version number set in the dictionary.

Usage

Considerations

• The included source code must be stored in the data dictionary as a process module.
• INCLUDE commands can be nested.
• INCLUDE cannot be used recursively. An INCLUDE statement cannot reference a process that is already in the nested INCLUDE structure.
• A process cannot include itself. For example, if process A includes process B and process B includes process C, then process C cannot include process A, B, or C.
• The INCLUDE statement must be contained entirely on one process code line.
• Any other process commands entered on the same line as the INCLUDE statement must precede INCLUDE.
• An INCLUDE statement can be followed by comments on the same line.

Example

The following example illustrates the use of the INCLUDE command:

Process: CUST-NUM-CHECK
MOVE CUST-NUM TO A.
INCLUDE MODULE VALUE-CHECK.
RETURN.
Process: VALUE-CHECK
IF A = 1
THEN
    DISPLAY.
ELSE
    LINK TO 'LINKDIAL'.

If the application developer specifies CUST-NUM-CHECK as a premap or response process using the CA ADS dialog compiler (ADSC), on the Process Modules screen, the following process source code will logically be compiled:

MOVE CUST-NUM TO A.
IF A = 1
THEN
    DISPLAY.
ELSE
    LINK TO 'LINKDIAL'.
RETURN.