Compaq COBOL
for Tru64 UNIX Systems
Installation Guide


Previous Contents

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

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 


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

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.

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:


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.


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

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


    # setld -d DCARTL270 O2ABASE270
    


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

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

# 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: 
 
     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. 
 
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 
 
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. 
 
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. 
 
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). 
 
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. 
%> 


Previous Next Contents