DEC_COBOL___________________________________________ Installation Guide for Digital UNIX Systems Order Number: AA-Q2G2E-TE October 1996 This guide describes how to install DEC COBOL on an Alpha system running the Digital UNIX operating system. This guide applies to DEC COBOL Version 2.4 and any maintenance updates for this version. Revision/Update Information: This manual supersedes the Version 2.3 DEC COBOL Installation Guide for Digital UNIX Systems. Operating System & Version: Digital UNIX Version 3.0 or higher. Software Version: DEC COBOL Version 2.4 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ October 1996 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1996. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: ACMS, ACMSxp, Bookreader, CMS, DEC COBOL, DECdocument, DEC Fortran, DEC FUSE, DECladebug, DECnet, DEC OSF/1, DEC PASCAL, DECset, DECTPU, Digital, OpenVMS, PDP, Professional, VAX, VAX ADA, VAX BASIC, VAX C, VAX CDD, VAXcluster, VAX COBOL, VAX COBOL GENERATOR, VAX DOCUMENT, VAX MACRO, VAX RMS, VAX SCAN, VMS, VT, VT100, VT220, VT300, VT320, VT420, and the DIGITAL logo. The following are third-party trademarks: Display POSTSCRIPT and POSTSCRIPT are registered trademarks of Adobe Systems Incorporated. Micro Focus is a registered trademark of Micro Focus Limited. DBAPack, Hot Standby, Oracle CDD/Administrator, Oracle CDD/Repository, Oracle CODASYL DBMS, Oracle DBA Workcenter, Oracle Enterprise Manager, Oracle Expert, Oracle Graphical Schema Editor, Oracle InstantSQL, Oracle Rally, Oracle Rdb, Oracle RMU, Oracle RMUwin, Oracle SQL/Services, Oracle Trace, Oracle Trace Collector, and Rdb7 are trademarks of Oracle Corporation. OSF/1 and Motif are registered trademarks of the Open Software Foundation, Inc. Transarc and Encina are registered trademarks of Transarc Corporation. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited. X/Open is a trademark of X/Open Company Limited. All other trademarks and registered trademarks are the property of their respective holders. ZK6295 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Preparing for DEC 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-3 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-4 1.4.5 Determining Disk Space Requirements....... 1-5 1.4.5.1 Checking Current Disk Space............. 1-6 1.4.5.2 Increasing Disk Space by Using Alternative Disks ...................... 1-7 1.5 Installing from Media or Using RIS............ 1-8 1.6 Backing Up Your System Disk................... 1-8 1.7 Stopping the Installation..................... 1-9 2 Installing DEC COBOL 2.1 Using CD-ROM Consolidated Distribution Media......................................... 2-1 2.2 Using a 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 DEC COBOL from Your System........................................ 3-1 A Sample Installation and Verification A.1 Sample DEC COBOL Installation................. A-1 A.2 Sample DEC COBOL Installation Verification.... A-3 B Files Installed on Your System C Recovering from Errors C.1 Failures During Product Installation ......... C-1 C.2 Failures During DEC COBOL Use................. C-2 Examples A-1 Sample DEC COBOL Installation............. A-1 A-2 Sample DEC COBOL Installation Verification.............................. A-3 Tables 1 Conventions Used in This Guide ........... vi 1-1 DEC COBOL Directory Sizes (Kilobytes Required)................................. 1-5 B-1 Installed DEC COBOL Files................. B-1 iv _________________________________________________________________ Preface This installation procedure creates DEC COBOL file systems subordinate to the /usr/lib, /usr/bin, and /usr/man directories. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall DEC COBOL for any other reason. Intended Audience This guide is intended for system managers who install DEC COBOL. Associated Documentation In addition to this guide, the DEC COBOL documentation set includes the following: o DEC COBOL Reference Manual o DEC COBOL User Manual o DEC COBOL Release Notes (see Section 1.1) o cobol(1) reference page o Read Before Installing or Using DEC COBOL Version 2.4 for Digital UNIX Systems cover letter Additional Documentation 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 Digital UNIX 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, this 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 interactive examples and other screen displays. UPPERCASE The Digital UNIX operating system lowercase differentiates 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._____________________________________ References In this manual, every use of OpenVMS Alpha means the OpenVMS Alpha operating system and every use of Digital UNIX means the Digital UNIX operating system. Digital UNIX was formerly called DEC OSF/1. vii Reader's Comments Digital 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: o Electronic Internet mail: cobol_docs@casdoc.enet.dec.com o Fax: 603-881-0120 Attn: Languages Documentation, ZKO2-3/K35 o A letter sent to the following address: Digital Equipment Corporation Languages Documentation, ZKO2-3/K35 110 Spit Brook Road Nashua, NH 03062-2698 USA viii 1 _________________________________________________________________ Preparing for DEC COBOL Installation Your distribution kit includes a letter titled Read Before Installing or Using DEC COBOL Version 2.4 for Digital UNIX Systems. The letter discusses important information that might not be included in this guide. You should read this letter now. 1.1 Reading the Online Release Notes DEC COBOL provides online release notes. Digital strongly recommends that you read the release notes before installing the product. The release notes may contain information about changes to the application. The release notes for DEC COBOL are in the following file: /usr/lib/cmplrs/cobol/relnotes For information about installing these release notes before installing DEC COBOL, see Section 2.3.1. You can use the following command to read the release notes after DEC COBOL is installed: # more /usr/lib/cmplrs/cobol/relnotes 1.2 Registering Your Software License DEC 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 DEC 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. Preparing for DEC COBOL Installation 1-1 If you are installing DEC 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 DEC COBOL, review the PAK status and install the PAKs for any prerequisite or optional software before you install DEC COBOL. To register a license on the Digital 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 DEC 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 incomplete, contact your Digital representative. 1-2 Preparing for DEC COBOL Installation 1.4 Checking Installation Procedure Requirements This section discusses various requirements for installing DEC COBOL. Installing DEC 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 DEC COBOL software and to register the license PAK. 1.4.2 Checking Hardware Requirements To install DEC 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 DEC COBOL Software Product Description (SPD) for additional hardware requirements. 1.4.3 Checking Software Requirements DEC COBOL Version 2.4 requires the operating system Digital UNIX Version 3.0 or higher. (Future DEC 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 Digital UNIX installed on your system, enter the following command: # uname -r The system will respond with the version number of the installed operating system. Preparing for DEC COBOL Installation 1-3 DEC COBOL also requires that the following Digital UNIX software subsets be loaded on the system where you install DEC COBOL: o OSFBASE-the Base System subset o OSFCMPLRS-Compiler Back End o OSFPGMR-Software Development Environment o DFARTL-DEC Fortran Run-Time Libraries o SORLIB[1]-SORT Run-Time Library To check whether these subsets are loaded, follow these steps: 1. Log in to the system where you will install DEC COBOL. 2. Enter the following command: # setld -i | egrep 'OSFBASE|OSFCMPLRS|OSFPGMR|DFARTL|SORLIB' 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 Digital UNIX software before installing DEC COBOL. (For information on how to load the operating system software, see the Digital UNIX Installation Guide.) 1.4.4 Determining Which Subsets to Load You must choose the DEC COBOL subsets you want to load. The DEC COBOL subsets have the following titles: o DCABASE240 DEC COBOL Version 2.4 for Digital UNIX Systems o DCADOC240 ____________________ [1] See the Digital UNIX Installation Guide Appendix C, Additional Subsets for more information. 1-4 Preparing for DEC COBOL Installation DEC COBOL Version 2.4 Release Notes o DCAMAN240 DEC COBOL Version 2.4 Reference Page o DCARTL240 DEC COBOL Run-Time Support Library o O2ABASE240 DEC COBOL Decimal Run-Time Support 1.4.5 Determining Disk Space Requirements Table 1-1 lists the disk space requirements for loading DEC COBOL software. These requirements apply to the disks where you load the DEC 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_DEC_COBOL_Directory_Sizes_(Kilobytes_Required)_________ Subset_Name______Directory_____________Size_(Kbytes)_____________ DCARTL240 /usr 1 /usr/lib/cmplrs 1 /usr/lib/cmplrs 2065 /cobolrtl_240 /usr/lib/nls 1 /usr/lib/nls/msg 1 /usr/lib/nls/msg 1 /en_US.88591 /usr/shlib 1 Total 2070K O2ABASE240 /usr 1 /usr/lib/cmplrs 1 /usr/lib/cmplrs 1464 /o2abase_240 (continued on next page) Preparing for DEC COBOL Installation 1-5 Table_1-1_(Cont.)_DEC_COBOL_Directory_Sizes_(Kilobytes_Required)_ Subset_Name______Directory_____________Size_(Kbytes)_____________ Total 1465K DCABASE240 /usr 1 contains DCADOC240 and DCAMAN240 /usr/lib/cmplrs 1 /usr/lib/cmplrs 5769 /cobol_240 /usr/share 1 /usr/share/man 1 /usr/share/man/man1 1 Total 5763K GRAND_TOTAL____________________________9308K_____________________ 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 you will load in each directory. Compare the suggested space required for subsets with the free space currently on the disks where DEC 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 DEC 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: 1-6 Preparing for DEC COBOL Installation The display indicates that /usr (mounted to /dev/rd0g) is the only mount point that affects where DEC 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 DEC 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. This free space must accommodate the subset requirements listed in Table 1-1. On systems where /usr/lib and /usr/man are mounted to different devices from /usr, enter the following command: # df /usr/lib /usr/man In this case, you compare space required for DEC COBOL files in /usr/lib to the free space displayed in the first line of the df output list and compare the space required for DEC COBOL files in /usr/man to the free space displayed in the second line of that list. 1.4.5.2 Increasing Disk Space by Using Alternative Disks The DEC 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 DEC 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 DEC COBOL: Preparing for DEC COBOL Installation 1-7 1. Log in as superuser. 2. Create the directory /usr/lib/cmplrs, /usr/lib/cmplrs /cobol_nnn, or both (in this guide nnn is the DEC 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 that the new mount points take effect. 1.5 Installing from Media or Using RIS Someone from your site must perform at least one DEC COBOL installation from the distribution medium. Your site system manager can then decide whether or not to make a DEC COBOL distribution kit available on line so that subsequent installations of DEC COBOL can use the Remote Installation Service (RIS). For information on extracting DEC COBOL subsets to a RIS distribution area, see the Guide to Sharing Software on a Local Area Network. If you expect to use DEC 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 DEC COBOL network kit is available for use o Your system is registered as a RIS client If DEC COBOL subsets are available to you on a RIS server system, you must know the name of that system. For more information on installing DEC COBOL from a RIS distribution area, see Section 2.2. 1.6 Backing Up Your System Disk Digital recommends that you back up your system disk before installing any software. For information about backing up your system disk, see the Digital UNIX system documentation. 1-8 Preparing for DEC COBOL 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 DEC COBOL installation are listed in the following file: /usr/lib/cmplrs/cobol/filelist Preparing for DEC COBOL Installation 1-9 2 _________________________________________________________________ Installing DEC COBOL Before you start the installation, read Chapter 1. You can install DEC 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 DEC COBOL files on to a disk belonging to the system where you perform the installation. When DEC COBOL is run, its executable images are mapped into memory on your system. Follow these steps to install DEC 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 DEC 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/ralc /cdrom 5. Enter a setld command that requests the load function (-l) and identifies the directory in the mounted file system where DEC COBOL subsets are located: # setld -l /cdrom/AXP/DCA240/bin The installation procedure now displays the names of DEC COBOL subsets and asks you to specify the subsets that you want to load. See Section 2.3 to continue the installation. Installing DEC COBOL 2-1 2.2 Using a RIS Distribution Area If you are installing DEC 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 DEC 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 DEC COBOL subsets are located. For example, if you are loading DEC 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 DEC 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 DEC COBOL The following example shows a display where all DEC 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) DEC COBOL Run Time Support Libraries for Digital UNIX Systems 2) DEC COBOL V2.4 Reference Pages 3) DEC COBOL V2.4 Release Notes 4) DEC COBOL V2.4 for Digital UNIX Systems 5) DEC Decimal Run Time Support Library 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 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: You are installing the following optional subsets: DEC COBOL Run Time Support Libraries for Digital UNIX Systems DEC COBOL V2.4 Reference Pages DEC COBOL V2.4 Release Notes DEC COBOL V2.4 for Digital UNIX Systems DEC Decimal Run Time Support Library 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. Installing DEC COBOL 2-3 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 DEC COBOL subsets. 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 DEC COBOL 3 _________________________________________________________________ After Installation This chapter explains what you need to do after the installation to make DEC COBOL ready for use and how to delete old DEC COBOL subsets. 3.1 Running the Installation Verification Procedure After you install DEC 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 DEC COBOL. The DEC 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: DCABASEnnn compiles, loads, and runs a DEC COBOL program 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 DEC COBOL subset. For a sample DEC 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. 3.2 Deleting a Version of DEC COBOL from Your System If you must remove a version of DEC COBOL from your system, delete each subset that you previously installed. After Installation 3-1 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 | grep "DEC COBOL" 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 DEC COBOL Version 2.3, enter: # setld -d DCARTL230 O2ABASE230 3-2 After Installation A _________________________________________________________________ Sample Installation and Verification The following sections show the result of a sample installation of DEC 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 DEC COBOL using disk media o An Installation Verification Procedure (IVP) A.1 Sample DEC COBOL Installation Example A-1 shows a sample installation of DEC COBOL Version 2.4. Example A-1 Sample DEC COBOL Installation # setld -l . 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) DEC COBOL RTL V2.4 for Digital UNIX Systems 2) DEC COBOL V2.4 Digital UNIX Systems 3) DEC COBOL V2.4 Man Pages 4) DEC COBOL V2.4 Release Notes 5) DEC Decimal RTL V2.4 for Digital UNIX Systems Or you may choose one of the following options: (continued on next page) Sample Installation and Verification A-1 Example A-1 (Cont.) Sample DEC COBOL Installation 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 You are installing the following optional subsets: DEC COBOL RTL V2.4 for Digital UNIX Systems DEC COBOL V2.4 Digital UNIX Systems DEC COBOL V2.4 Man Pages DEC COBOL V2.4 Release Notes DEC Decimal RTL V2.4 for Digital UNIX Systems Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. DEC Decimal RTL V2.4 for Digital UNIX Systems Copying from . (disk) Verifying DCABASE240: warning: Be *sure* to install the DEC COBOL RTL for Digital UNIX Systems (DCARTL) before running the IVP (setld -v) and trying to use DEC COBOL (DCABASE). DEC COBOL V2.4 Digital UNIX Systems Copying from . (disk) Verifying DEC COBOL V2.4 Release Notes Copying from . (disk) Verifying DEC COBOL V2.4 Man Pages Copying from . (disk) Verifying DEC COBOL RTL V2.4 for Digital UNIX Systems Copying from . (disk) (continued on next page) A-2 Sample Installation and Verification Example A-1 (Cont.) Sample DEC COBOL Installation Configuring "DEC Decimal RTL V2.4 for Digital UNIX Systems" (O2ABASE240) O2ABASE240, information: Shared library correctly installed. DCABASE240, information: You can run the Installation Verification Procedure using the following command from root: setld -v DCABASE240 Configuring "DEC COBOL V2.4 Digital UNIX Systems" (DCABASE240) DCADOC240, information: The release notes are in /usr/lib/cmplrs/cobol/relnotes Configuring "DEC COBOL V2.4 Release Notes" (DCADOC240) Configuring "DEC COBOL V2.4 Man Pages" (DCAMAN240) Configuring "DEC COBOL RTL V2.4 for Digital UNIX Systems" (DCARTL240) DCARTL240, information: Shared libraries installed. # A.2 Sample DEC COBOL Installation Verification Example A-2 shows a sample installation verification of DEC COBOL Version 2.4. Example A-2 Sample DEC COBOL Installation Verification # setld -v DCABASE240 DCARTL240 DCADOC240 DCAMAN240 O2ABASE240 DEC COBOL V2.4 Digital UNIX Systems (DCABASE240) DCABASE240, information: Copyright (c) Digital Equipment Corporation 1994, 1996. All rights reserved. Government notice: Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. (continued on next page) Sample Installation and Verification A-3 Example A-2 (Cont.) Sample DEC COBOL Installation Verification Licensing notice: This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. DCABASE240: Starting Installation Verification Procedure (IVP). If this fails, please include the following when submitting a report: 1) This subset name, which is DCABASE240 2) Output from: ls -l /tmp/DCABASE240.ivptmp 3) This setld session IVP, information: Created scratch directory. IVP, information: Compiling and linking. IVP, information: Running. IVP, Info: DEC COBOL for Digital UNIX Systems IVP Successful. IVP, information: Execution successful. IVP, information: Cleaning up. IVP, information: DCABASE240 is properly installed. DEC COBOL RTL V2.4 for Digital UNIX Systems (DCARTL240) DCARTL240: Starting Installation Verification Procedure (IVP). DCARTL240, information: Copyright (c) Digital Equipment Corporation 1994, 1996. All rights reserved. Government notice: Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Licensing notice: This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. (continued on next page) A-4 Sample Installation and Verification Example A-2 (Cont.) Sample DEC COBOL Installation Verification IVP, information: Checking Shared Run-Time Support Libraries. IVP, information: Shared Run-Time Support Libraries correctly installed. IVP, information: Checking Run-Time Support Object Libraries. IVP, information: Run-Time Support Object Libraries correctly installed. IVP, information: DCARTL240 is properly installed. DEC COBOL V2.4 Release Notes (DCADOC240) DCADOC240: Starting Installation Verification Procedure (IVP). DCADOC240, information: Copyright (c) Digital Equipment Corporation 1994, 1996. All rights reserved. Government notice: Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Licensing notice: This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. IVP, information: DCADOC240 is properly installed. DEC COBOL V2.4 Man Pages (DCAMAN240) DCAMAN240: Starting Installation Verification Procedure (IVP). DCAMAN240, information: Copyright (c) Digital Equipment Corporation 1994, 1996. All rights reserved. Government notice: Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Licensing notice: (continued on next page) Sample Installation and Verification A-5 Example A-2 (Cont.) Sample DEC COBOL Installation Verification This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. IVP, information: DCAMAN240 is properly installed. DEC Decimal RTL V2.4 for Digital UNIX Systems (O2ABASE240) O2ABASE240: Starting Installation Verification Procedure (IVP). O2ABASE240, information: Copyright (c) Digital Equipment Corporation 1994, 1996. All rights reserved. Government notice: Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Licensing notice: This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. IVP, information: Checking shared library. IVP, information: Shared library correctly installed. IVP, information: O2ABASE240 is properly installed. # A-6 Sample Installation and Verification B _________________________________________________________________ Files Installed on Your System Table B-1 briefly describes the DEC COBOL files installed on your system. Table_B-1_Installed_DEC_COBOL_Files______________________________ Size Directory___________(KBytes)File______Description________________ usr/bin: 1 cobol Symbolic link to the DEC COBOL Version 2.4 compiler driver usr/lib: 1 libcob.a Symbolic link to the DEC COBOL Version 2.4 RT Support Library libots.a Symbolic link to the DEC Compiled Code Support Library libots2.a Symbolic link to the DEC Decimal RT Support Library libisam.a[Symbolic link to ISAM Stub Library libtps_ Symbolic link to Libtps stub.a Stub Library usr/lib/cmplrs: 1 cobol Symbolic link to the DEC COBOL Version 2.4 directory cobol_ DEC COBOL Version 2.4 240 directory [1]Installed_only_if_your_system_does_not_have_C-ISAM_installed__ (continued on next page) Files Installed on Your System B-1 Table_B-1_(Cont.)_Installed_DEC_COBOL_Files______________________ Size Directory___________(KBytes)File______Description________________ cobolrtl Symbolic link to the DEC COBOL Version 2.4 RT Support Library directory cobolrtl_ DEC COBOL Version 2.4 RT 240 Support Library directory o2abase Symbolic link to the Decimal RT Support Library directory o2abase_ DEC Decimal RT Support 240 Library directory usr/lib/cmplrs 5800 cobol DEC COBOL Version 2.4 /cobol_240: Compiler Driver cobol.1 DEC COBOL Version 2.4 Reference Page dcobol DEC COBOL Version 2.4 for Digital UNIX Systems filelist List of files contained on DEC COBOL Version 2.4 kit relnotes DEC COBOL Version 2.4 Release Notes reformat DEC COBOL Source Code Formatter usr/lib/cmplrs 2400 cob_ DEC COBOL Version 2.4 RT /cobolrtl_240: msg.cat Support message catalog libcob.so DEC COBOL Version 2.4 Shared RT Support Library libisam_ DEC ISAM Stub Library stub.a[1] libtps_ tps Stub Library stub.a [1]Installed_only_if_your_system_does_not_have_C-ISAM_installed__ (continued on next page) B-2 Files Installed on Your System Table_B-1_(Cont.)_Installed_DEC_COBOL_Files______________________ Size Directory___________(KBytes)File______Description________________ libcob.a DEC COBOL Version 2.4 RT Support Library usr/shlib: libcob.so Symbolic link to DEC COBOL Version 2.4 Shared RT Support Library libots.so Symbolic link to DEC Compiled Code Support Library libots2.soSymbolic Link to the DEC COBOL Compiled Code Library usr/lib/nls/msg 1 cob_ Symbolic link to DEC COBOL /en_US.88591: msg.cat Version 2.4 RT Support Message Catalog usr/lib/cmplrs 1500 libots2.a DEC Decimal RT Support /o2abase_240: Library libots2.soDEC COBOL Shared Compiled Code Library usr/share/man 1 cobol.1 Symbolic link to the DEC /man1: COBOL Version 2.4 Reference ______________________________________Page_______________________ 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 installation fails due to insufficient disk space, the following message appears: There is not enough space for subset DCABASE240 DEC COBOL DCABASE240 will not be loaded. Errors can occur during the installation if any of the following conditions exist: 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 Digital 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 C.2 Failures During DEC COBOL Use If you encounter a problem while using DEC COBOL, please see the section on Troubleshooting Tips in the release notes. If the problem is unresolved, report it to Digital. Depending on the type of support you have and the nature of the problem, take one of the following actions: o If you have a Software Product Services Support Agreement, contact your Digital 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: - The name ( Digital UNIX) and the version number of the operating system you are using - The product name (DEC COBOL) and the version number of DEC COBOL you are using - The hardware system you are using, such as a model number - A very brief description of the problem (one sentence if possible) - How critical the problem is When you submit information electronically or are speaking on the phone to the appropriate DEC 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 (floppy diskette or magnetic tape). C-2 Recovering from Errors o If you should find errors in this manual or if you should wish to comment on the documentation, please send the manual title, order number, and your comments by one of the following methods: - Electronic Internet mail: cobol_docs@casdoc.enet.dec.com - Fax: 603-881-0120 Attn: Languages Documentation, ZKO2-3 /K35 - A letter sent to the following address: Digital Equipment Corporation Languages Documentation, ZKO2-3/K35 110 Spit Brook Road Nashua, NH 03062-2698 USA Recovering from Errors C-3