Using ACUCOBOL-GT in POSIX Environments

The ACUCOBOL-GT development system can be run in HP COBOL compatibility mode in the MPE/iX POSIX shell. This section discusses some basic issues related to the installation, startup, and running of ACUCOBOL-GT under the POSIX shell on HP e3000 platforms.

To install ACUCOBOL-GT on your system, you must have MPE/iX release 5.0 or later. The installation procedure, including the installation of license files, is described in detail in Installation on HP e3000 Machines. The installation procedure gives the exact command line syntax you should use, first to get from the basic MPE/iX level to the POSIX shell, and then to install and run ACUCOBOL-GT. In addition, useful information on printing from the POSIX shell is included.

To get your existing COBOL applications running with ACUCOBOL-GT, you need to recompile the source. The name of the ACUCOBOL-GT compiler executable is ccbl and you invoke it with the following command. For complete information on invoking the compiler, see Compiler and Runtime.

ccbl <filename.cbl>

The resulting object file has the same base name as the source file plus the extension .acu. Unlike the native HP COBOL system, the ACUCOBOL-GT object does not require linking.

To run your program, invoke it with ACUCOBOL-GT run-time command runcbl. To invoke it, enter the following command.

For complete information on using the runtime, see Compiler and Runtime.

runcbl <filename.acu>

Any programs that are called during execution are loaded dynamically by the run time. Subprograms written in C may be linked into the run-time system directly, and then called by a COBOL program using the CALL verb. For details regarding linking a C program into the runtime, see Working with C and C++ Programs.

There are many compile and run-time options that you can also include in the command arguments to compile or execute your ACUCOBOL-GT program. To view a list of compiler options, entering the following command:

ccbl -help
Note: You should use the command line options in lieu of the HP COBOL $CONTROL directives.

For detailed descriptions of the ACUCOBOL-GT compiler and runtime, including all of the command line options and utility programs, see Compiler and Runtime and Debugger and Utilities.