Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

Release Notes

/ANALYSIS_DATA

/CHECK

/CONTINUATIONS

/CROSS_REFERENCE

/DEBUG

/DIAGNOSTICS

/D_LINES

/DML

/EXTEND_SOURCE

/F77

/G_FLOATING

/I4

/LIBRARY

/LIST

/MACHINE_CODE

/OBJECT

/OPTIMIZE

/PARALLEL

/SHOW

/STANDARD

/WARNINGS

forhelps FORTRAN — VMS FORTRAN_5.2

 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/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.

/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,NOULTR,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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026