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

- 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

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

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

- An installation of Compaq COBOL using disk media
- 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

    # 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