Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

commands

config list box

config name

dcl subwindow

help

hide

main push buttons

options

opt push but

quit

apply delete

add

about

overview

more about

common user tasks

using help

unsupported compilation options

options list

listing

tools

generation

data

source

high performance

list

show

warnings

standard

dictionary

cross reference

include

machine code

preprocessor

symbols

unreferenced constants

VAXELN

declarations

Ultrix

other

semantic

source form

syntax

DML

analysis data

diagnostics

design

comments

placeholders

object

optimize

debug

check

traceback

symbols

bounds

overflow

underflow

double format

integer length

D float

G float

2 bytes

4 bytes

D_LINES

semantics

extend source

continuations

FORTRAN_IV

FORTRAN_77

72

132

parallel

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

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

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

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:

aboutoverview

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

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:

listshowwarningsstandard

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:

VAXELN

declarationsUltrixother

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:

semanticsource formsyntax

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:

DML

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:

commentsplaceholders

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:

objectoptimizedebugcheck

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:

tracebacksymbols

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:

boundsoverflowunderflow

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 formatinteger length

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 floatG float

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 bytes4 bytes

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:

D_LINES

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_IVFORTRAN_77

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:

72132

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

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.

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