compil {-switches} file

Example:

compil -x:2 -m -a source.bas

The native OS compil executable is equivalent to the COMPIL.LIT program, except that it runs directly from the OS level rather than from within the A-Shell environment. All of the switches and other behavior for the native executable and LIT versions are the same, except for the following subtleties:

• In the native executable version, the switches must each be preceded by a dash (rather than a slash as in the LIT version), and they must all precede the source file name (rather than follow it as in the LIT version). This is consistent with the normal conventions for switches in UNIX and Windows command lines.

• In the native executable version, the switches are case sensitive and must be given in lower case. (They are case insensitive in the LIT version.)

• Rather than offer three named variations (compil, ocmpil, complp) as with the LIT version, there is only one native executable version (compil). You must use the -13 switch to get the equivalent of OCMPIL, or the -x:1 switch to get the equivalent of COMPLP.

• The default amount of memory available for the native executable version is 2MB, whereas in the LIT version it is based on the job's memory partition. Use the -w:#### switch to increase it.

• The native executable outputs messages to stdout, allowing it to be redirected to a file. Note, however, that in most situations where this might be useful, the -b (background) switch is even more useful, especially when executing the compiler from within an integrated editor environment.

Because the native executable version of the compiler is not commonly used, it is not included in the typical distribution packages but is available on request. Contact MicroSabio for more information.