-qci

Purpose

Specifies the identification numbers (from 1 to 255) of the INCLUDE lines to process.

Syntax


               .-:------.   
               V        |   
>>- -q--ci--=----number-+--------------------------------------><

@PROCESS:

@PROCESS CI(number,...,number)

Defaults

Not applicable.

Usage

This option allows a kind of conditional compilation because you can put code that is only sometimes needed (such as debugging WRITE statements, additional error-checking code, or XLF-specific code) into separate files and decide for each compilation whether to process them.

If an INCLUDE line has a number at the end, the file is only included if you specify that number in a -qci option. The set of identification numbers that is recognized is the union of all identification numbers that are specified on all occurrences of the -qci option.

Note:

Because the optional number in INCLUDE lines is not a widespread XL Fortran feature, using it may restrict the portability of a program.
This option works only with the XL Fortran INCLUDE directive and not with the #include C preprocessor directive.

Examples

REAL X /1.0/
INCLUDE 'print_all_variables.f' 1
X = 2.5
INCLUDE 'print_all_variables.f' 1
INCLUDE 'test_value_of_x.f' 2
END

In this example, compiling without the -qci option simply declares X and assigns it a value. Compiling with -qci=1 includes two instances of an include file, and compiling with -qci=1:2 includes both include files.

Related information

The INCLUDE directive