SUNDB86x Compilation

SUNDB86x Only

 

The following command line compiles using SUNDB86A, SUNDB86D, and SUNDB86L:

 

     SUNDB86x {in}[,{out}[,{prt}[,{wrk}[,{sym}]]]][;{opts}]

Parameters:

x

The letter referring to the particular compiler being used.

in

The required source file to be compiled.

out

The optional output file name.

prt

The optional print file name.

wrk

The optional path specification designating the location of the compiler work files.

sym

The optional debug file name.

opts

One of the valid command line options listed below.

Note the following:

  1. The {in} file specification is required and the default extension is .PLS.

  2. The {out} file specification is optional. The file name defaults to the {in} file name and the default extension is .EXE.

  3. The {prt} file specification is optional. The file name defaults to the {out} file name and the default extension is .LST.

  4. The {sym} file specification is optional. The file name defaults to the {out} file name and the default extension is .DBG.

  5. {opts] is one or more of the following options. The options need not be separated with delimiters.

    6.  

    Option

    Meaning

    A

    Automatically executes the program if compilation was successful.

    B

    Create medium code model using the default interrupt 121. This allows programs up to one megabyte of executable code to be generated. DOS still has its own limitation of 640k bytes of executable code. Not applicable to SUNDB86D.

    B=xx

    As above, except the interrupt number is changed to 'xx'.

    D

    Display the source lines on the screen during compilation.

    E

    Output only those lines that generate errors to the print device/file.

    E=xx

    Allows compiler default source extension to be changed to 'xx'.

    F

    Output false 'IF' lines with an 'F' after the line number.

    I

    Do not output warning messages.

    L

    Output all source lines to the print device/file.

    L=xx

    Define LABEL size as 'xx' bytes. 8 is the assumed size and 32 is the maximum.

    N

    No Duplicate default for IFILEs (PREPAREd IFILEs have NODUP bit set)

    O

    Output the generated code to the print device/file.

    P

    Direct the output to a spool file ({prt} or default).

    Q

    Append the output to an existing print file (it is created if non-existent).

    S

    Create a debug file for use with SUNDBUG debugger utility.

    S#0

    Create an encrypted debug using a Sunbelt private encryption key for use with SUNDBUG debugger utility.

    T

    Create an extended symbol table. Useful for very large programs.

    V

    Generate EQUated labels from the command line. The format is:
    VNAME=value
    where 'name' is the label name and 'value' is the EQUated value.

    X

    Generate a Cross Reference Listing.

    Y

    Abort compile upon detection of first error.

    ZA=xx

    Default buffer size for all IFILE and AFILE declarations.

    ZC

    Execute in DATAPOINT compatibility mode. This allows for DATAPOINT style include file names.

    ZD

    Override the LISTOFF directive to create a complete listing.

    ZH

    Delete .EXE file if errors were encountered during compile.

    ZM

    Allow multiple character traps.

    ZN

    Run compiler in NOCOLOR mode for compiler display.

    "xx"

    The information between the quotes ("") is the TITLE for the output.

    nnn

    Number of lines per page for the output.

 

  1. Any option that is shown using an equal (=) character, can also use instead the pound (#) or color (:) characters.

  2. If a list option was specified and a TITLE ("xx") was not given, the user is prompted for one. If nothing is entered within 30 seconds, the compilation continues without it.

  3. The name of each inclusion file is displayed as it is processed, plus a running counter of line numbers. When the compilation is complete, the total number of source lines, errors and warnings are displayed, including the User Data, Code and File Buffer sizes (all three displayed in hex).

  4. Compilation can be paused/resumed by alternately pressing the F1 key and aborted by pressing the F2 or ESCape keys. The F3 key turns on/off screen display of the source lines (if output was being sent to the printer when F3 is pressed, it is canceled and redirected to the screen). F4 turns on/off the display of generated code to the screen.

  5. A successful compile results in a Resident Program (an .EXE file) that can be executed directly from the operating system command line or initiated through a CHAIN instruction only if SUNDBSYx has been initiated (see Program Execution).

  6. Optional keyword definitions can be defined in the User Environment Table that is used by the compiler as defaults. These keywords are:

    7.  

    Keyword

    Defines the default...

    SUNDB_OUT=path\name

    path and/or filename for the compiler output. This could send all your output to your 'OBJECT' directory by:

    SET SUNDB_OUT=C:\OBJECT

    SUNDB_PRT=path\name

    path and/or filename for the printed output. You could force all compiles to output to an existing print file by:
    SET SUNDB_PRT=D:\TEMP\COMPILE.LST

    SUNDB_WRK=path

    path in which the temporary work files are created. Forces all work files to your temp directory by:
    SET SUNDB_WRK=F:\TEMP

    SUNDB_SYM=path\name

    path and/or filename for the debugger output. This could send all your debugger output to your 'OBJECT' directory by:
    SET SUNDB_SYM=C:\OBJECT

    SUNDB_OPT={opts}

    options used by the compiler. Force an error print file of all compiles (unless overwritten on the command line) by SET SUNDB_OPT=ep

 

  1. If an equal sign needs to be placed in the environment variable, you must use a '#' instead, since the SET program strips off equal signs.

 

 

See Also: Compiler and Runtime Options

 


Compiler and Runtime Options