Conventions and terminology used in this document

The following sections discuss the conventions used in this document.

Typographical conventions

The following table explains the typographical conventions used in this document.

Table 1. Typographical conventions
Typeface Indicates Example
bold Commands, executable names, and compiler options. By default, if you use the -qsmp compiler option in conjunction with one of these invocation commands, the option -qdirective=IBM*:SMP$:$OMP:IBMP:IBMT will be on.
italics Parameters or variables whose actual names or values are to be supplied by the user. Italics are also used to introduce new terms. The maximum length of the trigger_constant in fixed source form is 4 for directives that are continued on one or more lines.
UPPERCASE bold Fortran programming keywords, statements, directives, and intrinsic procedures. The ASSERT directive applies only to the DO loop immediately following the directive, and not to any nested DO loops.
lowercase bold Lowercase programming keywords and library functions, compiler intrinsic procedures, file and directory names, examples of program code, command strings, or user-defined names. If you call omp_destroy_lock with an uninitialized lock variable, the result of the call is undefined.

How to read syntax diagrams

Throughout this document, diagrams illustrate XL Fortran syntax. This section will help you to interpret and use those diagrams.

If a variable or user-specified name ends in _list, you can provide a list of these terms separated by commas.

You must enter punctuation marks, parentheses, arithmetic operators, and other special characters as part of the syntax.

Sample syntax diagram

The following is an example of a syntax diagram with an interpretation:

Read syntax diagramSkip visual syntax diagram                                              .-,-.
           (1)                                V   |
>>-EXAMPLE-------char_constant--+-a-+--+---+----e-+------------->
                                '-b-'  +-c-+
                                       '-d-'
 
>--name_list---------------------------------------------------><
 
Notes:
  1. IBM Extension

Interpret the diagram as follows:

How to read syntax statements

Syntax statements are read from left to right:

Example of a syntax statement

EXAMPLE char_constant {a|b}[c|d]e[,e]... name_list{name_list}...

The following list explains the syntax statement:

Note:
The same example is used in both the syntax-statement and syntax-diagram representations.

Examples

The examples in this document are coded in a simple style that does not try to conserve storage, check for errors, achieve fast performance, or demonstrate recommended practice.

Some sample programs from this document and some other programs that illustrate ideas presented in this document are in the directory /opt/ibmcmp/xlf/10.1/samples.

Notes on the path names

The path names shown in this document assume the default installation path for the XL Fortran compiler. By default, XL Fortran will be installed in the following directory on the selected disk:

/opt/ibmcmp/xlf/10.1

You can select a different destination (relocation-path) for the compiler. If you choose a different path, the compiler will be installed in the following directory:

relocation-path/opt/ibmcmp/xlf/10.1

Notes on the terminology used

Some of the terminology in this document is shortened, as follows: