SUNDB86M Compilation

SUNDB86M Only

 

The following command line compiles using SUNDB86M:

 

     SUNDB86M {in}[,{out}[,{prt}[,{wrk}]]][;{opts}]

 

Parameters:

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.

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. These options need not be separated with delimiters:

    6.  

    Option

    Meaning

    A

    Automatically executes the program if compilation was successful.

    C

    Generate a fully linked Stand-alone program.

    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.

    G

    Generate assembler source files only (no assembly or linkage process).

    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.

    M

    Generate MASM compatible assembler source (default).

    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. If the specified {print} or default spool file does not exist, it is created.

    R

    Use the Digital Research Assembler RASM (does not support generic array processing).

    T

    Create extended symbol table. Useful for very large programs.

    V

    Generate EQUated labels from the command line. The format is "VNAME=value" where 'VNAME' 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.

    ZB

    Generate a batch file named 'SUN$ASM$.BAT' and SHUTDOWN with this file as an argument. This option frees up the memory that SUNDB86M is using and thus allow for larger programs to compile successfully.

    ZC

    Datapoint compatibility mode.

    ZD

    Override the LISTOFF directive to create a complete listing.

    ZH

    Delete .EXE file if errors were encountered during compile.

    ZM

    Multiple character traps allowed.

    ZC

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

    ZZ

    Merge PL/B source into assembler source as comment lines.

    "xx"

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

    nnn

    Number of lines per page for the output.

     

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

  7. 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.

  8. 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).

  9. 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.

  10. The final output from the assembler and linker is an .EXE file. Whether the output is a Resident or Stand-alone program and how it must be initiated is dependent upon usage of the 'C' option (see Program Execution).

  11. If the 'G' option is not used, SUNDB86M automatically performs the following functions:

    1. SUNDB86M {in}[,{out}[,{prt}]][;{opts}]

    2. RASM86 {out}.A86 $ PZ SZ
      (or)
      MASM {out}.ASM; 

    3. DEL {out}.A86 {RASM86}
      (or)
      DEL {out}.ASM {MASM} 

    4. DEL {out}.IN*

    5. LINK D:SDBLINK1+D:SDBLINK2+{out},{out},NUL,SUNDB86M

    6. DEL {out}.OBJ

  12. If the 'R' option is specified, the RASM86 procedures are used. Otherwise the MASM procedures default. If the 'G' option is specified, steps 2 through 6 must be performed manually in order for an executable program to be generated.

  13. RASM86 Notes: If a listing (PZ) or symbol file (SZ) is desired from the assembler, the 'G' option must be specified and each 'Z' must be replaced with the destination drive where the generated files are to be placed.

  14. MASM Notes: Options may be used at the programmer's risk.

  15. Refer to ENTERZ and EXITZ compiler directives for rules concerning the interfacing of PL/B to the assembler used.

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

    17.  

    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

 

 

See Also: Compiler and Runtime Options

 


Compiler and Runtime Options