HTCOBOL(1)HTCOBOL(1)NAMEhtcobol - COBOL 85 compiler
SYNOPSIShtcobol [ options ] filename
DESCRIPTION
A compiler for the COmmon Business Oriented Language, COBOL.
Htcobol reads a COBOL source in the file filename and depending on the
option, will preprocess, compile, assemble and link to generate an exe‐
cutable binary.
The compiler generates GNU assembler for the IA32 (i386) platforms.
With the aid of the GCC tool set, this intermediate code can then be
assembled and linked to create an executable binary.
A executable binary can be created either directly by the compiler, or
by generating intermediate assembler code and using a Makefile for the
assemble and link steps.
The compiler recognizes several command line options as described
below.
You can get a help message by invoking htcobol with the -h option.
INITIALIZATION FILES
Many compiler options can be set using the resource file and/or command
line options.
Default resource file name is htcobolrc.
The precedence of any compiler option is as follows:
1. Command line options, if available.
2. Environment variables, if available.
3. The resource file options, if available.
4. Compiler default options.
OPTIONS
Compiler specific options:
-h Display help.
-a Create static library; Preprocess, compile, assemble and archive
-B mode Specify binding mode (static/dynamic)
-c Compile to a statically linked object module
-e <name>
Specify entry point name (first program to execute)
-E Output preprocessor to standard output only; do not compile,
assemble or link
-g Generate compiler debugging output
-l <name>
Add library name to link step
-L <dir>
Add directory to library search path
-m Create shared library; Preprocess, compile, assemble and link
-M <option>
Specify main entry point option (auto|first|none)
-n Don't actually run any commands; just print them
-o <file>
Specify output file name
-S Preprocess, compile (generate assembler code) only; do not
assemble or link
-t Doesn't remove the intermediary files (assembly file, pre-pro‐
cessed COBOL file) generated during the compilation.
-v Generate verbose compiler output
-V Display compiler version information and exit
-Wl,<options>
Pass comma-separated <options> on to the linker
-x Compile to an executable module
-z Generate very verbose compiler output
COBOL specific options:
-C Make all COBOL calls dynamic
-D Include source debugging lines
-F Input source is in standard fixed column format
-I <path>
Define include (copybooks) search path(s) (default -I./) The
path may be either a single directory, or a list of directories
separated by a `:' (`;' on the Win32 platform).
-P Generate output listing file
-T <num>
Expand tabs to number of space(s) (default T=8)
-X Input source is in X/Open free format (default format)
FILES
htcobolrc - Compile options file.
htrtconf - Run-time options file.
ENVIRONMENT
TCOB_OPTIONS_PATH
Options file directory path.
TCOBRT_CONFIG_DIR
Run-time options file directory path.
TCOB_LD_LIBRARY_PATH and LD_LIBRARY_PATH
Dynamically loaded libraries search path (excluding Win32).
TEMP Temporary files directory path.
SEE ALSOGCC(1), as(1), ld(1), make(1).
4.3 Berkeley Distribution January 22, 2002 HTCOBOL(1)