# Compaq COBOL
for Tru64 UNIX Systems

# Installation Guide

Order Number: AA--Q2G2J--TE

# November 2002

This guide describes how to install Compaq COBOL on an Alpha system running the Tru64 UNIX operating system. It applies to Compaq COBOL Version 2.8 and any maintenance updates for this version.

Revision/Update Information: This manual supersedes the Version 2.7 Compaq COBOL for Tru64 UNIX Systems Installation Guide.

Operating System & Version: Compaq Tru64 UNIX Version 5.0 or higher. Future releases may require higher versions.

Software Version: Compaq COBOL Version 2.8
Compaq Computer Corporation Houston, Texas

© 2002 Compaq Information Technologies Group, L.P.

Compaq, the Compaq logo, OpenVMS, Tru64, VAX, and VMS are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries.

UNIX and X/Open are trademarks of The Open Group in the U.S. and/or other countries.

All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

None of Compaq, Hewlett-Packard Company ("HP") or any other direct or indirect subsidiary of HP shall be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq or HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.

ZK6295

Contents

# Preface

This installation procedure creates Compaq COBOL file systems subordinate to the `/usr/lib` , `/usr/shlib` , `/usr/bin` , and `/usr/man` directories.

Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall Compaq COBOL for any other reason.

# Intended Audience

This guide is intended for system managers who install Compaq COBOL.

# Associated Documentation

In addition to this guide, the Compaq COBOL documentation set includes the following:

- Compaq COBOL Reference Manual (revised for this release)
- Compaq COBOL User Manual (revised for this release)
- Compaq COBOL Release Notes (see Section 1.1)
- `cobol` (1) reference page
- Read Before Installing or Using Compaq COBOL Version V2.8 for Tru64 UNIX Systems cover letter

You may also find the following documentation useful:

- Guide to Software License Management
- `lmf` (8) reference page
- Guide to Sharing Software on a Local Area Network
- The Tru64 UNIX for Alpha installation guide

# Conventions

Table 1 describes the conventions used in this guide.

Table 1 Conventions Used in This Guide
Convention | Meaning
--- | ---
# | A pound sign (#) is the default superuser prompt.
% | A percent sign (%) is the default user prompt.
`[Enter]` | In examples, a boxed symbol indicates that you must press the named key on the keyboard.
Ctrl/C | This symbol indicates that you must press the Ctrl key while you simultaneously press another key (in this case, C).
`user input` | In interactive examples, the bold typeface indicates input entered by the user.
`filesystem` | In text, this typeface indicates the exact name of a command, routine, partition, pathname, directory, or file. This typeface is also used in examples and other screen displays.
UPPERCASE lowercase | The Tru64 UNIX operating system differentiates between lowercase and uppercase characters. Examples, syntax descriptions, function definitions, and literal strings that appear in text must be typed exactly as shown.
`setld` (8) | Cross-references to online reference pages include the appropriate section number in parentheses. For example, `setld` (8) indicates that you can find the material on the `setld` command in Section 8 of the reference pages.
`[y]` | In a prompt, square brackets indicate that the enclosed item is the default response. For example, `[y]` means the default response is Yes.
n | The minor (point) release of Compaq COBOL in examples is shown by n, as in COBOL02 n. For Version 2.8, you type COBOL028.

# References

In this manual, every use of OpenVMS Alpha means the OpenVMS Alpha operating system and every use of Tru64 UNIX means the Tru64 UNIX for Alpha operating system.

# How to Order Additional Documentation

For information about how to order additional documentation, visit the following World Wide Web address:

    http://www.openvms.compaq.com/

# Reader's Comments

HP welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet | openvmsdoc@hp.com
Mail | Hewlett-Packard Company OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

# Field Test Sites

The Compaq COBOL team would like to acknowledge the contributions of our field test sites in improving our products. The people at these sites provided us with invaluable information, which ultimately resulted in a higher quality, more useful COBOL compiler.

# Chapter 1
Preparing for Compaq COBOL Installation

Your distribution kit includes a letter titled Read Before Installing or Using Compaq COBOL Version 2.8 for Tru64 UNIX Systems. The letter describes important information that might not be included in this guide. You should read this letter now.

# 1.1 Reading the Online Release Notes

Compaq COBOL provides online Release Notes. It is strongly recommended that you read the Release Notes before installing the product. The Release Notes may contain information about changes to the application.

For information about installing the Release Notes before installing Compaq COBOL, see Section 2.3.1.

You can use the following command to read the Release Notes once you have completed the full product installation:

    #  more /usr/lib/cmplrs/cobol/relnotes

# 1.2 Registering Your Software License

Compaq COBOL includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) to use Compaq COBOL on a newly licensed node. The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order.

If you are installing Compaq COBOL as an update on a node already licensed for this software, you have already completed the License PAK registration requirements.

If you are installing prerequisite or optional software along with Compaq COBOL, review the PAK status and install the PAKs for any prerequisite or optional software before you install Compaq COBOL.

To register a license on the Tru64 UNIX operating system, first log in as superuser.

At the superuser prompt, edit an empty PAK template with the `lmf register` command as follows and include all the information on your License PAK:

    #  lmf register

After you register your license, use the following `lmf reset` command to copy the license details from the License Database (LDB) to the kernel cache:

    #  lmf reset

For complete information on using the License Management Facility, see the Guide to Software License Management and the `lmf` (8) reference page.

# 1.3 Checking the Software Distribution Kit

Use the Bill of Materials (BOM) to check the contents of your Compaq COBOL software distribution kit.

In addition to this guide, the software distribution kit includes the following:

- A CD-ROM optical disk for systems with optical disk drives
- A CD-ROM user guide and CD-ROM read first letter

If your software distribution kit is damaged or incomplete, contact your Compaq representative.

# 1.4 Checking Installation Procedure Requirements

This section describes various requirements for installing Compaq COBOL.

Installing Compaq COBOL, including running the Installation Verification Procedure (IVP), takes approximately 8 to 10 minutes, depending on your type of media and system configuration.

## 1.4.1 Checking Login Privileges

You must have superuser privileges to install the Compaq COBOL software and to register the License PAK.

## 1.4.2 Checking Hardware Requirements

To install Compaq COBOL, you need the following hardware:

- Software distribution device (if installing from media)
  Locate the CD-ROM drive for the CD-ROM software distribution media. The CD-ROM user guide or the documentation for the CD-ROM drive that you are using explains how to load the CD-ROM media.
- Terminal
  You can use either a hardcopy or video terminal to communicate with the operating system and to respond to prompts from the installation procedure.

See the Compaq COBOL Software Product Description (SPD) for additional hardware requirements.

## 1.4.3 Checking Software Requirements

Compaq COBOL Version 2.8 requires the operating system Compaq Tru64 UNIX Version 5.0 or higher. (Future Compaq COBOL releases may require higher versions. See the Read Before Installing letter or the online Release Notes for information about the minimum version of the operating system required.)

To check the version of your operating system, enter the following command:

    # uname -r

The system will respond with the version number of the installed operating system.

Compaq COBOL also requires that the following operating system software subsets be loaded on the system where you install Compaq COBOL:

- OSFBASE---Base System subset
- OSFCMPLRS---Compiler Back End
- DFARTL---Fortran Run-Time Libraries
- SORLIB1---SORT Run-Time Library
- OSFPGMR---Standard Programmer Commands
- OSFLIB---Static Libraries
- OSFOBSOLETE (optional)---Obsolete Commands and Utilities

Note Programs built -call_shared (the default) with DIGITAL COBOL V2.5 or earlier require the file
    /usr/shlib/osf.1/libcurses.so
This file can be installed from the optional subset OSFOBSOLETE supplied with your Tru64 UNIX installation kit. If you have programs built -call_shared with DIGITAL COBOL V2.5 or earlier, and you do not have this version of `libcurses.so` installed, the programs will not load, and the following fatal error will be seen at load time:
    a.out /sbin/loader: Fatal Error: object libcurses.so from liblist
    in a.out has version "osf.1", which does not match the found object:
    /usr/shlib/libcurses.so (with version "xpg4")
If you rebuild your programs with Compaq COBOL V2.8, you do not need to install OSFOBSOLETE.

To check whether these subsets are loaded, follow these steps:

1. Log in to the system where you will install Compaq COBOL.
2. Enter the following command:

       # setld -i | egrep 'OSFBASE|OSFCMPLRS|DFARTL|SORLIB|OSFOBSOLETE|OSFPGMR|OSFLIB'

If you do not log in as superuser (login name `root` ), you must enter the full path of the command. For example:

    % /usr/sbin/setld -i | egrep 'OSFBASE|OSFCMPLRS|...'

Check the displayed rows for the name of the relevant subset and any related patches. The word "installed" appears in a row after the subset identifier when a subset is loaded. If the word "installed" does not appear (the second column in a row is blank), the subset or patch is not loaded. In this case, you must load the missing operating system software before installing Compaq COBOL. (For information on how to load it, see the Tru64 UNIX installation guide.)

For example, the following message shows that everything you need is loaded to install Compaq COBOL:

    # setld -i | egrep \"OSFBASE|OSFCMPLRS|DFARTL|SORLIB|OSFOBSOLETE|OSFPGMR|OSFLIB|DCA|O2A" \| grep installed

    DCABASE270           installed  Compaq COBOL V2.7 for Tru64 UNIX
    DCADOC270            installed  Compaq COBOL V2.7 Release Notes
    DCAMAN270            installed  Compaq COBOL V2.7 Man Pages
    DCARTL270            installed  Compaq COBOL RTL V2.7 for Tru64 UNIX
    DFARTL394            installed  Compaq Fortran RTL #394 for Compaq
    O2ABASE270           installed  Compaq Decimal RTL V2.6 for Tru64 UNIX
    OSFBASE520           installed  Base System (- Required -)
    OSFCMPLRS520         installed  Compiler Back End (Software Develop)
    OSFLIBA520           installed  Static Libraries (Software Developm)
    OSFOBSOLETE520       installed  Obsolete Commands and Utilities (Ob)
    OSFPGMR520           installed  Standard Programmer Commands (Softw)
    SORLIB400            installed  Sort Runtime Library

## 1.4.4 Determining Which Subsets to Load

You must choose the Compaq COBOL subsets that you want to load. Section 2.3.1 tells you how to specify your choices.

The Compaq COBOL subsets have the following titles:

- DCABASE280
  Compaq COBOL Version 2.8 for Tru64 UNIX Systems
- DCADOC280
  Compaq COBOL Version 2.8 Release Notes
- DCAMAN280
  Compaq COBOL Version 2.8 Reference Page
- DCARTL280
  Compaq COBOL Run-Time Support Library
- O2ABASE280
  Compaq COBOL Decimal Run-Time Support

## 1.4.5 Determining Disk Space Requirements

Table 1-1 lists the disk space requirements for loading Compaq COBOL software. These requirements apply to the disks where you load the Compaq COBOL subsets. The requirements are listed by directory for convenience if you are doing installations on systems where these directories are mount points for different disk partitions.

Table 1-1 Compaq COBOL Directory Sizes (Kilobytes Required)
Subset Name | Directory | Size (Kbytes)
--- | --- | ---
DCARTL280 | /usr | 1
| /usr/lib/cmplrs | 1
| /usr/lib/cmplrs/cobolrtl_280 | 1700
| /usr/lib/nls | 1
| /usr/lib/nls/msg | 1
| /usr/lib/nls/msg/en_US.88591 | 1
| /usr/shlib | 1
O2ABASE280 | /usr | 1
| /usr/lib/cmplrs | 1
| /usr/lib/cmplrs/o2abase_280 | 1000
DCABASE280 contains DCADOC280 and DCAMAN280 | /usr | 1
| /usr/lib/cmplrs | 1
| /usr/lib/cmplrs/cobol_280 | 11000
| /usr/share | 1
| /usr/share/man | 1
| /usr/share/man/man1 | 1
APPROXIMATE TOTAL |  | 14000K

1For DIGITAL UNIX Versions 4.0D and 4.0E and Tru64 UNIX Versions 4.0F and higher, it is also on the Tru64 UNIX base system kit.

Appendix B shows a further breakdown of files that will be installed on your system by this installation.

Using the disk space requirements from Table 1-1 as guidelines, total the values for the subsets that you will load in each directory.

Compare the suggested space required for subsets with the free space currently on the disks where Compaq COBOL files will reside.

### 1.4.5.1 Checking Current Disk Space

To check the current amount of free space for a directory path, log in to the system where you will install Compaq COBOL. You can check which directories are mounted and where they are by viewing the `/etc/fstab` file. For example:

    # more /etc/fstab
    /dev/rd0a:/:rw:1:1:ufs::
    /dev/rd0g:/usr:rw:1:2:ufs::
    /usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg:
    /usr/man@bigsys:/usr/man:ro:0:0:nfs:bg:

The display indicates that `/usr` (mounted to `/dev/rd0g` ) is the only mount point that affects where Compaq COBOL files will reside. The system has only one local disk drive, and the `/usr/lib` and file system resides in the `g` partition of the disk on that drive.

To check the total space and the free space for the directories where Compaq COBOL will reside, enter the `df` command. Given the previous display of the `/etc/fstab` file, which shows that only `/usr` is a mount point, you need to check free space only in the `/usr` file system. For example:

    # df -k /usr
    Filesystem   Total    kbytes   kbytes   %
    node         kbytes   used     free     used  Mounted on
    /dev/rd0g     122598   54447   55892    49%   /usr

This display shows that there are 55,892 Kbytes free. Your free space must accommodate the subset requirements listed in Table 1-1.

On systems where `/usr/lib` , `/usr/shlib` , and `/usr/man` are mounted to different devices from `/usr` , enter the following command:

    #  df /usr/lib /usr/shlib /usr/man

In this case, you compare space required for Compaq COBOL files in `/usr/lib, /usr/shlib,` and `/usr/man` to the free space displayed in the first, second, and third line of the `df` output list, respectively.

Note #### 1 See the section on additional subsets in the Tru64 UNIX installation guide for more information.

Next | Contents