Runtime environment

Environment Summary

Required Libraries

libhtcobol.so – Soft link to TinyCOBOL run-time

libhtcobol.so.0 – Soft link to TinyCOBOL run-time

libhtcobol.so.0.61.x - TinyCOBOL run-time (version 0.61.x )

libc.so - GNU C

libdl.so - Dynamic loader

libm.so - GNU C math

libdb.so - Berkeley's DB API (this is sometimes a soft link)

libncurses.so - Curses for screen I/O

ld-linux.so - Linux loader (Linux O/Ses only)

Environment Variables

All environment variables are optional.

TCOB_OPTIONS - Resource options file name

TCOB_OPTIONS_PATH - Directory path to the resource options file

TCOB_PP_PATH - Preprocessor directory path

TCOB_LD_LIBRARY_PATH – Directory path to the dynamically loaded libraries

TEMP - Directory path to the temporary files

Default Directory Structure from tarball and FreeBSD sysinstall

/usr/local/bin/ – Compiler location

/usr/local/lib/ – Runtime libraries location

/usr/local/share/htcobol/ – Preprocessor, resource file

/usr/local/share/htcobol/copybooks/ - Default copybook library

Default Directory Structure from RPM

/usr/bin/ – Compiler location

/usr/lib/ – Runtime libraries location

/usr/share/htcobol/ – Preprocessor, resource files

/usr/share/htcobol/copybooks/ – Copybook default library

/usr/share/doc/tinycobol-0.61/ – Documentation, readme, release notes

Files

htcobolrc – Default runtime library

External Programs

lockserver – A daemon for handling record locking

Environment Details

libhtcobol.so, libhtcobol.so.0, libhtcobol.so.0.61.x

The TinyCOBOL run-time libraries.

libhtcobol.so.0.61.x is the runtime library used by the 0.61.x version of TC. libhtcobol.so and libhtcobol.so.0 are soft links to libhtcobol.so.0.61.x.

libc.so

The GNU C runtime library.

libdl.so

The dynamic loader library.

The compiler uses the dl program to dynamically load other programs. Parameters from htcobolrc are passed to dl. The parameters are modified under some circumstances.

libm.so

The GNU C math library.

libdb.so

The library for Berkeley DB. Use version 1.85.4 or newer.

On some systems, this will be a link to another library because the actual library was given another name. The TinyCOBOL INSTALL file has more information on this and so does the section in this User Manual titled “Berkeley DB.”

Berkeley DB is required for the use of indexed files.

libncurses.so

The PDcurses library which is used for screen I/O. Use version 2.4 or newer. A section on screen I/O is included in this manual. PDcurses is available through the TinyCOBOL.org download page.

ld-linux.so

The Linux loader . This is not needed by FreeBSD.

TCOB_OPTIONS

The environment variable used to override the name of the resource options file.

If this variable is not defined, the name of the resource option file is htcobolrc.

TCOB_OPTIONS_PATH

The environment Directory path to the resource options file.

If this variable is not defined, the path to the resource options file is

/usr/local/share/htcobol/ for tarball and FreeBSD installations or

/usr/share/htcobol/ for RPM installations.

TCOB_PP_PATH

The path to the preprocessor.

If this variable is not defined, the path to the preprocessor is

/usr/local/share/htcobol/ for tarball and FreeBSD installations or

/usr/share/htcobol/ for RPM installations.

TCOB_LD_LIBRARY_PATH

The path to the dynamically loaded libraries.

If this variable is not defined, the path to the load library is

/usr/local/lib/ for tarball and FreeBSD installations or

/usr/lib/ for RPM installations.

TEMP

The path to the temporary files created by the TC compiler.

htcobolrc

The file containing the default values for the compiler options. A section on htcobolrc is included in this manual.

lockserver

A daemon which handles record locking services for indexed files. lockserver must be installed and running before TinyCOBOL programs can user record locking on indexed files. A section on the lockserver is included in this manual.

2004-01-28T17:18:09