Verifying Your POSIX Installation

Once your products are installed, you can verify that the installation was successful by compiling and running the "TOURHP" program. (Refer to Chapter 4 in Transitioning to ACUCOBOL-GT for detailed information about compiling and running programs in the HP e3000 environment.)

To test your installation,

1. Log into your account.
2. Make sure that the account has the PH capabilities for "Account," "User," and "Group" described in Before Installing extend Products if needed.
3. Then compile and run the "TOURHP" program.

   TOURHP is a special sample program for HP e3000 users that demonstrates how to use the ACUCOBOL-GT compiler and runtime. It also creates a small KSAM file.

4. Invoke the POSIX shell with the following command:

   :SH

5. Type the following environment variables at the shell prompt (on the third line below, "hp" is just an example; substitute the correct name of the terminal you are using):

   shell/iX> export PATH="$PATH:/ACUCOBOL/bin"
   shell/iX> export A_TERMCAP="/ACUCOBOL/etc/a_termcap"
   shell/iX> export A_TERM="hp"

   Note: If you don't want to type these variables each time you invoke the POSIX shell, set them in your ".profile" file.
6. Go to the sample directory and compile the "TOURHP" program:

   shell/iX> cd /ACUCOBOL/sample
   shell/iX> ccbl -cp -gd -v TOURHP

   In the command shown above,

   • The "-cp" option places the ACUCOBOL-GT compiler in HP COBOL compatibility mode. The compiler will automatically select a file with the ".cbl" extension.
   • The "-gd" option includes source code information in the object file for use with the interactive debugger.
   • The "-v" option places the compiler in "verbose" mode so that you will see messages displaying the compiler's status.

   When you press Enter after typing this command, you should see the following messages:

   Start TOURHP
          Data Division
          Procedure Division
          Including Debugging Info
          Writing Code Addresses
       Compilation complete

   Compiling the "TOURHP" program creates an object file in the same directory with the same prefix, "TOURHP", but with an extension of ".acu".

7. Now run the compiled program with the following command:

   shell/iX> runcbl -c CNFGVAR TOURHP

   In this case, the "-c" option tells the runtime to look for the configuration file named "CNFGVAR". This file sets the variable "DEFAULT_HOST" to "KSAM", causing the runtime to create KSAM files instead of Vision files. The runtime automatically selects a file with the ".acu" extension. The "TOURHP" application creates a small KSAM file.

   If you get the message "Can't find entry for terminal in /ACUCOBOL/etc/a_termcap ", you need to configure your terminal for ACUCOBOL-GT. For more information, see ACUCOBOL-GT User's Guide > Termminal Manager.
8. When you have the "TOURHP" program running, you may want to set a configuration file to support the printers you have attached to your system. You may edit the "CNFGVAR" file supplied with the "TOURHP" program or the "/ACUCOBOL/etc/cblconfi" file supplied with ACUCOBOL-GT. (The "cblconfi" file is used by default, unless you specify a different file with the "-c" runtime option.) For more information about working with the configuration file, see ACUCOBOL-GT User's Guide > Compiler and Runtime > Runtime Configuration.
   Note: EDITOR/iX cannot edit HFS files, so you need to use an editor that can or move the file to a valid MPE/iX group using an MPE/iX name in uppercase.
9. Read the "RELEASE" file (if present). It contains changes to the products not covered in the documentation.

   You can display the "RELEASE" file using the more command from the shell. For example:

   shell/iX> more /ACUCOBOL/RELEASE