DECwindows Compiler Interface for FORTRAN — VMS FORTRAN_5.4
Additional information available:
<label>commandsconfig list boxconfig namedcl subwindow
helphidemain push buttonsoptionsopt push but
=title Compile a FORTRAN Program
commands
=title Commands Pull down the Commands menu to exit from the DWCI dialog box. Help information on the menu item in the Commands pull-down menu is available below under additional topics.
Additional information available:
quit
=title Quit Choose the Quit menu item to cancel the compilation and return to the window from which you invoked the dialog box, for example, a FileView window. (Choosing this menu item has the same effect as choosing the Cancel button in the main dialog box.)
config list box
=title Configurations
Each name in the Configurations list box is the name of
a set of compilation options. To reuse a particular
set of options, you choose its name and click on the
Apply button.
The first time you access the DWCI dialog box, the only
configuration name in the Configurations list box is
Product_Default, the name for the default option
settings.
Take the following steps to establish other named sets
of compilation options:
1. Pull down the Options menu, select a menu item, and
click on the options that you want establish for a
particular configuration. The name in the Applied
Configuration dialog box changes to "**unnamed**"
when you click on either the OK button or the Apply
button associated with the option displays.
2. Completely erase the character string "**unnamed**"
from the Applied Configuration dialog box, and type
the name that you want to assign to that
configuration. If you type the original name (or
any other name displayed in the Configurations list
box), the new configuration of options replaces the
old configuration of options associated with that
name.
3. Click on the Add button to add the name to the list
in the Configurations list box.
The VAX FORTRAN compiler's default option settings are
established as the default configuration the first time
you invoke the DWCI dialog box. For subsequent
invocations, the last previously applied configuration
is used as the default.
To establish a new current configuration, select the
desired name in the Configurations list box and click
on the Apply button.
To delete a named configuration from the Configurations
list box, select the name that you want to delete and
click on the Delete button.
Help information on the buttons associated with the
Configurations list box is available below under
additional topics.
Additional information available:
apply delete
=title Delete and Apply Buttons
Click on the Delete button to delete a configuration
that you have selected in the Configurations list box.
Click on the Apply button to establish a selected
configuration in the Configuration list box as the
current configuration. This causes the selected name
to appear in the Applied Configuration dialog box. You
can then perform the following operations:
o Initiate a compilation by clicking on the OK
button. (The compilation is governed by the option
settings associated with the current
configuration.)
o Modify the option settings for the current
configuration by using the Options pull-down menu.
After modifying the option settings for the current
configuration, you can then use the new, modified
configuration in the following ways:
- You can establish the new set of options as a
replacement for the old set. Type the old name
in the Applied Configuration dialog box and
click on the Add button. Note that option
settings for the configuration Product_Default
cannot be modified.
- You can establish the new set of options as a
new, permanent configuration.
Type a new name in the Applied Configuration
dialog box and click on the Add button.
- You can use the new set of options as a
temporary configuration.
Initiate a compilation by clicking on the OK
button. The new set of options govern that
compilation but are not saved by DWCI.
config name
=title Applied Configuration
The Applied Configuration dialog box contains the name
of the configuration of compilation options that is
currently in effect. Clicking on the OK button in the
main dialog box initiates a compilation governed by
these options.
Product_Default, the name of the product-supplied
default configuration, appears in the Applied
Configuration dialog box the first time DWCI is invoked
(that is, the first time you issue a compilation
request from, for example, a FileView window). For
subsequent invocations, the established configuration
that was current at the time of the previous
compilation is used.
You can use the Applied Configuration dialog box in the
following ways:
o To change to another established configuration,
select its name from the Configurations list box
and click on the Apply button.
o To establish a new configuration of compilation
options, modify the options associated with the
current configuration using the Options pull-down
menu.
When you change a compilation option setting, the
name of the current configuration immediately
changes to "**unnamed**". At this point, you have
several options:
- You can delete the character string
"**unnamed**", type the name that you want to
assign to the new configuration, and click on
the Add button.
The new configuration name then appears in the
Configurations list box (and is available for
future use).
- You can use the new configuration to control a
single compilation.
To use a new configuration in this way, click
on the OK button -- without typing in a name
and clicking on the Add button. Under these
circumstances, the configuration is in effect
only for a single compilation. It is not
retained as a permanent configuration (that is,
its name does not appear in the Configurations
list box).
If you type the name of an existing configuration, the
new configuration assumes that name, replacing the
existing configuration. This allows you to modify
option settings for an established configuration.
The equivalent FORTRAN command that you would issue at
the DCL interface level to achieve the same effect as
the current configuration's option settings is shown in
the subwindow at the bottom of the main dialog box.
Double click on the item under additional topics to
obtain more help information about adding
configurations to the Configurations list box for
future use.
Additional information available:
add
=title Add Click on the Add button to establish the configuration of option settings identified in the Applied Configuration dialog box as a permanent configuration for future use. The name of the configuration is added to the Configurations list box after you click on the Add button. If the name in the Applied Configuration dialog box is the same as a name in the Configurations list box, the configuration of options associated with the name in the Configurations list box is replaced by the new configuration.
dcl subwindow
=title Command (DCL command subwindow) The Command subwindow shows the DCL-level FORTRAN command that would produce the same effect as the currently applied configuration of compilation options. Whenever you modify any of the compilation options associated with the current configuration, the command line in the Command subwindow is updated to reflect the change.
help
=title Help
Pull down the Help menu to do the following:
o Find out information about the compiler: its name,
version number, release date, and copyright notice
o Get an overview of how to use the DECwindows
Compiler Interface (DWCI)
Help information on the menu items in the Help
pull-down menu is available below under additional
topics. To view the help information on an additional
topic, double click on the topic.
Additional information available:
about
=title About VAX FORTRAN =include Help Overview VAX FORTRAN Version 5.4 Copyright © 1989 by Digital Equipment Corporation All Rights Reserved Double click on Overview (in the Additional Topics section of the Help window) for a general description of the DECwindows Compiler Interface (DWCI).
Additional information available:
more about
=title Additional Trademark and Product Information The help information provided with this product is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in the help text. The software product associated with the help text is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. The following are trademarks of Digital Equipment Corporation: CDA MASSBUS VAX RMS DDIF PrintServer 40 VAXstation DEC Q-bus VMS DECnet ReGIS VT DECUS ULTRIX XUI DECwindows UNIBUS DIGITAL VAX LN03 VAXcluster PostScript is a registered trademark of Adobe Systems, Inc.
overview
=title Overview
The DECwindows Compiler Interface (DWCI) and DCL-level
compilation commands perform similar functions. You
can select compilation options and activate a compiler
using either interface.
Using DWCI, you can establish several named sets of
compilation options. The compilation options
associated with a particular name remain in effect
until you change them. Thus, you can use a particular
set of options repeatedly, without having to
reestablish option settings using the Options pull-down
menu. The names in the following list are examples of
names you might specify:
o Debug (for interactive debugging situations)
o Full_Optimization (for debugged applications ready
for running)
o Fast (for syntax checking; no object-code
generation)
The names appear in the Configurations list box. To
place one of these names in effect as the current
configuration, select a name and click on the Apply
button.
The product-specified default options are included in
the Configurations list box under the name
Product_Default. This is the only name that is
predefined; the names for the compilation
configurations that you establish are defined by you.
The Applied Configuration dialog box contains the name
of the set of compilation options that go into effect
when you click on the OK button to initiate a
compilation. The subwindow at the bottom of the main
dialog box shows the FORTRAN command line that is
equivalent to the option configuration identified in
the Applied Configuration dialog box.
Help information on common user tasks, help, and
unsupported compilation options is available under
additional topics. For information on how to establish
and use a configuration of compilation options, double
click on the topic Common User Tasks and then double
click on the topic Applied Configuration.
Additional information available:
common user tasksusing helpunsupported compilation options
common user tasks
=title Common User Tasks
=include options
=include config_list_box
=include config_name
=include hide
=include main_push_buttons
=include dcl_subwindow
The following list describes common user tasks and the
screen objects associated with them:
o To exit from the DWCI dialog box and begin
compilation of the selected files, using the
compilation options as displayed, click on the OK
button or press the Return key.
o To cancel the compile operation and return to
FileView, click on the Cancel button or select the
Quit menu item in the Commands pull-down menu.
o To select compilation options, pull down the
Options menu and choose the desired option
categories.
o To establish selected compilation options as a
named configuration, type the name in the Applied
Configuration dialog box and click on the Add
button.
o To change the current configuration to another
configuration, select the name of a configuration
in the Configurations list box and click on the
Apply button.
o To display the FORTRAN command (DCL interface) that
is equivalent to the option settings for a given
configuration, select the configuration from the
Configurations list box and click on the Apply
button. This causes the equivalent FORTRAN command
line to appear in the Command subwindow at the
bottom of the main dialog box. (The subwindow
always displays the FORTRAN command line for the
configuration identified in the Applied
Configuration dialog box.)
o To have the current configuration used
automatically for future compilations using this
language, click on the Hide This Dialog button.
Later, when you wish to bring up the DWCI dialog
box to change the configuration, hold down the
Shift key while clicking on the FileView Compile
button.
Help information on the screen objects associated with
these tasks is available below under additional topics.
using help
=title Using Help
Information on how to obtain help on any active screen
object in the DWCI dialog box can be accessed as
follows:
1. Select the Help menu item in the Help pull-down
menu in this window (not in the DWCI dialog box).
2. Double click on "What is Context-Sensitive Help?"
under additional topics.
For options (Option List... items) that are
inaccessible (dimmed image on screen), you cannot
obtain help by using the method for active screen
objects. To view help for an option that is
inaccessible, obtain the help frame for the menu item
that produced the auxiliary dialog box. Then, double
click on the appropriate title in the Additional Topics
section of the help window.
The help frames for the inaccessible options explain
which options affect their accessibility.
unsupported compilation options
=title Unsupported Compilation Options
The following list contains command-line compilation
options not supported by DWCI:
o "Plus" lists and nonalphabetical "comma" lists of
file names are not supported by DWCI. (When you
specify multiple file names using a command-line
interface and you separate them by plus signs (+),
the files are concatenated and compiled as one
program. When you separate the file names by
commas (,), the programs are compiled separately.)
You must use the DCL interface if you want to
either compile multiple files as a single program
or compile them separately in a sequence other than
that shown in the FileView window.
You can select more than one file from the FileView
window (as with a "comma" list), but you cannot
change the order in which they are compiled; they
are compiled in the order shown.
o If you have a library of VAX FORTRAN source modules
that you want to include in a compilation, you must
use the DCL interface; the /LIBRARY qualifier has
no equivalent in DWCI.
hide
=title Hide This Dialog Click on the Hide This Dialog button to indicate that you do not wish to see the DWCI dialog box on subsequent requests from FileView Compile. In this mode, all subsequent Compile requests will use the configuration in effect when you click on the OK button in the DWCI dialog box. To cancel the Hide function from FileView, hold down the Shift key while clicking on the Compile button.
main push buttons
=title Cancel and OK Buttons
=include options options_list
The Cancel and OK buttons have the following effects:
o Cancel Button -- Click on the Cancel button to
cancel the compilation and return to the window
from which you invoked the DWCI dialog box, for
example, a FileView window.
o OK Button -- Click on the OK button to start the
compilation process. The compiler uses the current
configuration of compilation options, which is
identified by the Applied Configuration dialog box.
To review the options associated with the current
configuration, you have two choices:
- You can examine the FORTRAN command line (DCL
level) that appears in the subwindow at the
bottom of the main dialog box. The qualifiers
shown on the command line are equivalent to the
options established for the current
configuration.
- You can pull down the Options menu, select
pertinent menu items, and examine the option
settings established for them.
A table that maps DCL-level qualifiers to option
categories in the Options pull-down menu is
available below under additional topics.
options
=title Options Pull down the Options menu to review or change compilation options. To modify any of the options associated with the current configuration, choose the appropriate category of options from the Options pull-down menu. When you choose an options category, an auxiliary dialog box appears. You use that auxiliary dialog box to establish settings for individual compilation options. Option categories are listed below under additional topics.
Additional information available:
options listlistingtoolsgenerationdatasourcehigh performance
options list
=title List of Options (by option category)
--------------------------------------------------------
Options Category Options (Equivalent
(Options Menu) DCL Qualifiers)
--------------------------------------------------------
Listing Options... /CROSS_REFERENCE
/LIST
/MACHINE_CODE
/SHOW
/STANDARD
/WARNINGS
Tool Options... /ANALYSIS_DATA
/DESIGN
/DIAGNOSTICS
/DML
Object Code Options... /CHECK
/DEBUG
/OBJECT
/OPTIMIZE
Data Interpretation Options... /G_FLOATING
/I4
Source Interpretation Options... /CONTINUATIONS
/D_LINES
/EXTEND_SOURCE
/F77
High-Performance Options... /PARALLEL
listing
=title Listing Options... Choose the Listing Options... menu item to review or change any of the compilation options that affect the contents of output listing files or diagnostic messages produced during compilation. All of the categories of listing options are included below under additional topics. To view help information on a particular category, double click on it.
Additional information available:
list
=title Produce a Listing File
Click on the Produce a Listing File button to direct
the compiler to produce a listing of the source file.
By default, the listing file is given the name of the
source file plus the .LIS extension. Optionally, you
can change the file name to any valid name of your
choice.
If you are compiling multiple files and you type in a
file name, each listing file is given that name (with
an incremental version number).
Equivalent qualifier (DCL interface):
/[NO]LIST[=file-spec]
show
=title Show in Listing Click on buttons in the Show in Listing options list to set or cancel specific options that determine the contents of the listing file produced by the compiler. The Show in Listing option is inaccessible when the Produce a Listing File button is off. (The Produce a Listing File button is in the options list associated with the Listing Options... menu item.) Help information on the individual options for Show in Listing is available below under additional topics.
Additional information available:
dictionarycross referenceincludemachine codepreprocessorsymbols
unreferenced constants
dictionary
=title CDD Definitions
Click on the CDD Definitions button to include, in the
listing file, source code from Common Data Dictionary
records specified in DICTIONARY statements.
Equivalent qualifier (DCL interface):
/SHOW=[NO]DICTIONARY
cross reference
=title Cross Reference
Click on the Cross Reference button to include, in the
listing file, the line numbers for each variable used
in the program.
Equivalent qualifier (DCL interface):
/[NO]CROSS_REFERENCE
include
=title Include File Content
Click on the Include File Content button to include, in
the listing file, source code from files specified in
INCLUDE statements.
The [NO]LIST option on the INCLUDE statement overrides
the Include File Content button.
Equivalent qualifier (DCL interface):
/SHOW=[NO]INCLUDE
machine code
=title Machine Code
Click on the Machine Code button to include, in the
listing file, a symbolic representation of the object
code generated by the compiler. Generated code and
data are represented in a form similar to VAX MACRO
assembler language. Do not attempt to assemble the
object code presented in the listing file; some of the
code is not supported by the VAX MACRO assembler.
Equivalent qualifier (DCL interface):
/[NO]MACHINE_CODE
preprocessor
=title Preprocessor Source
Click on the Preprocessor Source button to include
preprocessor-generated source code in the listing file.
Equivalent qualifier (DCL interface):
/SHOW=[NO]PREPROCESSOR
symbols
=title Symbol Table
Click on the Symbol Table button to include the symbol
map in the listing file.
The Symbol Table option is inaccessible when the Cross
Reference button is on.
Equivalent qualifier (DCL interface):
/SHOW=[NO]MAP
unreferenced constants
=title Unreferenced Constants
Click on the Unreferenced Constants button to print, in
the storage map section of the listing file, the names
of singly-used parameter constants (that is, those
parameter constants that are not used outside their
declarations).
Not printing the names 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 Unreferenced Constants option is inaccessible when
the Cross Reference button is off.
Equivalent qualifier (DCL interface):
/SHOW=[NO]SINGLE
warnings
=title Compiler Warnings Click on buttons in the options list for the Compiler Warnings menu item to set or cancel options that control whether the compiler issues diagnostic messages for I-level (informational) and W-level (warning) classes of messages. Help information on the individual options for Compiler Warnings is available below under additional topics.
Additional information available:
declarations
=title Undeclared Variables
Click on the Undeclared Variables button to direct the
compiler to issue warning diagnostic messages for any
untyped data items used in the program. In this way,
the Undeclared Variables button acts as an external
IMPLICIT NONE statement.
Equivalent qualifier (DCL interface):
/WARNINGS=[NO]DECLARATIONS
Ultrix
=title Non-Ultrix Features
Click on the Non-ULTRIX Features button to direct the
compiler to issue warning diagnostic messages for
language features not supported by VAX FORTRAN on
ULTRIX systems. By using this option, you can develop
VAX FORTRAN programs on a VMS system and use those
programs -- without modification -- on both ULTRIX and
VMS systems.
Equivalent qualifier (DCL interface):
/WARNINGS=[NO]ULTRIX
VAXELN
=title Non-VAXELN Features
Click on the Non-VAXELN Features button to direct the
compiler to issue warning diagnostic messages for
language features not supported by VAX FORTRAN on a
VAXELN system.
Equivalent qualifier (DCL interface):
/WARNINGS=[NO]VAXELN
other
=title Other Warnings
Click on the Other Warnings button to direct the
compiler to issue diagnostic messages for I-level
(informational) and W-level (warning) conditions
detected in the source code.
Equivalent qualifier (DCL interface):
/WARNINGS=[NO]GENERAL
standard
=title FORTRAN 77 Standard Conformance Checking Click on buttons in the options list for FORTRAN 77 Standard Conformance Checking to set or cancel options that control whether the compiler issues informational diagnostic messages (I-level messages) when it detects coding in source statements that does not conform to ANSI standards. If you are using a FORTRAN compiler that rigidly conforms to ANSI standards, such source statements will not compile properly. Help information on the options governing conformance checking is available below under additional topics.
Additional information available:
semantic
=title Nonstandard Semantics
Click on the Nonstandard Semantics and Syntax button to
direct the compiler to issue informational diagnostic
messages when it detects the following:
o ANSI standard conforming statements that become
nonstandard because of the way in which they are
used -- semantics checking
o Source statements that contain syntax extensions to
the current ANSI standard -- syntax checking
Data type information and statement locations are
considered when determining semantic extensions.
For syntax checking only, click on the Nonstandard
Syntax button.
Equivalent qualifier (DCL interface):
/STANDARD=[NO]SEMANTIC
source form
=title Nonstandard Source Form
Click on the Nonstandard Source Form button to direct
the compiler to issue informational diagnostic messages
about source statements that use tab formatting or
contain lowercase characters.
Equivalent qualifier (DCL interface):
/STANDARD=[NO]SOURCE_FORM
syntax
=title Nonstandard Syntax
Click on the Nonstandard Syntax button to direct the
compiler to issue informational diagnostic messages for
source statements that contain syntax extensions to the
current ANSI standard.
The compiler also performs this syntax checking if the
Nonstandard Semantics and Syntax button is on.
Equivalent qualifier (DCL interface):
/STANDARD=[NO]SYNTAX
tools
=title Tool Options...
Choose the Tool Options... menu item to review or
change the option settings that determine whether the
FORTRAN Data Manipulation Language (DML) preprocessor
is invoked or if output files containing the following
types of information are created:
o Cross-reference and static-analysis information
(.ANA files)
o Compiler messages and diagnostics information (.DIA
files)
o Program design information from comments and
placeholders (.ANA files)
These files are reserved for use by Digital layered
products.
Help information on the tool options is available below
under additional topics.
Additional information available:
analysis datadiagnosticsdesign
analysis data
=title Produce an SCA Analysis Data File
=include options tools design comments
=include options tools design placeholders
Click on the Produce an SCA Analysis Data File button
to generate a file containing cross-reference and
static-analysis information about the source code.
Analysis data files are reserved for use by Digital
layered products (for example, the VAX Source Code
Analyzer).
If you also click on the Enable Comment Analysis or
Enable Placeholder Analysis buttons, the compiler scans
for program design information in comment text and
placeholders and includes this information in the SCA
analysis data file. (Help information on the Enable
Comment Analysis and Enable Placeholder Analysis
options are available below under additional topics.)
By default, the SCA analysis data file is given the
name of the source file plus the .ANA extension.
Optionally, you can change the file name to any valid
name of your choice.
The compiler produces one analysis file for each source
file that it compiles. If you are compiling multiple
files and you type in a file name, each analysis file
is given that name (with an incremental version
number).
Equivalent qualifier (DCL interface):
/[NO]ANALYSIS_DATA[=filespec]
diagnostics
=title Produce an LSE Diagnostics File
Click on the Produce an LSE Diagnostics File button to
generate a file containing compiler messages and
diagnostic information about the source code.
Diagnostics files are reserved for use by Digital
layered products (for example, the VAX
Language-Sensitive Editor).
By default, the LSE diagnostics file is given the name
of the source file plus the .DIA extension.
Optionally, you can change the file name to any valid
name of your choice.
The compiler produces one diagnostics file for each
source file it compiles. If you are compiling multiple
files and you type in a file name, each diagnostics
file is given that name (with an incremental version
number).
Equivalent qualifier (DCL interface):
/[NO]DIAGNOSTICS[=filespec]
design
=title Program Design Processing Click on buttons in the options list for Program Design Processing to set or cancel options that control whether the compiler analyzes the source program for design information in comment text or LSE (Language Sensitive Editor) placeholders. If you click on these buttons and the Produce an SCA Analysis Data File button, information about design information in comments and placeholders is added to the analysis data file. Help information on the Program Design Processing options is available below under additional topics.
Additional information available:
comments
=title Enable Comment Analysis
=include options tools analysis_data
Click on the Enable Comment Analysis button to analyze
the text of each comment -- either full-line or
end-of-line comment -- for program design information.
Comment text is scanned for tags that are defined in
the current VAX Language Sensitive Editor environment
file. Certain tags are predefined by LSE; however, you
can add, change, or remove tags as desired. (See the
VAX Language Sensitive Editor documentation for
details.)
If you also click on the Produce an SCA Analysis Data
File button, information about tags found, text of
tagged and untagged comments, and their locations in
the source file is included in the SCA analysis data
file. You can then use SCA and LSE commands to
retrieve the design information. (Help information on
the Produce an SCA Analysis Data File option is
available below under additional topics.)
The compiler reports any errors detected by comment
analysis routines at compile time. If LSE is not
installed or if a severe error is reported by the
comment analysis routines, the compilation is aborted.
Comments beginning with a "D" or "d" in column 1 are
not examined for program design information.
Equivalent qualifier (DCL interface):
/DESIGN=[NO]COMMENTS
placeholders
=title Enable Placeholder Analysis
=include options tools analysis_data
Click on the Enable Placeholders Analysis button to
instruct the compiler to treat VAX Language-Sensitive
Editor placeholders (in well-defined contexts) as valid
program syntax.
If you also click on the Produce an SCA Analysis Data
File button, information about placeholders and their
use is included in the SCA analysis data file.
If LSE placeholders are present in the source file and
you do not click on the Enable Placeholder Analysis
button, the compiler will treat the placeholders as
invalid syntax and generate an error message.
When placeholder analysis is performed, the compiler
does not generate object code for those program units
that contain placeholders. Object code is generated,
however, for those program units that do not contain
placeholders.
Equivalent qualifier (DCL interface):
/DESIGN=[NO]PLACEHOLDERS
DML
=title Invoke DML Preprocessor
Click on the Invoke DML Preprocessor button to invoke
the FORTRAN Data Manipulation Language preprocessor
before the compiler is invoked. The preprocessor
produces an intermediate file that is subsequently
compiled by the compiler.
The Preprocessor Source button in the Show in Listing
options list (Listing Options... menu) controls
whether the expanded source generated by the
preprocessor appears in the listing file.
Equivalent qualifier (DCL interface):
/[NO]DML
generation
=title Object Code Options...
Choose the Object Code Options... menu item to review
or adjust the settings of compilation options that
control the following:
o Whether to produce an output object file
o Whether to include information in the object file
for use by the VMS Debugger
o Whether to optimize the machine code that is
generated
Help information on the object code options is
available below under additional topics.
Additional information available:
object
=title Produce an Object File
Click on the Produce an Object File button to produce
an object file.
By default, the object file is given the name of the
source file plus the .OBJ extension. Optionally, you
can change the file name to any valid name of your
choice.
If you are compiling multiple files and you type in a
file name, each object file is given that name (with an
incremental version number).
Equivalent qualifier (DCL interface):
/OBJECT[=file-spec]
optimize
=title Produce Optimized Code
Click on the Produce Optimized Code button to direct
the compiler to generate optimized machine-language
code.
Do not turn on the Optimize button for compilations
that will require debugging. Variables in optimized
code may not always contain their updated values.
Equivalent qualifier (DCL interface):
/[NO]OPTIMIZE
debug
=title Debugger Information Generation Click on buttons in the Debugger Information Generation options list to set or cancel options that control the inclusion of information in the object file for use by the VMS Debugger. The Debugger Information Generation option is inaccessible when the Produce an Object File button is off. Help information on the individual options for Debugger Information Generation is available below under additional topics.
Additional information available:
traceback
=title Traceback Records
Click on the Traceback Records button to include
traceback information in the object file.
The traceback information consists of an address
correlation table. This information allows the VMS
Debugger and the run-time error traceback routine to
translate absolute virtual addresses into
source-program subroutine names and compiler-generated
line numbers.
Equivalent qualifier (DCL interface):
/DEBUG=[NO]TRACEBACK
symbols
=title Symbol Table Records
Click on the Symbol Table Records button to include, in
the object file, local symbol table information for use
by the VMS Debugger.
Information on the following items is included:
o User-defined variables
o Arrays (including dimension information)
o Structures
o Parameter constants
o Labels of executable statements
Equivalent qualifier (DCL interface):
/DEBUG=[NO]SYMBOLS
check
=title Run-Time Condition Checks Click on buttons in the Run-Time Condition Checks options list to set or cancel options that control whether the compiler produces extra code to check for certain error conditions at run time. Help information on the options that control this checking is available below under additional topics.
Additional information available:
bounds
=title Out of Bounds References to Arrays and Strings
Click on the Out of Bounds References to Arrays and
Strings button to direct the compiler to check each
dimension of an array reference or substring subscript
reference. The compiler determines whether each
reference is within the range of the dimension
specified by the array or character variable
declaration.
Equivalent qualifier (DCL interface):
/CHECK=[NO]BOUNDS
overflow
=title Integer Overflow
Click on the Integer Overflow button to direct the
compiler to check BYTE, INTEGER*2, and INTEGER*4
calculations for arithmetic overflow.
The compiler always checks real and complex
calculations for overflow, and the mathematical library
routine that performs integer exponentiation also
always checks for overflow.
Equivalent qualifier (DCL interface):
/CHECK=[NO]OVERFLOW
underflow
=title Floating Point Underflow
Click on the Floating Point Underflow button to direct
the compiler to check real and complex calculations for
floating-point underflow.
If this button is on, error messages are issued for the
first two floating underflows. Regardless of the
setting of this button, zero is stored as the result
that underflows and the compilation continues.
Equivalent qualifier (DCL interface):
/CHECK=[NO]UNDERFLOW
data
=title Data Interpretation Options...
Choose the Data Interpretation... menu item to review
or adjust the settings of compilation options that
determine the machine representation of the following:
o Floating-point double-precision values
o INTEGER and LOGICAL declarations that do not
specify a length
Help information on the data interpretation options is
available below under additional topics.
Additional information available:
double format
=title Floating-Point Double Precision Format Click on buttons in the Floating-Point Double Format options list to choose the format, D_FLOATING or G_FLOATING, that you want the compiler to use for double-precision floating-point variables. Help information on the options governing the form used for floating-point double-precision entities is available below under additional topics.
Additional information available:
D float
=title D_floating
Click on the D_floating button to direct the compiler
to format REAL*8, COMPLEX*16, DOUBLE PRECISION, and
DOUBLE COMPLEX declarations and constants in VAX
D_floating format.
Equivalent qualifier (DCL interface):
/NOG_FLOAT
G float
=title G_floating
Click on the G_floating button to direct the compiler
to format REAL*8, COMPLEX*16, DOUBLE PRECISION, and
DOUBLE COMPLEX declarations and constants in VAX
G_floating format.
Equivalent qualifier (DCL interface):
/G_FLOAT
integer length
=title INTEGER and LOGICAL Data Length Click on buttons in the INTEGER and LOGICAL Data Length options list to choose the length to be used for INTEGER and LOGICAL declarations that do not specify a length. Help information on the options governing INTEGER and LOGICAL data length is available below under additional topics.
Additional information available:
2 bytes
=title 2 Bytes
Click on the 2 Bytes button to direct the compiler to
interpret INTEGER and LOGICAL declarations that do not
specify a length as INTEGER*2 and LOGICAL*2.
Equivalent qualifier (DCL interface):
/NOI4
4 bytes
=title 4 Bytes
Click on the 4 Bytes button to direct the compiler to
interpret INTEGER and LOGICAL declarations that do not
specify a length as INTEGER*4 and LOGICAL*4.
Equivalent qualifier (DCL interface):
/I4
source
=title Source Interpretation Options... Choose the Source Interpretation Options... menu item to review or change the settings of compilation options that determine the rules the compiler will use to interpret the source code. Help information on the various options is available below under additional topics.
Additional information available:
semanticsextend sourcecontinuations
D_LINES
=title Compile Lines with D in Column 1
Click on the Compile Lines with D in Column 1 button to
direct the compiler to compile lines of source code
with a D in column 1. By default, the compiler assumes
that lines beginning with a D are comments and does not
compile them.
Equivalent qualifier (DCL interface):
/[NO]D_LINES
semantics
=title Semantic Interpretation Rules Click on buttons in the Semantic Interpretation Rules options list to choose the rules that the compiler will use to interpret the source code. Help information on the semantic options is available below under additional topics.
Additional information available:
FORTRAN_IV
=title FORTRAN IV
Click on the FORTRAN IV button to direct the compiler
to use FORTRAN IV (ANSI X3.9-1966) interpretation rules
for those statements that have a meaning that is
incompatible with FORTRAN-77 (ANSI X3.9-1978).
For an explanation of the incompatibilities, see the
"VAX FORTRAN User Manual."
Equivalent qualifier (DCL interface):
/NOF77
FORTRAN_77
=title FORTRAN 77
Click on the FORTRAN-77 button to direct the compiler
to use FORTRAN-77 (ANSI X3.9-1978) interpretation rules
for those statements that have a meaning that is
incompatible with FORTRAN IV (ANSI X3.9-1966).
For an explanation of the incompatibilities, see the
"VAX FORTRAN User Manual."
Equivalent qualifier (DCL interface):
/F77
extend source
=title Length of Statement Field Click on buttons in the Length of Statement Field options list to specify which columns in the lines in your FORTRAN source program are used as the statement field -- columns 7 through 72 or 7 through 132.
Additional information available:
72
=title 72 Columns
Click on the 72 Columns button to direct the compiler
to use columns 7 through 72 as the statement field in
FORTRAN source code lines.
Equivalent qualifier (DCL interface):
/NOEXTEND_SOURCE
132
=title 132 Columns
Click on the 132 Columns button to direct the compiler
to use columns 7 through 132 as the statement field in
FORTRAN source code lines.
Equivalent qualifier (DCL interface):
/EXTEND_SOURCE
continuations
=title Maximum Number of Continuation Lines
Adjust the Maximum Number of Continuation Lines scale
to specify the maximum number that will be accepted by
the compiler.
Equivalent qualifier (DCL interface):
/CONTINUATIONS=value
high performance
=title High-Performance Options... Choose the High-Performance Options... menu item to review or change the settings of compilation options that determine whether the compiler performs special processing to support parallel processing. Help information on the High-Performance options is available below under additional topics.
Additional information available:
parallel
=title Enable Parallel Processing Features
Click on the Enable Parallel Processing Features button
to direct the compiler to parse CPAR$ directives and
generate parallel code for loops preceded by CPAR$
DO_PARALLEL.
Equivalent qualifier (DCL interface):
/[NO]PARALLEL
opt push but
=title Option Buttons -- OK, Apply, Reset, and Cancel
The effects of the OK, Apply, Reset, and Cancel buttons
are as follows:
o OK Button -- Click on the OK button to update the
current configuration to reflect the compilation
options you have chosen. This action also removes
the auxiliary dialog box in which the OK button
resides.
o Apply Button -- Click on the Apply button to update
the current configuration with any changes you have
made to the compilation options.
The auxiliary dialog box remains in effect when you
click on the Apply button. This allows you to
establish or change several options during a single
invocation of the auxiliary dialog box in which the
Apply button resides. Thus, you can set the
options with the Apply button either one at a time
or as a group.
o Reset Button -- Click on the Reset button to purge
any options that you have chosen but not applied to
a configuration (with the Apply button).
The auxiliary dialog box containing the Reset
button remains in effect when you click on the
Reset button.
o Cancel Button -- Click on the Cancel button to
purge all options that have been chosen but not
applied to a configuration (with the Apply button).
This action also removes the auxiliary dialog box
in which the Cancel button resides.
The main dialog box remains in effect when you
click on the Cancel button. This allows you to
establish or change more than one configuration of
compilation options without having to exit and
reenter the main dialog box.