OE | NOOE

Pragma equivalent

None.

Purpose

Specifies the rules used when searching for files specified with #include directives.

Syntax

Defaults

NOOE

When compiling in the z/OS® UNIX System Services Shell environment, the default is OE.

Parameters

filename: Specifies the path that is used when searching for files specified with #include directives.
Note: Diagnostics and listing information will refer to the file name that is specified for the OE option (in addition to the search information).

Usage

When the OE compiler option is in effect, the compiler uses the POSIX.2 standard rules when searching for files specified with #include directives. These rules state that the path of the file currently being processed is the path used as the starting point for searches of include files contained in that file.

The NOOE option can optionally take a filename suboption. This filename then becomes the default. If you subsequently use the OE option without a filename suboption, the compiler uses the filename that you specified in the earlier NOOE.

Example: The following specifications have the same result:

xlc hello.c -qnooe=./hello.c -qoe

xlc hello.c -qoe=./hello.c

If you specify OE and NOOE multiple times, the compiler uses the last specified option with the last specified suboption.

Example:The following specifications have the same result:

xlc hello.c -qnooe=./hello.c -qoe=./n1.c -qnooe=./test.c -qoe

xlc hello.c -qoe=./test.c

When the OE option is in effect and the main input file is a z/OS UNIX file, the path of filename is used instead of the path of the main input file name. If the file names indicated in other options appear ambiguous between z/OS and the z/OS UNIX file system, the presence of the OE option tells the compiler to interpret the ambiguous names as z/OS UNIX file names. User include files that are specified in the main input file are searched starting from the path of filename. If the main input file is not a z/OS UNIX file, filename is ignored.

For example, if the compiler is invoked to compile a z/OS UNIX file /a/b/hello.c it searches directory /a/b/ for include files specified in /a/b/hello.c, in accordance with POSIX.2 rules . If the compiler is invoked with the OE(/c/d/hello.c) option for the same source file, the directory specified as the suboption for the OE option, /c/d/, is used to locate include files specified in /a/b/hello.c.

IPA effects

On the IPA link step, the OE option controls the display of file names.

Predefined macros