Calling a Preprocessor Without the Compiler

Every preprocessor can be called as a separate application, without the ACUCOBOL-GT compiler, by a command line of one of the following forms (the second example is used with a preprocessor written in ACUCOBOL-GT):

preproc-1 -placePo output-file [options] input-file

run-time preproc-2.ACU -placePo output-file [options] input-file

These command lines are very similar to the one used with the -Pg option, but there are some important differences:

For diagnostic purposes, a preprocessor also accepts either of the following two options:

-help       do not preprocess; show command-line help on standard output device
-v do not preprocess; show preprocessor version information on standard output device

When either of these options is used, the input and output files need not be specified.

Note: The -help and -v options are not acceptable when the preprocessor is called by the compiler.

Some preprocessors may allow other combinations of options and files when called without the compiler.

The input and output files should be files, not devices, because the preprocessor may not read or write them in strictly sequential order.

A preprocessor returns an exit value 0 (zero) if the preprocessing was successful and the value 1 (one) if there were errors.