Please enable JavaScript to view this site.

A-Shell Reference

Following are the switches used with COMPIL.

Switch

Function

/13

OCMPIL mode (BASIC 1.3 compatibility)

/A

Increase size of offsets used for program addresses from 16 to 24 bits. This fixes "transfer address out of range" compiler errors. Beginning with COMPIL version 1.0(112), /A is invoked automatically (as needed).

/AV

Additional Variables: Extends the allowable number of variables.

/B

Background: Send errors messages to <sourcefile>.lst.

/C

(C:symbol=value) Provides for passing Compiler Symbol Definitions.

/CI

Enables case insensitive compilation. Note that this applies to labels and function/procedure names as well as variables and symbols.

/CTAGS

Outputs just a list of ++INCLUDE files to <source>.lst. Mainly for internal use by APN.

/D

Enables use of certain d/BASIC statements.

/DEBUG

Activate conditional debug code by compiling the variable DEBUG as 1.

/F1

Disables the header signature which otherwise would be used if the program contains any features introduced in 6.5.

/I

Allow the use of ISAM 1.0 statements (not relevant for OCMPIL or /13)

/IGOO

Treats all ++INCLUDEs as ++INCLUDE'ONCE; "IGOO" = Include Global Once Only.

/IEEE

Assume F,8 instead of F,6 if variable size is not specified.

/LF

Creates a consolidated List File showing all of the source with location offsets.

/LI

Local Include causes the directory information on any ++INCLUDE statement to be ignored.

/LSM

Create .LSM file containing metadata used by APN.

/M

Mapped variable required: causes compiler error for any unmapped variables.

/MX

Unmapped Variable List: Reports every line in which an unmapped variable appears.

/N

Turns off the display of compiler statistics.

/NOTRC

Ignore all trace related statements during compilation (++pragma TRACE_xxx, TRACE.xxx, DEBUG.xxx).

/O

Removes the internal line number references from the compiled object code, making it smaller and faster, but eliminating the capability for error handling routines to display the line number of the error.

/P

Enables support for Named Parameters.

/PX

Superset of /P, which is implied; enables automatic removal of un-referenced functions and procedures from the compiled output. The removed routines are also marked as such in the /LF List File.

/RC

Run Compatible: Preserves runtime compatibility for AMOS.

/S

Silent: Turns off the display of ++INCLUDE file names.

/T

Trace: Display source code as it is being processed.

/V:1

Attempts to duplicate AMOS 1.4 and higher.

/VC

(VC:pattern) Version Copy causes the compiler to make a backup copy of every source module encountered according to the specified pattern.

/XTAGS

Outputs a "tag" file to <source>.TAGS. Mainly for internal use by APN.

/X:1

Enables use of certain BASICplus syntax elements. These are clarified in more detail in the section on BASICplus extensions.

/X:2

Enables the use of certain A-Shell extensions to BASIC. See A-Shell Extensions.

/X:3

Same as X:2, but creates an SBX file instead of RUN.

/?

Writes switch listing to the screen.

Definition File: compil.def