Include preprocessor

The include preprocessor allows you to incorporate external source files into your programs by using include directives other than the PL/I directive %INCLUDE.

The following syntax diagram illustrates the options supported by the INCLUDE preprocessor:

Read syntax diagramSkip visual syntax diagramPP(INCLUDE('ID(<directive>) '))
ID
Specifies the name of the include directive. Any line that starts with this directive as the first set of nonblank characters is treated as an include directive.

The specified directive must be followed by one or more blanks, an include member name, and finally an optional semicolon. Syntax for ddname(membername) is not supported.

In the following example, the first include directive is valid and the second one is not:
  ++include payroll
  ++include syslib(payroll)

Example 1

The following example causes all lines that start with -INC (and possibly preceding blanks) to be treated as include directives:
  pp( include( 'id(-inc)'))

Example 2

The following example causes all lines that start with ++INCLUDE (and possibly preceding blanks) to be treated as include directives:
  pp( include( 'id(++include)'))