1 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. 2 options_list =title List of Options (by option category) -------------------------------------------------------- Options Category Options (Equivalent (Options Menu) DCL Qualifiers) -------------------------------------------------------- Listing Options... /CROSS_REFERENCE /LIST /SHOW Tool Options... /ANALYSIS_DATA /DIAGNOSTICS Object Code Options... /DEBUG /ENABLE or /DISABLE /OBJECT 2 listing =title Listing Options... Choose the Listing Options... menu to review or change any of the assembly options that affect the contents of output listings. All of the categories of listing options are shown below in additional topics. To view help information on a particular category, double click on it. 3 list =title Produce a Listing File Click on the Produce a Listing File button to direct the assembler 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. You can optionally change the file name to any valid name of your choice. If you are assembling 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] 3 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 assembler. The Show in Listing option is inaccessible unless the Produce a Listing File button is on. (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 in additional topics. Equivalent qualifier (DCL interface): /[NO]SHOW[=(function[,...]) 4 conditionals =title Unsatisfied conditionals Click on the Unsatisfied Conditionals button to include, in the listing file, unsatisfied conditional code associated with .IF and .ENDC directives. Equivalent qualifier (DCL interface): /SHOW=CONDITIONALS 4 calls =title Macro calls, repeat range expansions Click on the Macro Calls, Repeat Range Expansions button to include, in the listing file, macro calls and repeat range expansions. Equivalent qualifier (DCL interface): /SHOW=CALLS 4 definitions =title Macro definitions Click on the Definitions button to include macro definitions in the listing file. Equivalent qualifier (DCL interface): /SHOW=DEFINITIONS 4 expansions =title Macro expansions Click on the Macro Expansions button to include macro expansions in the listing file. Equivalent qualifier (DCL interface): /SHOW=EXPANSIONS 4 binary =title Macro code binary expansions Click on the Macro Code Binary Expansions button to include, in the listing file, binary code generated by the expansion of macro calls. Equivalent qualifier (DCL interface): /SHOW=BINARY 3 cref =title Cross Reference in Listing Click on buttons in the Cross Reference in Listing options list to set or cancel options that determine whether a cross-reference list is included in the listing file. A cross-reference list identifies the places in the source file where the following items are defined or referred to: directives, macros, operation codes, registers, and symbols. Help information on the individual options for Cross Reference in Listing is available below in additional topics. Equivalent qualifier (DCL interface): /[NO]CROSS_REFERENCE[=(function[,...])] 4 all =title Cross reference directives, macros, opcodes, regs, syms Click on the Cross Reference Directives, Macros, Opcodes, Regs, Syms button to include, the listing file, cross-references for the items identified by the name of this button. Equivalent qualifier (DCL interface): /CROSS_REFERENCE=ALL 4 directives =title Cross reference directives Click on the Cross Reference Directives button to include cross-references for directives in the listing file. Equivalent qualifier (DCL interface): /CROSS_REFERENCE=DIRECTIVES 4 macros =title Cross reference macros Click on the Cross Reference Macros button to include macro cross-references in the listing file. Equivalent qualifier (DCL interface): /CROSS_REFERENCE=MACROS 4 opcodes =title Cross reference opcodes CLick on the Cross Reference Opcodes button to include operation code cross-references in the listing file. Equivalent qualifier (DCL interface): /CROSS_REFERENCE=OPCODES 4 registers =title Cross reference registers Click on the Cross Reference Registers button to include cross-references for registers in the listing file. Equivalent qualifier (DCL interface): /CROSS_REFERENCE=REGISTERS 4 symbols =title Cross reference symbols Click on the Cross Reference Symbols button to include symbol cross-references in the listing file. Equivalent qualifier (DCL interface): /CROSS_REFERENCE=SYMBOLS 2 tools =title Tool Options... Choose the Tool Options... menu item to review or change the option settings that determine whether output files containing the following types of information are created: o Cross-reference and static-analysis information (.ANA files) o Assembler messages and diagnostics information (.DIA files) These files are reserved for use by DIGITAL layered products. Tool options are listed below in additional topics. To view help information on a particular tool option, double click on it. 3 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. You can optionally 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 a different version number). Equivalent qualifier (DCL interface): /[NO]ANALYSIS_DATA[=file-spec] 3 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. You can optionally 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 a different version number). Equivalent qualifier (DCL interface): /[NO]DIAGNOSTICS[=file-spec] 2 generation =title Object Code Options... Choose the Object Code Options... menu item to review or adjust the settings of assembly 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 The object code options are listed below in additional topics. To view help information on a particular option, double click on it. 3 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. You can optionally 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 a different version number). Equivalent qualifier (DCL interface): /[NO]OBJECT[=file-spec] 3 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 below in additional topics. Equivalent qualifier (DCL interface): /[NO]DEBUG[=option] 4 symbols =title Local symbols Click on the Local Symbols button to include all local symbols in the object module (for use by the debugger). Equivalent qualifier (DCL interface): /DEBUG=SYMBOLS /ENABLE=DEBUG 4 traceback =title Traceback records Click on the Traceback Records button to include traceback information in the object module (for use by the debugger.) Equivalent qualifier (DCL interface): /DEBUG=TRACEBACK /ENABLE=TRACEBACK 3 enable =title Enable Information Generation Click on button in the options list for the Enable Information Generation menu item to provide initial settings for the functions controlled by the assembler directives .ENABLE and .DISABLE. Equivalent qualifier (DCL interface): /[NO]ENABLE=(function[,...]) /[NO]DISABLE=(function[,...]) Note that TRACEBACK and DEBUG functions, which can be specified in the preceding DCL qualifiers, are handled by the options list for the Debugger Information Generation menu item. Help information on the individual options for Enable Information Generation is available below in additional topics. 4 absolute =title Relative addr modes treated as absolute Click on the Relative Addr Modes Treated as Absolute button to direct the assembler to assemble all relative addresses as absolute addresses. Equivalent qualifier (DCL interface): /[NO]ENABLE=ABSOLUTE /[NO]DISABLE=ABSOLUTE 4 global =title Undefined assumed external Click on the Undefined Assumed External button to direct the assembler to treat all undefined symbols in the assembly as external symbols. When the button is off, any undefined symbol that is not listed in an .EXTERNAL directive causes an assembly error. Equivalent qualifier (DCL interface): /[NO]ENABLE=GLOBAL /[NO]DISABLE=GLOBAL 4 local =title Start new local label block Click on the Start New Local Label Block button to end the currrent local label block and start a new one. If this button is off, the current local label block is ended, but a new one is not started. d.b1 Equivalent qualifier (DCL interface): /[NO]ENABLE=LOCAL_BLOCK /[NO]DISABLE=LOCAL_BLOCK 4 suppression =title List only referenced symbols in symbol table Click on the List Only Referenced Symbols in Symbol Table button to suppress the listing of unreferenced symbols in the symbol table. Equivalent qualifier (DCL interface): /[NO]ENABLE=SUPPRESSION /[NO]DISABLE=SUPPRESSION 4 truncation =title Truncate FP numbers Click on the Truncate FP Numbers button to direct the assembler to truncate floating-point numbers (if truncation is disabled, such numbers are rounded). G_floating, D_floating, and H_floating numbers are not affected. Equivalent qualifier (DCL interface): /[NO]ENABLE=TRUNCATION /[NO]DISABLE=TRUNCATION 4 vector =title Assemble vector instructions Click on the Assemble Vector Instructions button to direct the assembler to allow and assemble vector instructions in the source code. This implies that the symbols V0-V15 will be treated as reserved vector register symbols and cannot be user-defined symbols. Equivalent qualifier (DCL interface): /[NO]ENABLE=VECTOR /[NO]DISABLE=VECTOR