PURPOSE

cobcc - COBOL compilation interface

SYNOPSIS

cobcc [option...] filename ...

DESCRIPTION

cobcc is used as an interface shell to the COBOL compiler. It is invoked, by default, when buildclient(1) or buildserver(1) is executed with the -C (COBOL) option. This can be overridden by specifying the ALTCC environment variable.

The following list indicates the options recognized by cobcc. To use these options, set the environment variable ALTCFLAGS to the string of options to be recognized by cobcc when running buildclient or buildserver. Consult your documentation for the COBOL and C compilers to see what effect the various options have.

Note that for cobcc, unlike cc and cob, all options must come before any file names.

-c

This option specifies the link phase should be suppressed. That is, compilation will be done but an executable program will not be generated.

-p -g -r -O

These options are passed directly to the COBOL compiler.

-l argument

This option and its argument are passed directly to the COBOL compiler (with no white space separating them).

-L argument

This option and its argument are passed directly to the COBOL compiler (with one space separating them).

-o output_file

This option is used to specify the name of the executable file that is output from the link stage.

-E -P -S

These options are passed through the COBOL compiler to the C compiler, and also cause suppression of the link phase.

-A -C -H -f -G

These options are passed through the COBOL compiler to the C compiler.

-w

This option causes warnings to be suppressed from both the COBOL and C compilers.

-D argument

This option and its argument are passed through the COBOL compiler to the C compiler. It is used to define macros in C.

{-T -Y -U -I -B -X -F -q} argument

Each of these options takes an argument. The option and its argument are passed through the COBOL compiler to the C compiler.

-V -v

Each of these options is passed both to the COBOL compiler and the C compiler.

-a -s

Each of these options is passed to the loader.

-u argument

This option and its argument are passed to the loader.

-W argument

The argument may consist of up to three comma-separated fields. If the first part of the argument is -p or -0, it is passed to the C compiler. If it starts with -a, it is passed to the assembler. If it starts with -l, it is passed to the loader. If it starts with -C, it is passed to the COBOL compiler. Otherwise, it is passed through to the C compiler.

The options and their arguments and the file names are passed to the COBOL compiler with the correct options so that the right information is processed by the COBOL compiler, the C compiler, or the loader. The COBOL compiler name is assumed to be "cob" and already in the PATH.

SEE ALSO

buildclient(1),
Micro Focus COBOL/2 Operating Guide, Micro Focus Ltd.