forhelp FORTRAN — VMS FORTRAN_5.4
Invokes the VAX FORTRAN compiler to compile one or more source
programs. This command is described in detail in the "VAX FORTRAN
User Manual."
Format of FORTRAN command line:
FORTRAN file-spec-list
Any command qualifier that can accept options can also accept
either ALL (which includes all required and optional components) or
NONE (which includes none of the optional components).
If you specify more than one option, separate them by commas and
enclose the list in parentheses.
Additional information available:
ParametersQualifiersRelease Notes
/ANALYSIS_DATA/CHECK/CONTINUATIONS/CROSS_REFERENCE
/DEBUG/DESIGN/DIAGNOSTICS/D_LINES/DML/EXTEND_SOURCE
/F77/G_FLOATING/I4/LIBRARY/LIST/MACHINE_CODE
/OBJECT/OPTIMIZE/PARALLEL/SHOW/STANDARD/WARNINGS
Parameters
File-spec-list Specifies one or more VAX FORTRAN source programs to be compiled. If you do not specify a file type, the compiler uses the default file type of FOR. You can specify more than one input file. If you separate the file specifications with commas (,), each file is compiled separately and an object module is produced for each file. If you separate the file specifications with plus signs (+), the files are concatenated and compiled as a single input file, producing one object module and, if /LIST is specified, one listing.
Qualifiers
Indicate either special actions to be performed by the compiler or special input file properties. Compiler qualifiers can apply to either the FORTRAN command or the specification of the file being compiled. When a qualifier follows the FORTRAN command, it applies to all of the files listed. When a qualifier follows the file specification, it applies only to the file immediately preceding it.
/ANALYSIS_DATA[=file-spec] D=/NOANALYSIS_DATA
/[NO]ANALYSIS_DATA Controls whether the compiler generates a file containing analysis information about the source code being compiled. The default file name is the file name of the primary source file; the default file type is ANA (that is, filename.ANA). Source code analysis files are reserved for use with DIGITAL products such as, but not limited to, the VAX Source Code Analyzer.
/CHECK[=(option[,...])] D=/CHECK=(NOBOUNDS,OVERFLOW,NOUNDERFLOW)
/[NO]CHECK
Controls whether the compiler produces extra code to check for
certain error conditions at run time.
By default, if you omit the /CHECK qualifier entirely, the compiler
produces code to check only for integer overflow (equivalent to
/CHECK=(NOBOUNDS,OVERFLOW,NOUNDERFLOW)). However, if you specify
/CHECK without options, you obtain BOUNDS, OVERFLOW, and UNDERFLOW
checking (equivalent to /CHECK=ALL).
Note that /NOCHECK is equivalent to /CHECK=NONE.
[NO]BOUNDS Enables or disables bounds checking. If
/CHECK=BOUNDS, each dimension of an array reference
or substring subscript reference is checked to
determine whether it is within the range of the
dimension specified by the array or character
variable declaration. The default is NOBOUNDS.
[NO]OVERFLOW Enables or disables integer overflow traps. If
/CHECK=OVERFLOW, fixed-point calculations involving
BYTE, INTEGER*2, and INTEGER*4 data types are checked
for arithmetic overflow.
[NO]UNDERFLOW Enables or disables floating underflow exceptions.
If /CHECK=UNDERFLOW, error messages are issued for
the first two floating underflows. Regardless of the
setting of the UNDERFLOW qualifier, zero is stored as
the result which underflowed and the program
continues.
/CONTINUATIONS=n D=/CONTINUATIONS=19
/CONTINUATIONS Specifies the maximum number of continuation lines to be permitted. The number of lines, n, is a decimal number from 0 through 99. By default, the compiler accepts 19 continuation lines.
/CROSS_REFERENCE D=/NOCROSS_REFERENCE
/[NO]CROSS_REFERENCE Controls whether the compiler generates a cross-reference as part of the symbol table map. The default is /NOCROSS_REFERENCE which omits the cross-reference from the symbol map. The /CROSS_REFERENCE qualifier is ignored unless /LIST is specified, either explicitly or by default.
/DEBUG[=(option[,...])] D=/DEBUG=(NOSYMBOLS,TRACEBACK)
/[NO]DEBUG
Controls whether the compiler makes local symbol table and
traceback information available to the debugger and the run-time
error reporting mechanism.
By default, if you omit the /DEBUG qualifier entirely, the compiler
produces only an address correlation table (equivalent to
/DEBUG=(NOSYMBOLS,TRACEBACK)). However, if you specify /DEBUG
without any options, the default is both SYMBOLS and TRACEBACK
(equivalent to /DEBUG=ALL).
DIGITAL recommends that /NOOPTIMIZE also be used when debugging
FORTRAN programs.
For details on how to debug a VAX FORTRAN program with the VAX
Symbolic Debugger, see the "VAX FORTRAN User Manual."
Note that /NODEBUG is equivalent to /DEBUG=NONE.
[NO]SYMBOLS Controls whether the debugger receives local symbol
definitions for user-defined variables, arrays, and
labels on executable statements, and whether the
debugger receives source line correlation records.
The SYMBOLS option provides this information.
[NO]TRACEBACK Controls the production of compiler-generated line
numbers so that the debugger and the run-time error
traceback routine can translate virtual addresses
into source program subroutine names and line
numbers. The TRACEBACK option produces the line
numbers.
/DESIGN[=option,...]) D=/NODESIGN
/NODESIGN
Controls whether the compiler analyzes the program source for
design information in comment text and VAX Language Sensitive
Editor (LSE) placeholders.
By default, if you omit the /DESIGN qualifier entirely, the
compiler does not analyze comment text for design information and
treats LSE placeholders as invalid syntax (equivalent to
/DESIGN=(NOCOMMENTS, NOPLACEHOLDERS)). However, if you specify
/DESIGN without any options, the default is both COMMENTS and
PLACEHOLDERS (equivalent to /DESIGN=ALL).
In addition, if /ANALYSIS_DATA is also specified, information about
design information in comments and placeholders is added to the
analysis data file.
Note that /NODESIGN is equivalent to /DESIGN=NONE.
[NO]COMMENTS Controls whether the compiler analyzes comment
text for program design information, which is
written to the SCA analysis data file if
/ANALYSIS_DATA is also specified. Comment text
is scanned for tags as defined in the current VAX
Language Sensitive Editor environment file, and
information about tags found, text of tagged and
untagged comments, and their location in the
source is included with the SCA analysis data.
Use of /DESIGN=COMMENTS requires that the
optional VAX Source Code Analyzer product be
installed.
[NO]PLACEHOLDERS Controls whether the compiler accepts VAX Language
Sensitive Editor placeholders as replacements for
certain VAX FORTRAN language syntax. If
PLACEHOLDERS is in effect and placeholders are
found in a compilation unit, no diagnostics are
generated for the use of those placeholders;
however, no object code will be generated for the
compilation unit and an informational message to
that effect will be generated at the end of the
unit.
In addition, if /ANALYSIS_DATA is also specified,
information about placeholders and their uses is
included in the analysis data file.
If NOPLACEHOLDERS is in effect, placeholders will
be treated as invalid syntax.
/DIAGNOSTICS[=file-spec] D=/NODIAGNOSTICS
/[NO]DIAGNOSTICS Controls whether the compiler produces a file containing compiler messages and diagnostic information. The extension .DIA is the default file extension for a diagnostics file. The diagnostics file is reserved for use with Digital layered products such as the VAX Language Sensitive Editor.
/D_LINES D=/NOD_LINES
/[NO]D_LINES Indicates whether the compiler reads and compiles lines that have a D in column 1 of the source program. If you specify /D_LINES, lines that have a D in column 1 are compiled. The default is /NOD_LINES, which means the compiler assumes that lines beginning with a D are comments and does not compile them.
/DML
Controls whether the FORTRAN Data Manipulation Language preprocessor is invoked before the compiler. The preprocessor produces an intermediate file which is compiled. The /SHOW qualifier controls whether the expanded source generated by the preprocessor appears in the listing file. The default is not to invoke the DML preprocessor.
/EXTEND_SOURCE D=/NOEXTEND_SOURCE
/[NO]EXTEND_SOURCE Indicates whether the compiler will treat columns 7 through 72 or 7 through 132 as the statement field in FORTRAN source code lines.
/F77 D=/F77
/[NO]F77 Controls whether FORTRAN-77 interpretation rules are used for those statements that have a meaning that is incompatible with FORTRAN-66. The default is /F77. If you specify /NOF77, the compiler selects FORTRAN-66 interpretations in cases of incompatibility. For an explanation of the incompatibilities, see the "VAX FORTRAN User Manual."
/G_FLOATING D=/NOG_FLOATING
/[NO]G_FLOATING Controls the interpretation of REAL*8, COMPLEX*16, DOUBLE PRECISION, and DOUBLE COMPLEX declarations and constants. The default is /NOG_FLOATING, which causes the compiler to interpret the above declarations as the VAX D_floating data type. If you specify /G_FLOATING, the compiler interprets them as the VAX G_floating data type. See the "VAX FORTRAN User Manual" for more details.
/I4 D=/I4
/[NO]I4 Controls how the compiler interprets INTEGER and LOGICAL declarations that do not specify a length. If you specify /NOI4, the compiler interprets them as INTEGER*2 and LOGICAL*2, respectively. The default is /I4, which means the compiler interprets these declarations as INTEGER*4 and LOGICAL*4.
/LIBRARY
Indicates that an input file is a text library. The default file type for a text library is .TLB. The INCLUDE statement in a FORTRAN program allows you to extract modules from text libraries. The /LIBRARY qualifier can appear on one or more of the files in a list of files separated by plus signs. At least one of the files in the list must be a non-library file.
/LIST[=file-spec] D=/NOLIST
/[NO]LIST Controls whether a listing file is produced. If the FORTRAN command is executed from interactive mode, the compiler, by default, does not create a listing file. If the FORTRAN command is executed from batch mode, /LIST is the default. The compiler gives a listing file the same file name as the first input source file and a file type of LIS.
/MACHINE_CODE D=/NOMACHINE_CODE
/[NO]MACHINE_CODE Controls whether the listing produced by the compiler includes a symbolic representation of the object code generated by the compiler. The default is /NOMACHINE_CODE, which omits machine language code in the listing. The /MACHINE_CODE qualifier is ignored if /LIST is not specified, either explicitly or by default.
/OBJECT[=file-spec] D=/OBJECT
/[NO]OBJECT Controls whether the compiler produces an output object file. By default, the compiler produces an object file that has the same file name as the first input source file and a file type of OBJ.
/OPTIMIZE D=/OPTIMIZE
/[NO]OPTIMIZE Controls whether the compiler optimizes the compiled program to generate more efficient code. Use /NOOPTIMIZE in conjunction with the /DEBUG qualifier to link a VAX FORTRAN program with the debugger so that variables always contain their updated values.
/PARALLEL D=/NOPARALLEL
/[NO]PARALLEL Directs the VAX FORTRAN compiler to perform special processing required for program units involved in parallel-processing applications. Specifying /NOPARALLEL has the same effect as omitting the /PARALLEL qualifier; that is, compiler directive statements relating to parallel processing (DO_PARALLEL, PRIVATE, CONTEXT_SHARED, SHARED, LOCKON, LOCKOFF) are treated as comments and no object code to support execution of parallel DO loops is generated. Specifying /PARALLEL causes the compiler to interpret parallel-processing compiler directive statements in the source code and to generate object code to support execution of parallel DO loops.
/SHOW[=(option[,...])] D=/SHO=(NODICT,NOINCL,MAP,NOPREPROC,SINGL)
/[NO]SHOW
Controls listing file options.
The /SHOW qualifier is ignored if /LIST is not specified, either
explicitly or by default. The /SHOW=NOMAP qualifier is ignored if
/CROSS_REFERENCE is specified.
Note that /SHOW is equivalent to /SHOW=ALL and /NOSHOW is
equivalent to /SHOW=NONE.
[NO]DICTIONARY
Enable or disable inclusion in the listing file of source lines
from included Common Data Dictionary records.
[NO]INCLUDE
Enable or disable inclusion in the listing file of source lines
from files specified in INCLUDE statements. The [NO]LIST option
on the INCLUDE statement overrides the /SHOW=[NO]INCLUDE
qualifier on the FORTRAN command line.
[NO]MAP
Enable or disable inclusion of the symbol map in the listing
file.
[NO]PREPROCESSOR
Enable or disable inclusion of preprocessor-generated source
lines in the listing file.
[NO]SINGLE
Enable or disable the suppression of printing, in cross-reference
listings, the names of singly-used parameter constants (that is,
those that are not used outside their declarations). Suppression
can be beneficial when a small program specifies INCLUDE
declarations but uses only a small number of the parameter
constant names that are declared.
The default for the /SHOW qualifier is as follows:
/SHOW=(NODICTIONARY,NOINCLUDE,MAP,NOPREPROCESSOR,SINGLE)
/STANDARD[=(option[,...])] D=/NOSTANDARD
/[NO]STANDARD Controls whether the compiler produces informational diagnostics for some extensions to ANSI X3.9-1978 (FORTRAN-77). If you specify /STANDARD with no arguments, it is equivalent to /STANDARD=(SYNTAX, NOSOURCE_FORM, SEMANTIC). The /STANDARD qualifier has effect only if you specify /WARNINGS, either explicitly or by default. Note the difference between the /STANDARD and /F77 qualifiers. The /STANDARD qualifier causes diagnostics to be produced for non-standard features. The /F77 qualifier causes the FORTRAN 77 interpretation to be chosen for constructs which mean different things in FORTRAN-77 and previous versions of VAX FORTRAN. /NOSTANDARD is equivalent to /STANDARD=NONE. [NO]SEMANTIC Produce informational messages for ANSI standard conforming statements that become nonstandard due to the way in which they are used. Data type information and statement locations are considered when determining semantic extensions. Specifying SEMANTIC checking also enables SYNTAX checking to be performed. [NO]SYNTAX Produce informational diagnostics for syntax extensions to the current ANSI standard that occur within individual statements in a program unit. [NO]SOURCE_FORM Produce informational diagnostics for lowercase source and leading tab characters.
/WARNINGS[=(option[,...])] D=/WARN=(GEN,NODECLAR,NOULTRIX,NOVAXELN)
/[NO]WARNINGS Specifying /WARNINGS without arguments has the same effect as omitting the qualifier and taking the default. [NO]GENERAL Controls whether the compiler produces diagnostic messages for W-level (warning) and I-level (informational) conditions. [NO]DECLARATIONS Acts as an external IMPLICIT NONE switch. If DECLARATIONS is set, the compiler will print warnings for any untyped data items used in the program. [NO]ULTRIX Causes the compiler to issue diagnostics for language features not supported by VAX FORTRAN on ULTRIX systems. Through the use of this option, you can develop VAX FORTRAN programs on a VMS system and use those programs - without modification - on both ULTRIX and VMS systems. [NO]VAXELN Causes the compiler to issue diagnostic messages for language features not supported by VAX FORTRAN on a VAXELN system. ALL Causes the compiler to print all informational and warning messages, including warning messages for any untyped data items. NONE Suppresses all informational and warning messages.
Release Notes
Please refer to SYS$HELP:FORT%%%.RELEASE_NOTES for VAX FORTRAN release notes.