Requirements and Options for Host Languages › Using SQL in a PL/I Application Program › INCLUDE IDMS MODULE statement › Parameters

Parameters

INCLUDE IDMS (module-name)

Copies procedure source statements defined by the DBA as modules in the dictionary. Module-name specifies the name of a module previously defined using the DDDL compiler.

Note: For more information about the DDDL compiler, see the CA IDMS IDD DDDL Reference Guide.

The available PL/I standard modules are:

• IDMS_STATUS
• IDMS_STATUS (mode is IDMS_DC)

The DML precompiler inserts the module into your program at the location of the INCLUDE IDMS MODULE statement, without modification.

You can nest INCLUDE IDMS MODULE statements. Code invoked by an INCLUDE IDMS MODULE entry can itself contain INCLUDE IDMS MODULE statements. However, make sure that a copied module does not copy itself.

VERSION version-number

Optionally qualifies module-name with a version number. Version-number must be an integer in the range 1 through 9999.

There are two defaults for version-number, depending on whether:

• There is a version of the module that you name with module-name which is operating-mode-specific. In this case, the default is the version number of this module. If there are two or more mode-specific versions of the module, version-number defaults to the highest version number among these versions.
• There is a version of the module that you name with module-name which is non-operating-mode-specific, and there exists no operating-mode-specific version. In this case, the default is the version number of this module. If there are two or more non-mode-specific versions of the module, version-number defaults to the highest version number among these versions.

If no version of the module exists in the dictionary, an error condition results.