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.
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.

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:

• A Compaq COBOL network kit is available for use.
• 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.

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

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 belonging 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/ralc /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/dca270/bin

The installation procedure now displays the names of Compaq COBOL subsets and asks you to specify the subsets that you want to load.

See Section 2.3 to continue the installation.

2.2 Using a 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.

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.7 for Tru64 UNIX 2) Compaq COBOL V2.7 Reference Pages 3) Compaq COBOL V2.7 Release Notes 4) Compaq COBOL V2.7 for Tru64 UNIX 5) Compaq Decimal RTL V2.6 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. The Release Notes will be installed in:

/usr/lib/cmplrs/cobol/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:

You are installing the following optional subsets: Compaq COBOL RTL V2.7 for Tru64 UNIX Compaq COBOL V2.7 Reference Pages Compaq COBOL V2.7 Release Notes Compaq COBOL V2.7 for Tru64 UNIX Compaq Decimal RTL V2.6 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.

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:

• DCABASEnnn compiles, loads, and runs a Compaq 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 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.

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.6, enter:

   # setld -d DCARTL260 O2ABASE260

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:

• An installation of Compaq COBOL using disk media
• An Installation Verification Procedure (IVP)

Example A-1 is a log file of a sample installation of Compaq COBOL Version V2.7.

Example A-1 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 DFARTL369 installed Digital Fortran RTL #369 for Digital UNIX Alpha DFARTL384 installed DIGITAL Fortran RTL #384 for DIGITAL UNIX Alpha ... O2ABASE270 installed Compaq Decimal RTL V2.6 for Tru64 UNIX OSFBASE440 installed Base System (- Required -) OSFCMPLRS440 installed Compiler Back End (Software Development) OSFLIBA440 installed Static Libraries (Software Development) OSFOBSOLETE440 installed Obsolete Commands and Utilities (System Administration) OSFPGMR440 installed Standard Programmer Commands (Software Development) SORLIB300 installed Sort Runtime Library %> /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 DCARTL270, 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). O2ABASE270, 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: 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.7 for Tru64 UNIX 2) Compaq COBOL V2.7 Man Pages 3) Compaq COBOL V2.7 Release Notes 4) Compaq COBOL V2.7 for Tru64 UNIX 5) Compaq Decimal RTL V2.6 for Tru64 UNIX --- MORE TO FOLLOW --- Enter your choices or press RETURN to display the next screen. 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 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.7 for Tru64 UNIX Compaq COBOL V2.7 Man Pages Compaq COBOL V2.7 Release Notes Compaq COBOL V2.7 for Tru64 UNIX Compaq Decimal RTL V2.6 for Tru64 UNIX Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. 5 subset(s) will be installed. Loading 1 of 5 subset(s).... Compaq Decimal RTL V2.6 for Tru64 UNIX Copying from . (disk) Verifying Loading 2 of 5 subset(s).... Copyright 2000 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. DCABASE270: 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.7 for Tru64 UNIX Copying from . (disk) Verifying Loading 3 of 5 subset(s).... Compaq COBOL V2.7 Release Notes Copying from . (disk) Verifying Loading 4 of 5 subset(s).... Compaq COBOL V2.7 Man Pages Copying from . (disk) Verifying Loading 5 of 5 subset(s).... Copyright 2000 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 1 minute. Compaq COBOL RTL V2.7 for Tru64 UNIX Copying from . (disk) Verifying 5 of 5 subset(s) installed successfully. Configuring "Compaq Decimal RTL V2.6 for Tru64 UNIX" (O2ABASE270) O2ABASE270, information: Shared library correctly installed. DCABASE270, information: You can run the Installation Verification Procedure using the following command from root: setld -v DCABASE270 Configuring "Compaq COBOL V2.7 for Tru64 UNIX" (DCABASE270) DCADOC270, information: The release notes are in /usr/lib/cmplrs/cobol/relnotes Configuring "Compaq COBOL V2.7 Release Notes" (DCADOC270) Configuring "Compaq COBOL V2.7 Man Pages" (DCAMAN270) Configuring "Compaq COBOL RTL V2.7 for Tru64 UNIX" (DCARTL270) DCARTL270, information: Compaq COBOL RTL Shared libraries installed.

A.2 Sample Compaq COBOL Installation Verification

Example A-2 shows a sample installation verification of Compaq COBOL Version V2.7.

Example A-2 Sample Compaq COBOL Installation Verification

%> /usr/sbin/setld -v DCABASE270 DCARTL270 DCADOC270 DCAMAN270 O2ABASE270 Compaq COBOL V2.7 for Tru64 UNIX (DCABASE270) DCABASE270, information: Copyright 2000 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. DCABASE270: Starting Installation Verification Procedure (IVP). If this fails, please include the following when submitting a report: 1) This subset name, which is DCABASE270 2) Output from: ls -l /tmp/DCABASE270.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: DCABASE270 is properly installed. Compaq COBOL RTL V2.7 for Tru64 UNIX (DCARTL270) DCARTL270: Starting Installation Verification Procedure (IVP). DCARTL270, information: Copyright 2000 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: DCARTL270 is properly installed. Compaq COBOL V2.7 Release Notes (DCADOC270) DCADOC270: Starting Installation Verification Procedure (IVP). DCADOC270, information: Copyright 2000 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: DCADOC270 is properly installed. Compaq COBOL V2.7 Man Pages (DCAMAN270) DCAMAN270: Starting Installation Verification Procedure (IVP). DCAMAN270, information: Copyright 2000 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: DCAMAN270 is properly installed. Compaq Decimal RTL V2.6 for Tru64 UNIX (O2ABASE270) O2ABASE270: Starting Installation Verification Procedure (IVP). O2ABASE270, information: Copyright 2000 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: O2ABASE270 is properly installed. %>