DECwindows Compiler Interface for Pascal — VMS Pascal_4.0
Additional information available:
<label>commandsconfig list boxconfig namehelpmain push buttons
optionsopt push but
=title Compile a Pascal 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 in 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 DWCI dialog box, for example, a FileView window. (This menu item has the same effect as the Cancel button in the main dialog box.)
config list box
=title Configurations
The Configurations list box allows you to establish and
save named configurations of compilation option
settings.
The names of the configurations appear in the list box.
The first time you access the DWCI dialog box, only the
configuration name for the default option settings
(Product_Default) appears in the Configurations list
box.
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 to 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 Pascal compiler's default option settings are
established as the default configuration whenever you
invoke the DWCI dialog box. 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 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 Configurations 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 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 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.
The name of the product-supplied default configuration
(Product_Default) appears in the Applied Configuration
dialog box whenever DWCI is invoked (that is, a
compilation request is issued from, for example, a
FileView window).
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 it 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 only in effect 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 PASCAL 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 below in 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.
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 under additional topics.
To view the help information on an additional topic,
double click on the topic.
Additional information available:
about
=title About =include Help Overview VAX Pascal Version 4.0 Copyright 1989 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).
overview
=title Overview
The DECwindows Compiler Interface (DWCI) allows you to
establish named sets of compilation options for use in
compiling your programs.
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 PASCAL command line that is
equivalent to the option configuration identified in
the Applied Configuration dialog box.
You can establish several named sets of compilation
options. The compilation options associated with a
particular name are fixed until you change them. This
allows you to 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, you 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.
Help information on common user tasks, help, and
unsupported compilation options is available under
additional topics. To view the help information on an
additional topic, double click on the topic.
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
The following list describes common user tasks and the
screen objects associated with them:
o To exit from the DWCI dialog box (that is, to
return to the window from which you invoked the
DWCI dialog box), 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 PASCAL 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 PASCAL command
line to appear in the subwindow at the bottom of
the main dialog box. (The subwindow always
displays the PASCAL command line for the
configuration identified in the Applied
Configuration dialog box.)
Help information on the screen objects associated with
these tasks is available 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 the Help pull-down menu 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
multiple file names are specified 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
compile multiple files as a single program or if
you want to 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 Pascal source modules
that you want to include in a compilation, you must
use the DCL interface; the /LIBRARY qualifier has
no equivalent in DWCI.
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 in the Applied Configuration dialog box.
You can view the compilation options associated
with the current configuration in either of the
following ways:
- Examine the PASCAL 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.
- 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 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 in additional topics. To view help information on an option category, double click on it.
Additional information available:
options listlistingtoolscheckinggenerationdatasource
environment generation
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
/TERMINAL
/WARNINGS
Tool Options /ANALYSIS_DATA
/DESIGN
/DIAGNOSTICS
Checking Options /CHECK
/STANDARD
/USAGE
Object Code Options /DEBUG
/OBJECT
/OPTIMIZE
Data Interpretation Options /G_FLOATING
Source Interpretation Options /ERROR_LIMIT
/OLD_VERSION
Environment Generation Options /ENVIRONMENT
listing
=title Listing Options... Choose the Listing Options... menu to review or change any of the compilation options that affect the contents of output listings or of terminal display. The listing options are shown under additional topics. To view help information on a particular topic, 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 an output listing. By default,
the listing file is given the name of the source file
plus the .LIS extension. You can optionally change the
file name to any valid name of your choice.
If you are compiling multiple files and you type in an
output 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 under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
dictionarycross referenceheaderincludeinlinemachine code
sourcestatisticstable of contents
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 directives.
Equivalent qualifier (DCL interface):
/SHOW=[NO]DICTIONARY
cross reference
=title Cross reference
Click on the Cross reference button to include, in the
listing file, a cross reference of all identifiers and
labels used within the source code.
Equivalent qualifier (DCL interface):
/[NO]CROSS_REFERENCE
header
=title Page heading
Click on the Page heading button to request headings at
the top of each listing page.
Equivalent qualifier (DCL interface):
/SHOW=[NO]HEADER
include
=title Contents of %INCLUDE files
Click on the Contents of %INCLUDE files button to
include, in the listing file, source code from files
specified in %INCLUDE directives.
Equivalent qualifier (DCL interface):
/SHOW=[NO]INCLUDE
inline
=title Inline summary
Click on the Inline summary button to include, in the
listing file, the names of user-defined routines and
whether these routines were expanded inline.
The inline summary enabled by the Inline summary button
shows only the names of routines that were expanded
inline in the compilation. If you want to know why
routines were not expanded inline, you must select an
additional compilation option with the Optimize code,
allow inline expansion button. (The Optimize code,
allow inline expansion button is in an options list
associated with the Object Code Options... menu item.)
Equivalent qualifier (DCL interface):
/SHOW=[NO]INLINE
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.
Equivalent qualifier (DCL interface):
/[NO]MACHINE_CODE
source
=title Source code
Click on the Source code button to include, in the
listing file, a listing of VAX Pascal source code.
Equivalent qualifier (DCL interface):
/SHOW=[NO]SOURCE
statistics
=title Compilation statistics
Click on the Compilation statistics button to include,
in the listing file, a summary of compiler performance
statistics.
Equivalent qualifier (DCL interface):
/SHOW=[NO]STATISTICS
table of contents
=title Table of contents
Click on the Table of contents button to include, in
the listing file, a table of contents. This option is
enabled only if a %TITLE or %SUBTITLE directive is
specified in the source code.
Equivalent qualifier (DCL interface):
/SHOW=[NO]TABLE_OF_CONTENTS
messages
=title Compiler Messages Click on the button in the Compiler Messages options list to set or cancel the option that controls whether the compiler issues diagnostic messages in reponse to warning-level or informational-level errors. Help information on the option for Compiler Messages is available under an additional topic. To view help information on this topic, double click on it.
Additional information available:
warnings
=title Warnings
Click on the Warnings button to generate diagnostic
messages in response to warning-level or
informational-level errors. A warning or informational
diagnostic message indicates that the compiler has
detected acceptable but unorthodox syntax or has
performed some corrective action; in either case,
unexpected results may occur.
Equivalent qualifier (DCL interface):
/[NO]WARNINGS
terminal
=title Display On terminal Click on buttons in the Display On terminal options list to set or cancel a list of specific options to be displayed on the terminal. Help information on the individual options for Display On terminal is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
file namesroutine namesstatistics
file names
=title File names
Click on the File names button to display all file
names on the PASCAL command line as they are being
processed.
Equivalent qualifier (DCL interface):
/TERMINAL=[NO]FILE_NAME
routine names
=title Routine names
Click on the Routine names button to display all
routine names as code is generated.
Equivalent qualifier (DCL interface):
/TERMINAL=[NO]ROUTINE_NAME
statistics
=title Compilation statistics
Click on the Compilation statistics button to display
compiler performance statistics.
Equivalent qualifier (DCL interface):
/TERMINAL=[NO]STATISTICS
tools
=title Tool Options...
Choose the Tool Options... menu item to review or
change the option settings that determine whether the
compiler does the following:
o Generates an output file containing cross-reference
and static-analysis information (.ANA files)
o Processes program design elements
o Generates an output file containing compiler
messages and diagnostics information (.DIA files)
The .ANA and .DIA files are reserved for use by Digital
layered products. Program design processing is
associated with the use of Digital layered products.
The tool options are listed under additional topics.
To view help information on a particular topic, double
click on it.
Additional information available:
analysis datadesigndiagnostics
analysis data
=title Produce an SCA analysis data file
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).
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]
design
=title Program design processing Click on buttons in the Program design processing options list to set or cancel specific options that determine the design elements that the compiler recognizes and processes. Help information on the individual options for Program design processing is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
comments
=title Enable comment analysis
Click on the Enable comment analysis button to direct
the compiler to recognize design comments. Design
comments are made available to Digital layered products
(for example, the VAX Source Code Analyzer).
Equivalent qualifier (DCL interface):
/DESIGN=[NO]COMMENTS
placeholders
=title Enable placeholder analysis
Click on the Enable placeholder analysis button to
direct the compiler to accept placeholders as valid
program elements. Placeholders are produced by Digital
layered products (for example, the VAX
Language-Sensitive Editor).
Equivalent qualifier (DCL interface):
/DESIGN=[NO]PLACEHOLDERS
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]
checking
=title Compile-Time and Run-Time Checking Options... Choose the Compile-Time and Run-Time Checking Options... menu to review or change any of the compilation options that affect checking. The checking options are listed under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
checkusagestandardstandard type
check
=title Run-time condition checks Click on buttons in the Run-time condition checks options list to set or cancel specific options that generate code to perform run-time checks. Help information on the individual options for Run-time condition checks is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
boundscase selectorsdeclarationsoverflowpointerssubrange
bounds
=title Out of bounds references to arrays and strings
Click on the Out of bounds references to arrays and
strings button to verify that an index expression is
within the bounds of an array's index type, that
character-string sizes are compatible, and that schema
types are compatible.
A CHECK attribute within the source code overrides the
Out of bounds references to arrays and strings option
setting.
Equivalent qualifier (DCL interface):
/CHECK=[NO]BOUNDS
case selectors
=title Case selector value within range
Click on the Case selector value within range button to
check that the value of a case selector is contained in
the corresponding case-label list.
A CHECK attribute within the source code overrides the
Case selector value within range option setting.
Equivalent qualifier (DCL interface):
/CHECK=[NO]CASE_SELECTORS
declarations
=title Invalid non-static type declarations
Click on the Invalid non-static type declarations
button to verify that schemata discriminations produce
legal types and that non-local GOTOs are properly used.
A CHECK attribute within the source code overrides the
Invalid non-static type declarations option setting.
Equivalent qualifier (DCL interface):
/CHECK=[NO]DECLARATIONS
overflow
=title Integer overflow
Click on the Integer overflow button to verify that the
result of integer compuation does not exceed the
machine representation.
A CHECK attribute within the source code overrides the
Integer overflow option setting.
Equivalent qualifier (DCL interface):
/CHECK=[NO]OVERFLOW
pointers
=title Pointer equal to NIL
Click on the Pointer equal to NIL button to verify that
the value of a pointer variable is not NIL.
A CHECK attribute within the source code overrides the
Pointer equal to NIL option setting.
Equivalent qualifier (DCL interface):
/CHECK=[NO]POINTERS
subrange
=title Subrange and SET bounds
Click on the Subrange and SET bounds button to verify
that values assigned to variables of subrange types are
within the subrange, that a set expression is
assignment compatible with a set variable, and that MOD
operates on positive numbers.
A CHECK attribute within the source code overrides the
Subrange and SET bounds option setting.
Equivalent qualifier (DCL interface):
/CHECK=[NO]SUBRANGE
usage
=title Variable usage analysis Click on buttons in the Variable usage analysis options list to set or cancel specific options that direct the compiler to perform compile-time checks indicated by the chosen options. Help information on the individual options for Variable usage analysis is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
uncertain
=title Uncertain depending on program flow
Click on the Uncertain depending on program flow button
to check for variables that may be uninitialized
depending on program flow.
Equivalent qualifier (DCL interface):
/USAGE=[NO]UNCERTAIN
uninitialized
=title Known to be uninitialized
Click on the Known to be uninitialized button to check
for variables known to be unitialized.
Equivalent qualifier (DCL interface):
/USAGE=[NO]UNINITIALIZED
unused
=title Declared but never referenced
Click on the Declared but never referenced button to
check for variables that were declared but never
referenced.
Equivalent qualifier (DCL interface):
/USAGE=[NO]UNUSED
standard
=title Pascal standard conformance checking Click on buttons in the Pascal standard conformance checking options list to control whether the compiler issues informational diagnostic messages when it detects coding in source files that does not conform to a specified Pascal standard. Help information on the individual options for Pascal standard conformance checking is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
none
=title None
Click on the None button to disable standards checking.
Equivalent qualifier (DCL interface):
/NOSTANDARD
regular
=title Perform checks, signal as informationals
Click on the Perform checks, signal as informationals
button to enable standards checking; the compiler
generates informational diagnostic messages when it
detects noncompliant features and constructs.
The Perform checks, signal as informationals option is
disabled if the Warnings button is off. (The Warnings
button is in an options list associated with the
Listing Options... menu item.)
Equivalent qualifier (DCL interface):
/STANDARD
validation
=title Performs checks, signal as errors
Click on the Performs checks, signal as errors button
to enable standards checking; the compiler generates
error messages when it detects noncompliant features
and constructs.
Equivalent qualifier (DCL interface):
/STANDARD=[NO]VALIDATION
standard type
=title Standard to check against Click on buttons in the Standard to check against options list to set or cancel specific Pascal standards. The Standard to check against option is inaccessible unless either the Perform Checks, signal as informational button or the Performs Checks, signal as errors button is on. Help information on the individual options for standard to check against is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
ansi
=title ANSI/IEEE770X3.97-1983
Click on the ANSI/IEEE770X3.97-1983 button to check
against the rules of this ANSI standard.
Equivalent qualifier (DCL interface):
/STANDARD=ANSI
iso
=title ISO 7-185-1983(E)
Click on the ISO 7-185-1983(E) button to check against
the rules of this ISO standard.
Equivalent qualifier (DCL interface):
/STANDARD=ISO
extended
=title (Proposed) Extended Pascal
Click on the (Proposed) Extended Pascal button to check
against the rules of this proposed standard.
Equivalent qualifier (DCL interface):
/STANDARD=[NO]EXTENDED
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
The object code options are listed under additional
topics. To view help information on a particular
topic, double click on it.
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):
/[NO]OBJECT[=file-spec]
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 unless the Produce an object file button is on. Help information on the individual options for Debugger information generation is available under additional topics. To view help information on a particular topic, double click on it.
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.
The symbol table information consists of symbol
definitions for all identifiers in the compilation.
Equivalent qualifier (DCL interface):
/DEBUG=[NO]SYMBOLS
optimize
=title Optimization Level Click on buttons in the Optimization Level options list to set or cancel options that control the level of optimization performed on machine-code language. Do not turn on these buttons for compilations that will require debugging. Optimization may make debugging difficult and may obscure some sections of the compilation unit that you would like to debug. Help information on the individual options for Optimization Level is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
none
=title No optimization
Click on the No optimization button to disable
optimization.
An OPTIMIZE or NOOPTIMIZE attribute within the source
code overrides the No optimization option setting.
Equivalent qualifier (DCL interface):
/NOOPTIMIZE
noinline
=title Optimize code, no inline expansion
Click on the Optimize code, no inline expansion to
enable all optimization components, except inline
expansion of routines.
An OPTIMIZE or NOOPTIMIZE attribute within the source
code overrides the Optimize code, no inline expansion
option setting.
Equivalent qualifier (DCL interface):
/OPTIMIZE=NOINLINE
all
=title Optimize code, allow inline expansion
Click on the Optimize code, allow inline expansion to
enable all optimization components, including inline
expansion of routines.
An OPTIMIZE or NOOPTIMIZE attribute within the source
code overrides the Optimize code, allow inline
expansion option setting.
Equivalent qualifier (DCL interface):
/OPTIMIZE=ALL
data
=title Data Interpretation Options... Choose the Data Interpretation Options... menu item to review or adjust the settings of compilation options that determine the machine representation of floating-point double-precision values. The data interpretation options are listed under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
double format
=title Floating-point double precision format Click on buttons in the Floating-point double-precision format options list to choose the format, D_floating or G_floating, that you want the compiler to use for floating-point double-precision variables. Help information on the individual options for Floating-point double-precision format is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
D float
=title D_floating
Click on the D_floating button to direct the compiler
to format declarations and constants of type DOUBLE in
VAX D_floating format.
A G_FLOATING attribute within the source code causes a
warning diagnostic message if the D_floating option
setting is enabled.
Equivalent qualifier (DCL interface):
/NOG_FLOATING
G float
=title G_floating
Click on the G_floating button to direct the compiler
to format declarations and constants of type DOUBLE in
VAX G_floating format.
A NOG_FLOATING attribute within the source code causes
a warning diagnostic message if the G_floating option
setting is enabled.
Equivalent qualifier (DCL interface):
/G_FLOATING
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. The source interpretation options are listed under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
old version
=title Conform to Pascal V1 rules
Click on the Conform to Pascal V1 rules button to
resolve differences betweeen VAX Pascal Version 1.0 and
subsequent version by using the Version 1.0 definition
of the language.
Equivalent qualifier (DCL interface):
/[NO]OLD_VERSION
error limit
=title Maximum number of errors
Click on the Maximum number of errors button to
terminate compilation after the occurrence of a
specified number of error-level messages.
Equivalent qualifier (DCL interface):
/[NO]ERROR_LIMIT[= n]
environment generation
=title Environment Generation Options... Choose the Environment Generation Options... menu to review or change any of the compilation options that affect environment file generation. The environment generation options are shown under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
environment
=title Produce Pascal environment file Click on buttons in the Produce Pascal environment file options list to set or cancel specific options that determine whether an environment file is produced. Help information on the individual options for Produce Pascal environment file is available under additional topics. To view help information on a particular topic, double click on it.
Additional information available:
never
=title Never
Click on the Never button to prevent an environment
file from being produced. This option overrides any
ENVIRONMENT attributes specified in the source file.
Equivalent qualifier (DCL interface):
/NOENVIRONMENT
absent
=title Based on ENVIRONMENT attribute in source
Click on the Based on ENVIRONMENT attribute in source
button to produce an environment file according to the
ENVIRONMENT attribute specifications in the source
file.
Equivalent qualifier (DCL interface):
none
always
=title Always
Click on the Always button to produce an environment
file whether there is an ENVIRONMENT attribute in the
source file or not.
Equivalent qualifier (DCL interface):
/ENVIRONMENT
file name
=title Environment file name
Click on the Environment file name button to change the
name of the environment file from the default name to
any valid name of your choice. By default, the
environment file is given the name of the source file
plus the .PEN extension.
The Environment file name option is inaccessible unless
the Always button is on.
Equivalent qualifier (DCL interface):
/ENVIRONMENT[=file-spec]
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
(Apply button) to a configuration.
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 (Apply button) to a configuration. 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.