This appendix includes instructions for installing ACUCOBOL-GT on each class of machine and operating system supported. In addition, the first section describes several special files that are part of the ACUCOBOL-GT compiler and runtime system. A license file is required for most Acucorp products; this file is described in detail in section A.1. This section also describes some of the sample programs included with the release materials, and introduces the standard Acucorp definition (".def") files that are also included in the release materials. The second section provides a short primer on how to identify and configure the terminal for ACUCOBOL-GT.
Note that the amount of disk space generally needed to install ACUCOBOL-GT is typically less than 4MB.
License management
Most Acucorp products require a license file in order to operate. This file contains information such as the product's version number, serial number, expiration date, and user count. The ACUCOBOL-GT compiler and runtime are each shipped with a license file, and each product must be able to locate its license file in order to function.
Each product searches for its license file in the same directory where its executable resides. The product expects the license file to have the same base name as the product's executable, with a special extension assigned by Acucorp.
License file names
The name of each license file distributed by Acucorp is based on the name of the product's executable file, with a special extension. For example, if your runtime executable is named "runcbl.exe," then the runtime license file is named "runcbl.alc," and the Acu4GL for Sybase license file is named "runcbl.ylc." If your compiler executable is delivered as "ccbl.exe" then the compiler license file is "ccbl.alc."
If you rename the product's executable file, then you should change the base name of the license file to match it, and leave the license file extension unchanged. For example, if you rename your compiler from "ccbl.exe" to "mycomp.exe," then you must rename the license file from "ccbl.alc" to "mycomp.alc."
License file directory
Each product searches for its license file in the same directory where its executable resides. If you move the product's executable to a new directory, be sure to move its license file as well.
If no license file is found, or if the information in the license file does not permit execution, the product exits with an error message.
Sample programs
ACUCOBOL-GT includes many sample programs in the standard release materials. These programs demonstrate general and specific features of the system and measure some aspects of system performance. Many of these programs can serve as generic templates for developing similar functionality in your programs.
Some of the sample programs provided with ACUCOBOL-GT are stand-alone programs, designed to be run at the command line. Examples include:
TOUR.CBL (demonstrates features of the compiler)
IOBENCH.CBL (provides benchmark statistics)
GENMENU.CBL (creates COBOL code for menu bars)
Special instructions for compiling "iobench.cbl" are found in the first few lines of its source file.
Some of the sample programs can either be called from another program or run from the command line:
CALC3.CBL (provides a pop-up calculator)
NOTEPAD.CBL (offers a pop-up notepad for notes and reminders)
Many of the sample programs are subroutines that must be called from another program. You can call them from "tour.cbl" or from your own application:
MESSAGE.CBL (shows how to send up to three lines of text to the user and
receive a standard numeric response code)
MENUBAR.CBL (demonstrates pop-up and static menu bars)
MENUBAR2.CBL (demonstrates pop-up and static menu bars for graphical
environments)
PRNTSCRN.CBL (shows how to print screens using the ACCEPT FROM SCREEN verb)
Definition files
ACUCOBOL-GT includes a number of definition files. These files make it easier to use some of ACUCOBOL-GT's special features, such as graphical controls, color configuration, and Windows HELP. Many of the definition files contain predefined data structures for use with ACUCOBOL-GT runtime routines. You can include these structures easily in your program by COPYing the definition file into your program. All of the definition files have the three character ".def" extension in their name. Most reside in the "sample" subdirectory of your ACUCOBOL-GT directory. How and when to use these files are documented with the feature or function that the file supports (such as with a runtime library routine or in Special Names section).