Rational Developer for System z
PL/I for Windows, Version 8.0, Programming Guide

INCLUDE

This option specifies the file name extensions under which include files are searched. You specify the file name on the %INCLUDE statement and the directory search path on the IBM.SYSLIB or INCLUDE environment variables.

Read syntax diagramSkip visual syntax diagram>>-INCLUDE--(--+---------------------------+--)----------------><
               |         .-+---+------.    |
               |         | '-,-'      |    |
               |         V            |    |
               '-EXT--(----ext_string-+--)-'
 

ABBREVIATIONS: INC

The extension string (see the note on strings in step 2 under "Rules for using compile-time options") can be up to 31 characters long, but it is truncated to the first three characters.

If you specify more than one file name extension, the compiler searches for include files with the left most extension you specify first. It then searches for extensions which you specified from left to right. You can specify a maximum of 7 extensions.

DEFAULT: INCLUDE(EXT('INC' 'CPY' 'MAC')).

Do not use 'PLI' as an extension for include files.

Examples:

In this first example, the compiler searches for include files with file name extensions of COP, INC, 2++, and MAC in that order.

  include ( ext(Cop Inc '2++' Mac) )

In the following example, the compiler searches for include files without file name extensions first, and then for those with file name extensions of INC, CPY, and MAC.

  include (ext(' ',Inc,Cpy,Mac))
Rational Developer for System z
PL/I for Windows, Version 8.0, Programming Guide