%XINCLUDE

Purpose

Incorporates text from other files into the current source file during compilation but the requested file is included only if it has not been included already.

Syntax

%XINCLUDE filename[,filename]…;

Parameters

filename: One of the following: a character string, an Open PL/I name, or an Open PL/I name enclosed in parentheses.
The specified filename is used to locate a text file whose content is inserted into the program text in place of the %XINCLUDE statement.

Description

%XINCLUDE is very similar to %INCLUDE because it incorporates text from other files into the current source file during compilation but the difference is that the requested file is included only if it has not been included already.

Example

%XINCLUDE 'FILE1','FILE2',(FILE3),(FILE4);

Restrictions

None.