Compaq COBOL for Tru64 UNIX Systems

Compaq COBOL
for Tru64 UNIX Systems

Installation Guide

Order Number: AA--Q2G2H--TE

October 2000

This guide describes how to install Compaq COBOL (formerly known as DIGITAL COBOL or DEC COBOL) on an Alpha system running the Tru64 UNIX operating system.

This guide applies to Compaq COBOL Version 2.7 and any maintenance updates for this version.

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

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

Software Version: Compaq COBOL Version 2.7



Compaq Computer Corporation Houston, Texas

© 2000 Compaq Computer Corporation

COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo Registered in U.S. Patent and Trademark Office.

OpenVMS and Tru64 are trademarks of Compaq Information Technologies Group, L.P.

Microsoft, MS-DOS, Win32, Windows, and Windows NT are trademarks of Microsoft Corporation.

Motif, OSF/1, UNIX, and X/Open are trademarks of The Open Group.

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.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND WHETHER IN AN ACTION OF CONTRACT OR TORT, INCLUDING NEGLIGENCE.

The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or 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:

You may also find the following documentation useful:

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.
[Return] 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.7, you type COBOL027.

References

In this manual, every use of OpenVMS Alpha means the OpenVMS Alpha operating system and every use of Tru64 UNIX means the Compaq Tru64 UNIX operating system. Compaq Tru64 UNIX is the new name (as of Version 4.0F) for DIGITAL UNIX.

As of Version 2.6, DIGITAL COBOL has been renamed Compaq COBOL.

How to Order Additional Documentation

For information on pricing and where to buy documentation and other Compaq products in the United States and Canada, please call toll-free 1-800-282-6672.

Reader's Comments

Compaq appreciates your comments. If you find errors or want to comment about this manual, please send the manual title, order number, and your comments by one of the following methods:

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.7 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 when installed: 


#  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:

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:

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

1.4.3 Checking Software Requirements

Compaq COBOL Version 2.7 requires the operating system Compaq Tru64 UNIX Version 4.0F 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:

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.7, 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 
DFARTL369            installed  Digital Fortran RTL #369 for Digital UNIX Alpha 
DFARTL384            installed  DIGITAL Fortran RTL #384 for DIGITAL UNIX Alpha ... 
O2ABASE270           installed  Compaq Decimal RTL V2.6 for Tru64 UNIX 
OSFBASE440           installed  Base System (- Required -) 
OSFCMPLRS440         installed  Compiler Back End (Software Development) 
OSFLIBA440           installed  Static Libraries (Software Development) 
OSFOBSOLETE440       installed  Obsolete Commands and Utilities (System Administration) 
OSFPGMR440           installed  Standard Programmer Commands (Software Development) 
SORLIB300            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:

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)
DCARTL270 /usr 1
  /usr/lib/cmplrs 1
  /usr/lib/cmplrs/cobolrtl_270 1700
  /usr/lib/nls 1
  /usr/lib/nls/msg 1
  /usr/lib/nls/msg/en_US.88591 1
  /usr/shlib 1
O2ABASE270 /usr 1
  /usr/lib/cmplrs 1
  /usr/lib/cmplrs/o2abase_270 1000
DCABASE270
contains DCADOC270
and DCAMAN270 		/usr 1
  /usr/lib/cmplrs 1
  /usr/lib/cmplrs/cobol_270 8000
  /usr/share 1
  /usr/share/man 1
  /usr/share/man/man1 1
     
APPROXIMATE TOTAL   11000K

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