XL Fortran Enterprise Edition for AIX : User's Guide - IBM

-qci Option
Syntax
-qci=numbers
CI(numbers)
Specifies the identification numbers (from 1 to 255) of the INCLUDE lines to
process. 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.
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.
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.
Restrictions
Because the optional number in INCLUDE lines is not a widespread Fortran
feature, using it may restrict the portability of a program.
Related Information
See the section on the INCLUDE directive in the XL Fortran Enterprise Edition for
AIX Language Reference.
XL Fortran Compiler-Option Reference 141