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 super- sedes 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 This document was prepared using DECdocument, Version 3.3-1b. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing for Compaq COBOL Installation 1.1 Reading the Online Release Notes............. 1-1 1.2 Registering Your Software License............ 1-1 1.3 Checking the Software Distribution Kit....... 1-2 1.4 Checking Installation Procedure Requirements................................. 1-2 1.4.1 Checking Login Privileges................ 1-3 1.4.2 Checking Hardware Requirements........... 1-3 1.4.3 Checking Software Requirements........... 1-3 1.4.4 Determining Which Subsets to Load........ 1-5 1.4.5 Determining Disk Space Requirements...... 1-6 1.4.5.1 Checking Current Disk Space............ 1-7 1.4.5.2 Increasing Disk Space by Using Alternative Disks ..................... 1-8 1.5 Installing from Media or Using Remote Installation Service ........................ 1-9 1.6 Backing Up Your System Disk.................. 1-9 1.7 Stopping the Installation.................... 1-10 2 Installing Compaq COBOL 2.1 Using CD-ROM Consolidated Distribution Media........................................ 2-1 2.2 Using an RIS Distribution Area .............. 2-2 2.3 Responding to Installation Procedure Prompts...................................... 2-2 2.3.1 Selecting Subsets........................ 2-2 2.3.2 Monitoring Displays During the Subset Loading Process.......................... 2-4 iii 3 After Installation 3.1 Running the Installation Verification Procedure ................................... 3-1 3.2 Deleting a Version of Compaq COBOL from Your System....................................... 3-2 A Sample Installation and Verification A.1 Sample Compaq COBOL Installation............. A-1 A.2 Sample Compaq COBOL Installation Verification................................. A-6 B Files Installed on Your System C Recovering from Errors C.1 Failures During Product Installation ........ C-1 C.2 Failures During Compaq COBOL Use............. C-2 Examples A-1 Sample Compaq COBOL Installation......... A-1 A-2 Sample Compaq COBOL Installation Verification............................. A-6 Tables 1 Conventions Used in This Guide .......... vi 1-1 Compaq COBOL Directory Sizes (Kilobytes Required)................................ 1-6 B-1 Installed Compaq COBOL Files............. B-1 iv ________________________________________________________________ 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: o Compaq COBOL Reference Manual (revised for this release) o Compaq COBOL User Manual (revised for this release) o Compaq COBOL Release Notes (see Section 1.1) o cobol(1) reference page o Read Before Installing or Using Compaq COBOL Version V2.8 for Tru64 UNIX Systems cover letter You may also find the following documentation useful: o Guide to Software License Management o lmf(8) reference page o Guide to Sharing Software on a Local Area Network v o 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. 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 The Tru64 UNIX operating system differ- lowercase entiates between lowercase and uppercase characters. Examples, syntax descriptions, function definitions, and literal strings that appear in text must be typed exactly as shown. (continued on next page) vi Table_1_(Cont.)_Conventions_Used_in_This_Guide____________ Convention_____Meaning____________________________________ 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 COBOL02n. _______________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 documenta- tion, 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 vii 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. viii 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 installa- tion: # 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. Preparing for Compaq COBOL Installation 1-1 Preparing for Compaq COBOL Installation 1.2 Registering Your Software License 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: o A CD-ROM optical disk for systems with optical disk drives o A CD-ROM user guide and CD-ROM read first letter If your software distribution kit is damaged or incom- plete, 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-2 Preparing for Compaq COBOL Installation Preparing for Compaq COBOL Installation 1.4 Checking Installation Procedure Requirements 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: o 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. o 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: o OSFBASE-Base System subset o OSFCMPLRS-Compiler Back End o DFARTL-Fortran Run-Time Libraries Preparing for Compaq COBOL Installation 1-3 Preparing for Compaq COBOL Installation 1.4 Checking Installation Procedure Requirements o SORLIB[1]-SORT Run-Time Library o OSFPGMR-Standard Programmer Commands o OSFLIB-Static Libraries o 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| . . . ' ___________________ [1]See the section on additional subsets in the Tru64 UNIX installation guide for more information. 1-4 Preparing for Compaq COBOL Installation Preparing for Compaq COBOL Installation 1.4 Checking Installation Procedure Requirements 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: o DCABASE280 Compaq COBOL Version 2.8 for Tru64 UNIX Systems o DCADOC280 Compaq COBOL Version 2.8 Release Notes o DCAMAN280 Compaq COBOL Version 2.8 Reference Page Preparing for Compaq COBOL Installation 1-5 Preparing for Compaq COBOL Installation 1.4 Checking Installation Procedure Requirements o DCARTL280 Compaq COBOL Run-Time Support Library o 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 re- quirements 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/cobolr1700 280 /usr/lib/nls 1 /usr/lib/nls/msg 1 /usr/lib/nls/msg/en_ 1 US.88591 /usr/shlib 1 O2ABASE280 /usr 1 /usr/lib/cmplrs 1 /usr/lib/cmplrs/o2abas1000 280 DCABASE280 /usr 1 contains DCADOC280 and DCAMAN280 /usr/lib/cmplrs 1 (continued on next page) 1-6 Preparing for Compaq COBOL Installation Preparing for Compaq COBOL Installation 1.4 Checking Installation Procedure Requirements Table 1-1 (Cont.) Compaq COBOL Directory Sizes (Kilobytes __________________Required)_____________________________________ Subset_Name______Directory_____________Size_(Kbytes)____________ /usr/lib/cmplrs/cobol_11000 280 /usr/share 1 /usr/share/man 1 /usr/share/man/man1 1 APPROXIMATE 14000K TOTAL___________________________________________________________ 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. Preparing for Compaq COBOL Installation 1-7 Preparing for Compaq COBOL Installation 1.4 Checking Installation Procedure Requirements 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.4.5.2 Increasing Disk Space by Using Alternative Disks The Compaq COBOL installation procedure creates some directories and loads files into subordinate directories, as listed in /usr/lib/cmplrs/cobol/filelist If the /usr/lib/cmplrs directory node in the previous paths does not exist, the installation procedure creates it. If the /usr/lib/cmplrs node does exist, the installation procedure uses it. If you find that there is insufficient disk space for the Compaq COBOL subsets and you know that you have additional space on alternative disks or disk partitions for your system, perform the following steps before installing Compaq COBOL: 1. Log in as superuser. 1-8 Preparing for Compaq COBOL Installation Preparing for Compaq COBOL Installation 1.4 Checking Installation Procedure Requirements 2. Create the directory /usr/lib/cmplrs, /usr/lib/cmplrs/cobol_ nnn, or both (in this guide, nnn is the Compaq COBOL version number). 3. Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space. 4. Enter the mount -a command so the new mount points take effect. 1.5 Installing from Media or Using Remote Installation Service Someone from your site must perform at least one Compaq COBOL installation from the distribution medium. Your site system manager can then decide whether or not to make a Compaq COBOL distribution kit available on line so that subsequent installations of Compaq COBOL can use the Remote Installation Service (RIS). For information on extracting Compaq COBOL subsets to a RIS distribution area, see the Guide to Sharing Software on a Local Area Network. If you expect to use Compaq COBOL subsets from the RIS area of a remote system for installation on your local system, first check with your site system manager to ensure that: o A Compaq COBOL network kit is available for use. o Your system is registered as a RIS client. If Compaq COBOL subsets are available to you on a RIS server system, you must know the name of that system. For more information on installing Compaq COBOL from a RIS distribution area, see Section 2.2. 1.6 Backing Up Your System Disk Compaq recommends that you back up your system disk before installing any software. For information about backing up your system disk, see the operating system documentation. Preparing for Compaq COBOL Installation 1-9 Preparing for Compaq COBOL Installation 1.7 Stopping the Installation 1.7 Stopping the Installation To stop the installation procedure at any time, press Ctrl/C. You must then interactively delete files created up to this point. The directories and files created during the Compaq COBOL installation are listed in the following file: /usr/lib/cmplrs/cobol/filelist 1-10 Preparing for Compaq COBOL Installation 2 ________________________________________________________________ Installing Compaq COBOL Before you start the installation, read Chapter 1. You can install Compaq COBOL from a server area. If you encounter any failures during installation, see Appendix C. 2.1 Using CD-ROM Consolidated Distribution Media This procedure loads Compaq COBOL files onto a disk be- longing to the system where you perform the installation. When Compaq COBOL is run, its executable images are mapped into memory on your system. Follow these steps to install Compaq COBOL from CD-ROM media: 1. Mount the media on the appropriate disk drive. 2. Log in as superuser (login name root) to the system where you will install Compaq COBOL. 3. Make sure you are at the root (/) directory by entering the following command: # cd / 4. Specify the /cdrom directory to be the mount point for the distribution file system on the drive. For example, if your drive is ral, enter the following command: # mount -dr /dev/disk/cdrom0c /cdrom 5. Enter a setld command that requests the load function (-l) and identifies the directory in the mounted file system where Compaq COBOL subsets are located: # setld -l /cdrom/AXP/dca280/bin The installation procedure now displays the names of Compaq COBOL subsets and asks you to specify the subsets that you want to load. Installing Compaq COBOL 2-1 Installing Compaq COBOL 2.1 Using CD-ROM Consolidated Distribution Media See Section 2.3 to continue the installation. 2.2 Using an RIS Distribution Area If you are installing Compaq COBOL subsets that reside in an /etc/ris RIS distribution area on a remote system, follow these steps: 1. Log in as superuser (login name root) to the system where you will install Compaq COBOL. 2. Make sure you are at the root directory (/) by entering the following command: # cd / 3. Enter a setld command that requests the load function (-l option) and identifies the system where the Compaq COBOL subsets are located. For example, if you are loading Compaq COBOL subsets from a RIS distribution area on node orion, enter the following: # setld -l orion: Remote Installation Services now displays a menu that lists all the software subsets available to you and the software asks you to specify the subsets that you want to load. See Section 2.3 to continue the installation. 2.3 Responding to Installation Procedure Prompts This section explains the installation procedure prompts and displays. 2.3.1 Selecting Subsets You must specify which Compaq COBOL subsets you want to load. ________________________Note ________________________ If you are installing from a RIS distribution area, the number of subsets can vary depending on what products are available in the RIS area and how many subsets they have. _____________________________________________________ 2-2 Installing Compaq COBOL Installing Compaq COBOL 2.3 Responding to Installation Procedure Prompts The following example shows a display where all Compaq COBOL subsets are being loaded from CD-ROM: *** Enter Subset Selections *** The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) Compaq COBOL RTL V2.8 for Tru64 UNIX 2) Compaq COBOL V2.8 Man Pages 3) Compaq COBOL V2.8 Release Notes 4) Compaq COBOL V2.8 for Tru64 UNIX 5) Compaq Decimal RTL V2.8 for Tru64 UNIX Or you may choose one of the following options: 6) ALL of the above 7) CANCEL selections and redisplay menus 8) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 6 If you have not already read the Release Notes, it is recommended that you enter 3 for installation of the Release Notes subset only. Then read them before installing the other subsets. If you do a full product installation, the Release Notes will be installed in: /usr/lib/cmplrs/cobol/relnotes If you choose to install the Release Notes subset only, the Release Notes will be installed in: /usr/lib/cmplrs/cobol_028/relnotes If you specify more than one number at the prompt, separate each number with a space, not a comma. Next, the script lets you verify your choice. For example, if you enter 6 in response to the previous prompt, you will see the following display: Installing Compaq COBOL 2-3 Installing Compaq COBOL 2.3 Responding to Installation Procedure Prompts You are installing the following optional subsets: Compaq COBOL RTL V2.8 for Tru64 UNIX Compaq COBOL V2.8 Man Pages Compaq COBOL V2.8 Release Notes Compaq COBOL V2.8 for Tru64 UNIX Compaq Decimal RTL V2.8 for Tru64 UNIX Is this correct? (y/n): y If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is again displayed and you can correct your choice of optional subsets. If the displayed subsets are the ones you want to load, enter y. 2.3.2 Monitoring Displays During the Subset Loading Process The installation procedure loads and verifies the selected Compaq COBOL subsets. The procedure should complete in approximately two minutes. When you see the Verifying message during the subset installation, the installation procedure is checking to see that the files are copied correctly; it is not an Installation Verification Procedure (IVP) message. During the installation, if you get errors from the setld utility, see the Diagnostics section of the setld(8) reference page for an explanation of the errors and the appropriate actions to take. 2-4 Installing Compaq COBOL 3 ________________________________________________________________ After Installation This chapter explains what you need to do after the installation to make Compaq COBOL ready for use and how to delete old COBOL subsets. 3.1 Running the Installation Verification Procedure After you install Compaq COBOL, you can run the Installation Verification Procedure (IVP) independently to verify that the software is available on your system. You might also want to run the IVP after a system failure, to be sure that users can access Compaq COBOL. The Compaq COBOL IVP verifies the installation by means of the fverify command with the -y option (see the fverify(8) reference page). The IVP performs various functions for the following files: o DCABASEnnn compiles, loads, and runs a Compaq COBOL program. o DCARTLnnn verifies that the run-time libraries exist. To run the IVP after an installation, enter the following command: # setld -v subsetname In this command, subsetname can be any Compaq COBOL subset. For a sample Compaq COBOL IVP, see Section A.2. If the verification process fails, look in the /var/adm/smlogs/fverify.log file for information to help diagnose the problem. After Installation 3-1 After Installation 3.2 Deleting a Version of Compaq COBOL from Your System 3.2 Deleting a Version of Compaq COBOL from Your System If you must remove a version of Compaq COBOL from your system, delete each subset that you previously installed. To delete subsets: 1. Log in as superuser (login name root). 2. Make sure you are at the root directory (/) by entering the following command: # cd / 3. Enter the following form of the setld command: # setld -i | egrep "Compaq COBOL|Compaq Decimal" 4. Look for the word "installed" in the listing produced. Then delete the installed subsets. For example, to delete the Run-Time Support Library and Decimal Run- Time Support for Compaq COBOL Version 2.7, enter: # setld -d DCARTL270 O2ABASE270 3-2 After Installation A ________________________________________________________________ Sample Installation and Verification The following sections show the result of a sample installation of Compaq COBOL. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation. The sample listings are as follows: o An installation of Compaq COBOL using disk media o An Installation Verification Procedure (IVP) A.1 Sample Compaq COBOL Installation Example A-1 is a log file of a sample installation of Compaq COBOL Version 2.8. Example A-1 Sample Compaq COBOL Installation (continued on next page) Sample Installation and Verification A-1 Sample Installation and Verification A.1 Sample Compaq COBOL Installation Example A-1 (Cont.) Sample Compaq COBOL Installation # 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 %> /usr/sbin/setld -i | egrep "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 O2ABASE270 installed Compaq Decimal RTL V2.6 for Tru64 UNIX %> /usr/sbin/setld -d DCAMAN270 DCADOC270 DCABASE270 DCARTL270 O2ABASE270 DCARTL280, information: Compaq COBOL RTL Shared libraries de-installed. Deleting "Compaq COBOL RTL V2.7 for Tru64 UNIX" (DCARTL270). Deleting "Compaq COBOL V2.7 Man Pages" (DCAMAN270). Deleting "Compaq COBOL V2.7 Release Notes" (DCADOC270). Deleting "Compaq COBOL V2.7 for Tru64 UNIX" (DCABASE270). O2ABASE280, information: Shared library de-installed. Deleting "Compaq Decimal RTL V2.6 for Tru64 UNIX" (O2ABASE270). %> /usr/sbin/setld -l . The subsets listed below are optional: (continued on next page) A-2 Sample Installation and Verification Sample Installation and Verification A.1 Sample Compaq COBOL Installation Example A-1 (Cont.) Sample Compaq COBOL Installation There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) Compaq COBOL RTL V2.8 for Tru64 UNIX 2) Compaq COBOL V2.8 Man Pages 3) Compaq COBOL V2.8 Release Notes 4) Compaq COBOL V2.8 for Tru64 UNIX 5) Compaq Decimal RTL V2.8 for Tru64 UNIX --- MORE TO FOLLOW --- Enter your choices or press RETURN to display the next screen. Estimated free diskspace(MB) in root:110.1 usr:1092.7 Choices (for example, 1 2 4-6): Or you may choose one of the following options: 6) ALL of the above 7) CANCEL selections and redisplay menus 8) EXIT without installing any subsets Estimated free diskspace(MB) in root:110.1 usr:1092.7 Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 6 You are installing the following optional subsets: Compaq COBOL RTL V2.8 for Tru64 UNIX Compaq COBOL V2.8 Man Pages Compaq COBOL V2.8 Release Notes Compaq COBOL V2.8 for Tru64 UNIX Compaq Decimal RTL V2.8 for Tru64 UNIX Estimated free diskspace(MB) in root:110.1 usr:1077.0 Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. (continued on next page) Sample Installation and Verification A-3 Sample Installation and Verification A.1 Sample Compaq COBOL Installation Example A-1 (Cont.) Sample Compaq COBOL Installation 5 subsets will be installed. Loading subset 1 of 5 ... Copyright 2002 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. 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. Installation of this subset proceeds automatically, and should complete in approximately 2 minutes. DCABASE280: warning: Be *sure* to install the Compaq Decimal Run-Time Support Library (O2ABASE) before running the IVP (setld -v) and trying to use Compaq COBOL (DCABASE). DCABASE280: warning: Be *sure* to install the Compaq COBOL RTL for Tru64 UNIX (DCARTL) before running the IVP (setld -v) and trying to use Compaq COBOL (DCABASE). Compaq COBOL V2.8 for Tru64 UNIX Copying from . (disk) Verifying Loading subset 2 of 5 ... Compaq COBOL V2.8 Release Notes Copying from . (disk) Verifying Loading subset 3 of 5 ... Compaq COBOL V2.8 Man Pages Copying from . (disk) Verifying Loading subset 4 of 5 ... Copyright 2002 Compaq Computer Corporation (continued on next page) A-4 Sample Installation and Verification Sample Installation and Verification A.1 Sample Compaq COBOL Installation Example A-1 (Cont.) Sample Compaq COBOL Installation COMPAQ Registered in U.S. Patent and Trademark Office. 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. Installation of this subset proceeds automatically, and should complete in approximately 1 minute. DCARTL280: warning: Be *sure* to install the Compaq Decimal Runtime Support Library (O2ABASE) before running the IVP (setld -v) and trying to use the Compaq COBOL RTL. Compaq COBOL RTL V2.8 for Tru64 UNIX Copying from . (disk) Verifying Loading subset 5 of 5 ... Compaq Decimal RTL V2.8 for Tru64 UNIX Copying from . (disk) Verifying 5 of 5 subsets installed successfully. DCABASE280, information: You can run the Installation Verification Procedure using the following command from root: setld -v DCABASE280 Configuring "Compaq COBOL V2.8 for Tru64 UNIX" (DCABASE280) DCADOC280, information: The release notes are in /usr/lib/cmplrs/cobol_028/relnotes Configuring "Compaq COBOL V2.8 Release Notes" (DCADOC280) Configuring "Compaq COBOL V2.8 Man Pages" (DCAMAN280) Configuring "Compaq COBOL RTL V2.8 for Tru64 UNIX" (DCARTL280) DCARTL280, information: Compaq COBOL RTL Shared libraries installed. (continued on next page) Sample Installation and Verification A-5 Sample Installation and Verification A.1 Sample Compaq COBOL Installation Example A-1 (Cont.) Sample Compaq COBOL Installation Configuring "Compaq Decimal RTL V2.8 for Tru64 UNIX" (O2ABASE280) O2ABASE280, information: Shared library correctly installed. A.2 Sample Compaq COBOL Installation Verification Example A-2 shows a sample installation verification of Compaq COBOL Version 2.8. Example A-2 Sample Compaq COBOL Installation Verification %> /usr/sbin/setld -v DCABASE280 DCARTL280 DCADOC280 DCAMAN280 O2ABASE280 Compaq COBOL V2.8 for Tru64 UNIX (DCABASE280) DCABASE280, information: Copyright 2002 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. 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. DCABASE280: Starting Installation Verification Procedure (IVP). If this fails, please include the following when submitting a report: 1) This subset name, which is DCABASE280 2) Output from: ls -l /tmp/DCABASE280.ivptmp 3) This setld session IVP, information: Created scratch directory. IVP, information: Compiling and linking. IVP, information: Running. IVP, Info: Compaq COBOL for Tru64 UNIX IVP Successful. IVP, information: Execution successful. IVP, information: Cleaning up. IVP, information: DCABASE280 is properly installed. (continued on next page) A-6 Sample Installation and Verification Sample Installation and Verification A.2 Sample Compaq COBOL Installation Verification Example A-2 (Cont.) Sample Compaq COBOL Installation Verification Compaq COBOL RTL V2.8 for Tru64 UNIX (DCARTL280) DCARTL280: Starting Installation Verification Procedure (IVP). DCARTL280, information: Copyright 2002 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. 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. IVP, information: Checking Shared Run-Time Support Libraries. IVP, information: Compaq COBOL for Tru64 UNIX Shared Run-Time Support Libraries correctly installed. IVP, information: Checking Run-Time Support Object Libraries. IVP, information: Compaq COBOL for Tru64 UNIX Run-Time Object Libraries correctly installed. IVP, information: DCARTL280 is properly installed. Compaq COBOL V2.8 Release Notes (DCADOC280) DCADOC280: Starting Installation Verification Procedure (IVP). DCADOC280, information: Copyright 2002 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. 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. IVP, information: DCADOC280 is properly installed. Compaq COBOL V2.8 Man Pages (DCAMAN280) DCAMAN280: Starting Installation Verification Procedure (IVP). (continued on next page) Sample Installation and Verification A-7 Sample Installation and Verification A.2 Sample Compaq COBOL Installation Verification Example A-2 (Cont.) Sample Compaq COBOL Installation Verification DCAMAN280, information: Copyright 2002 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. 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. IVP, information: DCAMAN280 is properly installed. Compaq Decimal RTL V2.8 for Tru64 UNIX (O2ABASE280) O2ABASE280: Starting Installation Verification Procedure (IVP). O2ABASE280, information: Copyright 2002 Compaq Computer Corporation COMPAQ Registered in U.S. Patent and Trademark Office. 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. IVP, information: Checking shared library. IVP, information: Shared library correctly installed. IVP, information: O2ABASE280 is properly installed. %> A-8 Sample Installation and Verification B ________________________________________________________________ Files Installed on Your System Table B-1 briefly describes the Compaq COBOL files installed on your system. Make sure you are in the root directory (/) by entering the following command: # cd / Table_B-1_Installed_Compaq_COBOL_Files__________________________ Size Directory___________(KBytes)File______Description_______________ usr/bin 1 cobol Symbolic link to the Compaq COBOL Version 2.8 compiler driver usr/lib 1 libcob.a Symbolic link to the Compaq COBOL Version 2.8 RT Support Library libots.a Symbolic link to the Compaq Compiled Code Support Library libots2.a Symbolic link to the Compaq Decimal RT Support Library libisam.a[Symbolic link to ISAM Stub Library libtps_ Symbolic link to tps Stub stub.a Library [1]Installed_only_if_your_system_does_not_have_C-ISAM_installed. (continued on next page) Files Installed on Your System B-1 Files Installed on Your System Table_B-1_(Cont.)_Installed_Compaq_COBOL_Files__________________ Size Directory___________(KBytes)File______Description_______________ usr/lib/cmplrs 1 cobol Symbolic link to the Compaq COBOL Version 2.7 directory cobol_ Compaq COBOL Version 2.8 280 directory cobolrtl Symbolic link to the Compaq COBOL Version 2.8 RT Support Library directory cobolrtl_ Compaq COBOL Version 280 2.8 RT Support Library directory o2abase Symbolic link to the Decimal RT Support Library directory o2abase_ Compaq Decimal RT Support 280 Library directory usr/lib/cmplrs/cobol11000 cobol Compaq COBOL Version 2.8 280 Compiler Driver cobol.1 Compaq COBOL Version 2.8 Reference Page dcobol Compaq COBOL Version 2.8 for Tru64 UNIX Systems filelist List of files contained on Compaq COBOL Version 2.8 kit relnotes Compaq COBOL Version 2.8 Release Notes reformat Compaq COBOL Source Code Formatter usr/lib/cmplrs/cobol1600 cob_ Compaq COBOL Version 2.8 280 msg.cat RT Support message catalog (continued on next page) B-2 Files Installed on Your System Files Installed on Your System Table_B-1_(Cont.)_Installed_Compaq_COBOL_Files__________________ Size Directory___________(KBytes)File______Description_______________ libcob.so Compaq COBOL Version 2.8 Shared RT Support Library libisam_ ISAM Stub Library stub.a[1] libtps_ tps Stub Library stub.a libcob.a Compaq COBOL Version 2.8 RT Support Library usr/shlib 1 libcob.so Symbolic link to Compaq COBOL Version 2.8 Shared RT Support Library libots.so Symbolic link to Compaq Compiled Code Support Library libots2.soSymbolic Link to the Compaq Decimal RT Code Library usr/lib/nls/msg/en_ 1 cob_ Symbolic link to Compaq US.88591 msg.cat COBOL Version 2.8 RT Support Message Catalog usr/lib/cmplrs/o2aba1000 libots2.a Compaq Decimal RT Support 280 Library libots2.soCompaq COBOL Shared Compiled Code Library usr/share/man/man1 1 cobol.1 Symbolic link to the Compaq COBOL Version 2.8 Reference Page [1]Installed_only_if_your_system_does_not_have_C-ISAM_installed. ________________________________________________________________ Files Installed on Your System B-3 C ________________________________________________________________ Recovering from Errors This appendix provides information to help you deal with failures or errors that might occur during product installation or product use. C.1 Failures During Product Installation If errors occur during the installation, the system displays failure messages. For example, if the instal- lation fails due to insufficient disk space, the following message appears: There is not enough space for subset DCABASE280 Compaq COBOL DCABASE280 will not be loaded. Errors can occur during the installation if any of the following conditions exist(s): o The operating system version is incorrect. o The prerequisite software version is incorrect. o There is insufficient disk space. o The system parameter values for successful installation are insufficient. For descriptions of error messages generated by these conditions, see the Tru64 UNIX documentation on system messages, recovery procedures, and software installation. For information on system software requirements, see Section 1.4.3. Recovering from Errors C-1 Recovering from Errors C.2 Failures During Compaq COBOL Use C.2 Failures During Compaq COBOL Use If you encounter a problem while using Compaq COBOL, see the section on Troubleshooting Tips in the Release Notes. If the problem is unresolved, report it to Compaq. If you have a Software Product Services Support Agreement, contact your Compaq Customer Support Center (CSC), either by telephone or using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, please indicate the following: o The name and the version number of the operating system that you are using o The product name (Compaq COBOL) and the version number of Compaq COBOL that you are using o The hardware system that you are using, such as a model number o A very brief description of the problem (one sentence if possible) o How critical the problem is When you submit information electronically or are speaking on the phone to the appropriate Compaq COBOL support specialist, you can provide more detailed information. The information should include the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please attempt to narrow the cause of the problem to a specific module or lines of code. CSC personnel may ask for additional information, such as listings of any command files, INCLUDE files, relevant data files, and so forth. If the program is longer than 50 lines, submit a copy of it electronically or provide machine-readable media (diskette or magnetic tape). C-2 Recovering from Errors