Order Number: AA--Q2G2J--TE
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 |
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.
This guide is intended for system managers who install Compaq COBOL.
In addition to this guide, the Compaq COBOL documentation set includes the following:
You may also find the following documentation useful:
Table 1 describes the 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. |
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.
For information about how to order additional documentation, visit the following World Wide Web address:
http://www.openvms.compaq.com/ |
HP welcomes your comments on this manual. Please send comments to either of the following addresses:
| Internet | openvmsdoc@hp.com |
|
Hewlett-Packard Company
OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 |
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.
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 |
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.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:
Programs built -call_shared (the default) with DIGITAL COBOL V2.5 or earlier require the file
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:
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:
# 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 |
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:
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.
| 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 |
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.
1 See the section on additional subsets in the Tru64 UNIX installation guide for more information. |
| Next | Contents |