 





















                  Micro_Focus_COBOL______________________________
                  Installation Guide for
                  DIGITAL UNIX Systems

                  Order Number: AA-Q42CF-TE


                  April 1997

                  This guide describes how to install the DIGITAL
                  distributed version of the Micro Focus COBOL Software
                  Developer Suite and the Micro Focus COBOL Application
                  Server on a DIGITAL UNIX system.







                  Revision/Update Information:  This manual supersedes
                                                AA-Q42CE-TE, Micro Focus
                                                COBOL Installation Guide
                                                for Digital UNIX.

                  Operating System & Version:   DIGITAL UNIX Version 3.2.
                                                Future maintenance releases
                                                may
                                                require higher versions.

                  Software Version:             Micro Focus COBOL V4.0A
                                                Software   Developer Suite
                                                Micro Focus COBOL V4.0A
                                                Application   Server









                  Digital Equipment Corporation
                  Maynard, Massachusetts

 






            ________________________________________________________________
            April 1997

            The information in this document is subject to change
            without notice and should not be construed as a commitment
            by Digital Equipment Corporation. Digital Equipment
            Corporation assumes no responsibility for any errors that
            may appear in this document.

            The software described in this document is furnished under
            a license and may be used or copied only in accordance with
            the terms of such license.

            No responsibility is assumed for the use or reliability
            of software on equipment that is not supplied by Digital
            Equipment Corporation or its affiliated companies.

            Restricted Rights: Use, duplication, or disclosure by the
            U.S. Government is subject to restrictions as set forth in
            subparagraph (c)(1)(ii) of the Rights in Technical Data
            and Computer Software clause at DFARS 252.227-7013.

             Digital Equipment Corporation 1997.

            All Rights Reserved.

            The following are trademarks of Digital Equipment
            Corporation: Bookreader, DEC, DECwindows, DIGITAL, VAX
            DOCUMENT, and the DIGITAL logo.

            The following are third-party trademarks:

            Micro Focus is a registered trademark of Micro Focus
            Limited. Micro Focus COBOL, Toolbox, Micro Focus Dialog
            System, and Operating System Extensions are trademarks of
            Micro Focus Limited.

            OSF and OSF/1 are registered trademarks of the Open
            Software Foundation, Inc.

            POSTSCRIPT is a registered trademark of Adobe Systems
            Incorporated.

            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.

            This document is available on CD-ROM.

            This document was prepared using VAX DOCUMENT, Version 2.1.

 














  _________________________________________________________________

                                                           Contents



  Preface...................................................      v

  1  Preparing for Micro Focus COBOL Installation

     1.1  Reading the Online Release Notes.................     1-1
     1.2  Registering Your Software License................     1-1
     1.3  Special Checks and Requirements for Installing
          Micro Focus COBOL................................     1-2
     1.4  Checking Installation Procedure Requirements.....     1-2
     1.4.1   Checking Login Privileges .....................    1-2
     1.4.2   Checking Hardware Requirements ................    1-2
     1.4.3   Checking Software Requirements ................    1-3
     1.4.4   Determining Which Subsets to Load .............    1-3
     1.4.5   Determining Disk Space Requirements ...........    1-4
     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-7
     1.6  Backing Up Your System Disk......................     1-8
     1.7  Stopping the Installation........................     1-8

  2  Installing Micro Focus COBOL

     2.1  Using CD-ROM Distribution Media..................     2-1
     2.2  Using a RIS Distribution Area  ...................    2-1
     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-2

  3  After Installation

     3.1  Running the Installation Verification Procedure
          .................................................     3-1
     3.2  Deleting Micro Focus COBOL from Your System......     3-1

  A  Sample Listings

     A.1  Sample Micro Focus COBOL Installation  ...........    A-1
     A.1.1   Installation of Micro Focus COBOL  ............    A-1
     A.1.2   Installation of Micro Focus Operating System
             Extensions ....................................    A-3
     A.2  Sample Installation Verification Procedure  ......    A-5
     A.2.1   Installation Verification Procedure for Micro
             Focus COBOL ...................................    A-5
     A.2.2   Installation Verification Procedure for Micro
             Focus OSX......................................    A-5


                                                                iii

 







   B  Recovering from Errors

       B.1  Failures During Product Installation ............     B-1
       B.2  Failures During Product Use......................     B-1

   Tables

       1       Conventions Used in This Guide ...............      vi

       1-1     Micro Focus COBOL Subset Sizes (Kilobytes
               Required)......................................    1-4

















































   iv

 












      _________________________________________________________________

                                                                Preface



            This installation procedure creates Micro Focus 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 Micro
            Focus COBOL for any other reason.

      Intended Audience

            This guide is intended for system managers who install the
            DIGITAL distributed version of Micro Focus COBOL products.

      Associated Documentation

            The Micro Focus product documentation can be ordered in the
            following set. Also included with the documentation order
            is this installation guide and Read Before Installing or
            Using Micro Focus COBOL V4.0A for DIGITAL UNIX Systems,
            which provide specific information to the product
            installation on DIGITAL UNIX.

             The Micro Focus COBOL Developer Suite for UNIX set
            includes:

            Micro Focus COBOL V4.0 for UNIX, Getting Started
            Micro Focus COBOL V4.0 for UNIX, Master Index and Glossary
            Micro Focus COBOL V4.0 for UNIX, Pocket Guide
            Micro Focus COBOL V4.0 for UNIX, COBOL User Guide
            Micro Focus COBOL V4.0 for UNIX, COBOL System Reference
            Volume 1
            Micro Focus COBOL V4.0 for UNIX, COBOL System Reference
            Volume 2
            Micro Focus Object COBOL V4.0 and COBOL V4.0, Error
            Messages
            Micro Focus Object COBOL V4.0 and COBOL V4.0, Language
            Reference
            Micro Focus Object COBOL V4.0 and COBOL V4.0, Compatibility
            Guide
            Micro Focus
            Object COBOL V4.0 and COBOL V4.0, Language Reference -
                 Additional Topics
            Micro
            Focus COBOL Toolbox V4.0 for UNIX, Toolbox Operating Guide
                 Volume 1
            Micro
            Focus COBOL Toolbox V4.0 for UNIX, Toolbox Operating Guide
                 Volume 2
            Micro Focus Dialog System V2.5, Character Mode User Guide

                                                                      v

 







      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.

            <Return>       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 bolded
                           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 uppercase and
                           lowercase characters. Examples, syntax
                           descriptions, function definitions, and
                           literal strings that appear in text must be
                           typed exactly as shown.

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











      vi

 










                                                                      1
      _________________________________________________________________

                           Preparing for Micro Focus COBOL Installation


            Your distribution kit includes a letter titled Read Before
            Installing or Using Micro Focus COBOL V4.0A for DIGITAL
            UNIX Systems. This 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

            Micro Focus COBOL provides online release notes. DIGITAL
            strongly recommends that you read the release notes before
            using the product. The release notes contain information
            specific to release of the product on DIGITAL UNIX and
            about changes to the application.

            The release notes for Micro Focus COBOL are in the
            following file:

            usr/lib/cmplrs/cob/relnotes

            For information about installing these release notes before
            installing Micro Focus COBOL, see Section 2.3.1.

            You can use the following command to read the release notes
            after Micro Focus COBOL is installed:

            # more /usr/lib/cmplrs/cob/relnotes

            A POSTSCRIPT version of the release notes is also available
            in the file:

            usr/lib/cmplrs/cob/relnotes.ps

            An additional source of information and release notes
            pertaining to product updates can be found in the installed
            product directory under the docs subdirectory: usr/lib
            /cmplrs/cob/docs.

      1.2 Registering Your Software License

            Micro Focus 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 Micro Focus COBOL on a newly licensed
            node. The License PAK may be shipped along with the kit if
            you ordered the license and media together; otherwise, it
            is shipped separately to a location based on your license
            order.

            If you are installing Micro Focus COBOL as an update on a
            node already licensed for this software, you have already
            completed the License PAK registration requirements.

                                                                    1-1

 



      Preparing for Micro Focus COBOL Installation
      1.2 Registering Your Software License


            If you are installing prerequisite or optional software
            along with Micro Focus COBOL, review the PAK status and
            install the PAKs for any prerequisite or optional software
            before you install Micro Focus COBOL.

            To register a license under 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 Special Checks and Requirements for Installing Micro Focus
          COBOL

            This installation covers the installation of two Micro
            Focus COBOL components. These instructions cover the
            installation of Micro Focus COBOL Software Developer Suite
            and Micro Focus COBOL Application Server. Only one of these
            two products will be installed on your system.

            Micro Focus COBOL Application Server for DIGITAL UNIX, also
            known as Micro Focus Operating System Extensions (OSX), is
            used for the deployment of COBOL applications and will be
            installed on systems that have not installed Micro Focus
            COBOL Software Developer Suite.

      1.4 Checking Installation Procedure Requirements

            This section discusses various requirements for installing
            Micro Focus COBOL.

            Installing Micro Focus 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 Micro
            Focus COBOL software and to register the license PAK.

      1.4.2 Checking Hardware Requirements

            To install Micro Focus COBOL, you need the following
            hardware:

            o  Software distribution device (if installing from 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.

      1-2

 



                           Preparing for Micro Focus COBOL Installation
                       1.4 Checking Installation Procedure Requirements


            See the Micro Focus COBOL Software Product Description
            (SPD) for additional hardware requirements.

      1.4.3 Checking Software Requirements

            Micro Focus COBOL V4.0A requires DIGITAL UNIX Version 3.2.
            Micro Focus COBOL V4.0A has also been tested with DIGITAL
            UNIX Version 4.0.

            To gain the full features of the Micro Focus COBOL product,
            the following DIGITAL UNIX software subsets should be
            loaded on the system where you install Micro Focus COBOL:

            o  OSFBASE-the "Base System" subset

            o  OSFPGMR-Software Development Environment

            If the software development tools in the OSFPGMR subset
            (that is, the loader, linker (ld) and assembler (as)) are
            not installed, this restricts the creation of executables
            with Micro Focus COBOL and restricts the use of a COBOL
            object into an executable.

            To check whether this subset is loaded, follow these steps:

            1. Log in to the system where you will install Micro Focus
               COBOL.

            2. Enter the following command:

               # setld -i | egrep 'OSFBASE|OSFPGMR'

            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|OSFPGMR'

            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
            system software before installing Micro Focus 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 Micro Focus COBOL subsets you want to
            load.

            The Micro Focus COBOL Software Developer Suite for DIGITAL
            UNIX subsets have the following titles:

            o  MFCBASE401

               Micro Focus COBOL V4.0u1 for Digital UNIX

            o  MFCDOC401

               Micro Focus Product Release Notes and Online Information

            o  MFCMAN401

               Micro Focus COBOL V4.0u1 Reference Pages

            The Micro Focus COBOL Application Server for Digital UNIX
            subsets have the following titles:

            o  MFOBASE401

                                                                    1-3

 



      Preparing for Micro Focus COBOL Installation
      1.4 Checking Installation Procedure Requirements


               Micro Focus OSX V4.0u1 for Digital UNIX

            o  MFODOC401

               Micro Focus Product Release Notes

            o  MFOMAN401

               Micro Focus OSX V4.0u1 Reference Pages

      1.4.5 Determining Disk Space Requirements

            Table 1-1 lists the disk space requirements for loading
            Micro Focus COBOL software subsets. These requirements
            apply to the disks where you load the Micro Focus 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_Micro_Focus_COBOL_Subset_Sizes_(Kilobytes_Required)____

                                                            Size
      Subset_Name______Directory____________________________(Kbytes)___

      MFCBASE401
      contains
      MFCDOC401
      and MFCMAN401

                       usr/bin                                   1

                       usr/lib/cmplrs/cob                    10955

                       usr/lib/cmplrs/cob/bin                 2803

                       usr/lib/cmplrs/cob/coblib             10623

                       usr/lib/cmplrs/cob/conversion           456

                       usr/lib/cmplrs/cob/cpylib                33

                       usr/lib/cmplrs/cob/demo                 146

                       usr/lib/cmplrs/cob/demo/ccitcp           41

                       usr/lib/cmplrs/cob/demo/clisrvr         152

                       usr/lib/cmplrs/cob/demo/coop            170

                       usr/lib/cmplrs/cob/demo/cowriter        207

                       usr/lib/cmplrs/cob/demo/dialog          117

                       usr/lib/cmplrs/cob/demo/fhutils          84

                       usr/lib/cmplrs/cob/demo/fs               56

                       usr/lib/cmplrs/cob/demo/motif            11

                       usr/lib/cmplrs/cob/demo/nls              15

                       usr/lib/cmplrs/cob/demo/ohbld            10

                       usr/lib/cmplrs/cob/demo/panels          275

                       usr/lib/cmplrs/cob/demo/preproc          81

                       usr/lib/cmplrs/cob/demo/sharedmem        13

                       usr/lib/cmplrs/cob/demo/window1          36

                       usr/lib/cmplrs/cob/dialog              2317

                       usr/lib/cmplrs/cob/docs                 635

                                               (continued on next page)

      1-4

 



                           Preparing for Micro Focus COBOL Installation
                       1.4 Checking Installation Procedure Requirements


      Table 1-1 (Cont.) Micro Focus COBOL Subset Sizes (Kilobytes
      __________________Required)______________________________________

                                                            Size
      Subset_Name______Directory____________________________(Kbytes)___

                       usr/lib/cmplrs/cob/forms2                76

                       usr/lib/cmplrs/cob/help                  12

                       usr/lib/cmplrs/cob/lang                   4

                       usr/lib/cmplrs/cob/lang/C               109

                       usr/lib/cmplrs/cob/lang/En_GB           109

                       usr/lib/cmplrs/cob/lang/en_GB           109

                       usr/lib/cmplrs/cob/lang/en_US           109

                       usr/lib/cmplrs/cob/on-line             1107

                       usr/lib/cmplrs/cob/src                   85

                       usr/lib/cmplrs/cob/src/dialog           553

                       usr/lib/cmplrs/cob/src/fs               388

                       usr/lib/cmplrs/cob/src/makeosx           12

                       usr/lib/cmplrs/cob/src/mfisamv4         274

                       usr/lib/cmplrs/cob/src/mfisamv5         250

                       usr/lib/cmplrs/cob/src/rebuild          162

                       usr/lib/cmplrs/cob/src/rts                3

                       usr/lib/cmplrs/cob/terminfo              42

                       usr/lib/cmplrs/cob/terminfo/a             8

                       usr/lib/cmplrs/cob/terminfo/q             1

                       usr/lib/cmplrs/cob/terminfo/t             2

                       usr/lib/cmplrs/cob/terminfo/v            10

                       usr/lib/cmplrs/cob/terminfo/w            14

                       usr/lib/cmplrs/cob/terminfo/x             2

      Total                                                  32678K

      MFOBASE401
      contains
      MFODOC401
      and MFOMAN401

                       usr/bin                                   1

                       usr/lib/cmplrs/cob                     5124

                       usr/lib/cmplrs/cob/bin                 1343

                       usr/lib/cmplrs/cob/coblib             10623

                       usr/lib/cmplrs/cob/dialog               282

                       usr/lib/cmplrs/cob/docs                 259

                       usr/lib/cmplrs/cob/lang                   4

                       usr/lib/cmplrs/cob/lang/C               109

                       usr/lib/cmplrs/cob/lang/En_GB           109

                       usr/lib/cmplrs/cob/lang/en_GB           109

                       usr/lib/cmplrs/cob/lang/en_US           109

                       usr/lib/cmplrs/cob/on-line               39

                                               (continued on next page)

                                                                    1-5

 



      Preparing for Micro Focus COBOL Installation
      1.4 Checking Installation Procedure Requirements


      Table 1-1 (Cont.) Micro Focus COBOL Subset Sizes (Kilobytes
      __________________Required)______________________________________

                                                            Size
      Subset_Name______Directory____________________________(Kbytes)___

                       usr/lib/cmplrs/cob/src                   29

                       usr/lib/cmplrs/cob/src/dialog           377

                       usr/lib/cmplrs/cob/src/mfisamv4         273

                       usr/lib/cmplrs/cob/src/mfisamv5         249

                       usr/lib/cmplrs/cob/src/rebuild          162

                       usr/lib/cmplrs/cob/src/rts                3

                       usr/lib/cmplrs/cob/terminfo              42

                       usr/lib/cmplrs/cob/terminfo/a             8

                       usr/lib/cmplrs/cob/terminfo/q             1

                       usr/lib/cmplrs/cob/terminfo/t             2

                       usr/lib/cmplrs/cob/terminfo/v            10

                       usr/lib/cmplrs/cob/terminfo/w            14

                       usr/lib/cmplrs/cob/terminfo/x             2

      Total__________________________________________________19283K____

            Using these disk space requirements, total the values for
            the subsets that you will load in each directory.

            Compare the space required for subsets with the free space
            currently on the disks where Micro Focus 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 Micro
            Focus COBOL. You can check which directories are mounted
            and where they are by viewing the /etc/fstab file. For
            example:

            # more /etc/fstab
            /dev/rd0a:/:rw:1:1:ufs::
            /dev/rd0g:/usr:rw:1:2:ufs::
            /usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg:
            /usr/man@bigsys:/usr/man:ro:0:0:nfs:bg:

            The display indicates that /usr (mounted to /dev/rd0g)
            is the only mount point that affects where Micro Focus
            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 Micro Focus 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 /usr
            Filesystem   Total    kbytes   kbytes   %
            node         kbytes   used     free     used  Mounted on
            /dev/rd0g     122598   54447   55892    49%   /usr

      1-6

 



                           Preparing for Micro Focus COBOL Installation
                       1.4 Checking Installation Procedure Requirements


            This display shows that there are 55,892 Kilobytes 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 Micro Focus
            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 Micro Focus 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 Micro Focus COBOL installation procedure creates some
            directories and loads files into subordinate directories,
            as listed in usr/lib/cmplrs/cob/filelist.xxx, where the
            suffix xxx is either MFC or MFO corresponding to the
            products installed.

            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 Micro Focus 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 the Micro Focus COBOL product or Micro Focus
            OSX:

            1. Log in as superuser.

            2. Create the directory usr/lib/cmplrs, usr/lib/cmplrs/cob_
               nnn, or both (in these directory names, nnn is the Micro
               Focus 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 Micro
            Focus COBOL installation from the distribution medium. Your
            site system manager can then decide whether or not to make
            a Micro Focus COBOL distribution kit available on line so
            that subsequent installations of Micro Focus COBOL can use
            the Remote Installation Service (RIS). For information on
            extracting Micro Focus COBOL subsets to a RIS distribution
            area, see the Guide to Sharing Software on a Local Area
            Network.

            If you expect to use Micro Focus 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:

                                                                    1-7

 



      Preparing for Micro Focus COBOL Installation
      1.5 Installing from Media or Using RIS


            o  A Micro Focus COBOL network kit is available for use.

            o  Your system is registered as a RIS client.

            If Micro Focus COBOL subsets are available to you on a RIS
            server system, you must know the name of that system.

            For more information on installing Micro Focus 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.7 Stopping the Installation

            To stop the installation procedure at any time, press Ctrl
            /C. You must then delete files created up to this point
            interactively. The directories and files created during
            the Micro Focus COBOL installation are listed in the file
            corresponding to the product undergoing installation:

            usr/lib/cmplrs/cob/filelist.MFC
            usr/lib/cmplrs/cob/filelist.MFO

































      1-8

 










                                                                      2
      _________________________________________________________________

                                           Installing Micro Focus COBOL


            This chapter describes how to install Micro Focus COBOL.

            Before you start the installation, read Chapter 1.

            You can install Micro Focus COBOL from a server area.

      2.1 Using CD-ROM Distribution Media

            This procedure loads Micro Focus COBOL files on to a disk
            belonging to the system where you perform the installation.
            When Micro Focus COBOL is run, its executable images are
            mapped into memory on your system.

            Follow these steps to install Micro Focus 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 Micro Focus 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. 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 Micro Focus COBOL subsets are located.
               Depending on the Micro Focus product being installed,
               the command would be one of the following:

                   # setld -l /cdrom/mfc40a/kit

                   # setld -l /cdrom/mfo40a/kit

            The installation procedure now displays the names of Micro
            Focus 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 Micro Focus 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 Micro Focus COBOL.

                                                                    2-1

 



      Installing Micro Focus COBOL
      2.2 Using a RIS Distribution Area


            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 Micro
               Focus COBOL subsets are located. For example, if
               you are loading Micro Focus 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 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 Micro Focus 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.

               ______________________________________________________

            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.

            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
            Micro Focus 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-2

 



                                           Installing Micro Focus COBOL
                       2.3 Responding to Installation Procedure Prompts


            Chapter 3 explains how to run the IVP after installation
            and how to delete old Micro Focus COBOL subsets before
            installing a new version of Micro Focus COBOL.

























































                                                                    2-3

 










                                                                      3
      _________________________________________________________________

                                                     After Installation


            This chapter explains what you need to do after the
            installation to make Micro Focus COBOL ready for use.

      3.1 Running the Installation Verification Procedure

            After installing Micro Focus 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 Micro Focus COBOL.

            The Micro Focus COBOL IVP verifies the installation by
            using the fverify command with the -y option (see the
            fverify(8) reference page). MFCBASEnnn compiles and runs a
            Micro Focus COBOL program and MFOBASEnnn runs a previously
            compiled Micro Focus COBOL program.

            To run the IVP after an installation, enter the following
            command:

            # setld -v subsetname

            In this command, subsetname can be any Micro Focus COBOL
            subset. For a sample Micro Focus COBOL IVP, see Appendix A.

            If the verification process fails, look in the /var/adm
            /smlogs/fverify.log file for information to help diagnose
            the problem.

      3.2 Deleting Micro Focus COBOL from Your System

            If you must remove a version of Micro Focus COBOL from your
            system, delete each subset that you previously installed.
            Note that prior to the release of Micro Focus COBOL V4.0A
            Software Developer Suite, the product installations of
            Micro Focus COBOL, Micro Focus Toolbox, and Micro Focus
            Dialog System consisted of individual subsets. If you find
            an older version of Micro Focus installed on your system,
            you may find the following subsets installed: MFCBASEnnn,
            MFCMANnnn, MFCDOCnnn, MFTBASEnnn, MFTMANnnn, MFTDOCnnn,
            MFDBASEnnn, MFDMANnnn, and MFDDOCnnn.

            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 'MFC|MFD|MFT|MFO'

                                                                    3-1

 



      After Installation
      3.2 Deleting Micro Focus COBOL from Your System


            4. Look for the word "installed" in the listing produced
               and then delete the installed subsets. For example:

                   # setld -d subsetnamennn subsetnamennn

               In this command, nnn is the version number.






















































      3-2

 










                                                                      A
      _________________________________________________________________

                                                       Sample Listings


            This appendix provides sample listings for the following
            procedures:


            o  Installation of Micro Focus COBOL products using disk
               media

            o  Installation Verification Procedures (IVP)

      A.1 Sample Micro Focus COBOL Installation



      A.1.1 Installation of Micro Focus COBOL

            # 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) Micro Focus COBOL V4.0u1 Reference Pages
                 2) Micro Focus COBOL V4.0u1 for Digital UNIX
                 3) Micro Focus Product Release Notes and On-line
                    Information

            Or you may choose one of the following options:

                 4) ALL of the above
                 5) CANCEL selections and redisplay menus
                 6) EXIT without installing any subsets

            Press RETURN to display the next screen:

            Enter your choices or press RETURN to redisplay menus.

            Choices (for example, 1 2 4-6): 4

            You are installing the following optional subsets:

                    Micro Focus COBOL V4.0u1 Reference Pages
                    Micro Focus COBOL V4.0u1 for Digital UNIX
                    Micro Focus Product Release Notes and On-line
                       Information

            Is this correct? (y/n): y

            Checking file system space required to install selected
            subsets:

                                                                    A-1

 



      Sample Listings
      A.1 Sample Micro Focus COBOL Installation


            File system space checked OK.

            3 subset(s) will be installed.

            Loading 1 of 3 subset(s)....

            Micro Focus COBOL V4.0u1 for Digital UNIX
               Copying from . (disk)
               Verifying

            Loading 2 of 3 subset(s)....

            Micro Focus Product Release Notes and On-line Information
               Copying from . (disk)
               Verifying

            Loading 3 of 3 subset(s)....

            Micro Focus COBOL V4.0u1 Reference Pages
               Copying from . (disk)
               Verifying

            3 of 3 subset(s) installed successfully.

            MFCBASE401: information, The Co-Writer system has
                    been installed as part of Micro Focus
                    Toolbox and it is necessary to configure
                    the UNIX environment before invoking
                    Co-Writer. Please refer to the Micro Focus
                    documentation for futher information on
                    using Co-Writer.

            MFCBASE401, information: You can run the Installation
                    Verification Procedure using the following
                    command from root:
                            setld -v MFCBASE401

            MFCBASE401, information: Before running Micro Focus
                    COBOL for Digital UNIX or
                    the Micro Focus COBOL IVP, (setld -v) you must
                    set the COBDIR and LD_LIBRARY_PATH environment
                    variables.  COBDIR specifies the directory in
                    which Micro Focus COBOL system software is located.
                    LD_LIBRARY_PATH specifies the search path for
                    shared libraries and must include $COBDIR/coblib.
                    The following commands should be issued:

                            COBDIR=/usr/lib/cmplrs/cob
                            export COBDIR
                            LD_LIBRARY_PATH=$COBDIR/coblib
                            export LD_LIBRARY_PATH

                    In the C shell, the commands are:

                            setenv COBDIR /usr/lib/cmplrs/cob
                            setenv LD_LIBRARY_PATH $COBDIR/coblib

            MFCBASE401, information: If you have relinked the
                    Run-Time System (i.e. used the cob -x command or
                    mkrts script at any time) then you must recreate
                    these executable programs using this new release.
                    If you do not re-create these executables, the
                    results of running the older executables with
                    this new release will be undefined.

      A-2

 



                                                       Sample Listings
                             A.1 Sample Micro Focus COBOL Installation


            Configuring "Micro Focus COBOL V4.0u1 for UNIX on Digital
            UNIX" (MFCBASE401)

            MFCDOC401, information: The release notes are in
                    /usr/lib/cmplrs/cob/relnotes and
                    /usr/lib/cmplrs/cob/relnotes.ps

            Configuring "Micro Focus Product Release Notes and On-line
            Information" (MFCDOC401)

            Configuring "Micro Focus COBOL V4.0u1 Reference Pages"
            (MFCMAN401)


      A.1.2 Installation of Micro Focus Operating System Extensions

            Note that the installation of OSX is for systems that are
            not installing the Micro Focus COBOL base product.


            # 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) Micro Focus OSX V4.0u1 Reference Pages
                 2) Micro Focus OSX V4.0u1 for Digital UNIX
                 3) Micro Focus Product Release Notes and OSX
                    On-line Information

            Or you may choose one of the following options:

                 4) ALL of the above
                 5) CANCEL selections and redisplay menus
                 6) EXIT without installing any subsets

            Press RETURN to display the next screen:

            Enter your choices or press RETURN to redisplay menus.

            Choices (for example, 1 2 4-6): 4

            You are installing the following optional subsets:

                    Micro Focus OSX V4.0u1 Reference Pages
                    Micro Focus OSX V4.0u1 for Digital UNIX
                    Micro Focus Product Release Notes and OSX On-line
                       Information

            Is this correct? (y/n): y

            Checking file system space required to install selected
            subsets:

            File system space checked OK.

            3 subset(s) will be installed.

            Loading 1 of 3 subset(s)....

                                                                    A-3

 



      Sample Listings
      A.1 Sample Micro Focus COBOL Installation


            Micro Focus OSX V4.0u1 for Digital UNIX
               Copying from . (disk)
               Verifying

            Loading 2 of 3 subset(s)....

            Micro Focus Product Release Notes and OSX On-line
            Information
               Copying from . (disk)
               Verifying

            Loading 3 of 3 subset(s)....

            Micro Focus OSX V4.0u1 Reference Pages
               Copying from . (disk)
               Verifying

            3 of 3 subset(s) installed successfully.

            MFOBASE401, information: You can run the Installation
                    Verification Procedure using the following
                    command from root:
                            setld -v MFOBASE401

            MFOBASE401, information: Before running Micro Focus
                    Operating System Extensions (OSX) for Digital
                    UNIX or the Micro Focus
                    OSX IVP, (setld -v) you must set the COBDIR
                    and LD_LIBRARY_PATH environment variables.
                    COBDIR specifies the directory in which Micro
                    Focus COBOL system software is located.
                    LD_LIBRARY_PATH specifies the search path for
                    shared libraries and must include
                    $COBDIR/coblib.
                    The following commands should be issued:

                            COBDIR=/usr/lib/cmplrs/cob
                            export COBDIR
                            LD_LIBRARY_PATH=$COBDIR/coblib
                            export LD_LIBRARY_PATH

                    In the C shell, the commands are:

                            setenv COBDIR /usr/lib/cmplrs/cob
                            setenv LD_LIBRARY_PATH $COBDIR/coblib

            Configuring "Micro Focus OSX V4.0u1 for Digital
            UNIX" (MFOBASE401)

            MFODOC401, information: The release notes are in
                    /usr/lib/cmplrs/cob/relnotes and
                    /usr/lib/cmplrs/cob/relnotes.ps

            Configuring "Micro Focus Product Release Notes and
            OSX On-line Information" (MFODOC401)

            Configuring "Micro Focus OSX V4.0u1 Reference Pages"
            (MFOMAN401)


      A-4

 



                                                       Sample Listings
                        A.2 Sample Installation Verification Procedure


      A.2 Sample Installation Verification Procedure


      A.2.1 Installation Verification Procedure for Micro Focus COBOL


            # COBDIR=/usr/lib/cmplrs/cob
            # export COBDIR
            # LD_LIBRARY_PATH=$COBDIR/coblib
            # export LD_LIBRARY_PATH
            # setld -v MFCBASE401 MFCDOC401 MFCMAN401

            Micro Focus COBOL V4.0u1 for Digital UNIX (MFCBASE401)

            MFCBASE401: Starting Installation Verification
            Procedure (IVP).
            If this fails, please include the following when
            submitting a report:
                1) This subset name, which is MFCBASE401
                2) Output from: ls -l /tmp/MFCBASE401.ivptmp
                3) This setld session

            IVP, information: Emptied scratch directory.
            IVP, information: Running.
            IVP, information: Execution successful.
            IVP, information: Cleaning up.
            IVP, information: MFCBASE401 is properly installed.

            Micro Focus Product Release Notes and On-line
            Information (MFCDOC401)

            MFCDOC401: Starting Installation Verification
            Procedure (IVP).
            IVP, information: MFCDOC401 is properly installed.

            Micro Focus COBOL V4.0u1 Reference Pages (MFCMAN401)

            MFCMAN401: Starting Installation Verification
            Procedure (IVP).
            IVP, information: MFCMAN401 is properly installed.

      A.2.2 Installation Verification Procedure for Micro Focus OSX

            # setld -v MFOBASE401 MFODOC401 MFOMAN401

            Micro Focus OSX V4.0u1 for Digital UNIX
            (MFOBASE401)

            MFOBASE401: Starting Installation Verification
            Procedure (IVP).
            If this fails, please include the following
            when submitting a report:
                1) This subset name, which is MFOBASE401
                2) Output from: ls -l /tmp/MFOBASE401.ivptmp
                3) This setld session

            IVP, information: Created scratch directory.
            IVP, information: Running.
            IVP, information: Execution successful.
            IVP, information: Cleaning up.
            IVP, information: MFOBASE401 is properly installed.

                                                                    A-5

 



      Sample Listings
      A.2 Sample Installation Verification Procedure


            Micro Focus Product Release Notes and OSX On-line
            Information (MFODOC401)

            MFODOC401: Starting Installation Verification
            Procedure (IVP).
            IVP, information: MFODOC401 is properly installed.

            Micro Focus OSX V4.0u1 Reference Pages (MFOMAN401)

            MFOMAN401: Starting Installation Verification
            Procedure (IVP).
            IVP, information: MFOMAN401 is properly installed.
















































      A-6

 










                                                                      B
      _________________________________________________________________

                                                Recovering from Errors


            This appendix provides information to help you deal
            with failures or errors that might occur during product
            installation or product use.

      B.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 MFCBASE401
            Micro Focus COBOL MFCBASE401 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 DIGITAL UNIX
            software installation. For information on system software
            requirements, see Section 1.4.3.

      B.2 Failures During Product Use

            If you encounter a problem while using Micro Focus COBOL,
            please see the section on Software Notes in the release
            notes. If the problem is unresolved, report it to DIGITAL.

            If you have a Software Product Services Support Agreement,
            contact your Customer Support Center (CSC) by telephone or
            by 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, indicate the following:

            o  The name and version number of the operating system you
               are using

            o  The product name (Micro Focus COBOL) and the version
               number of Micro Focus COBOL you are using

            o  The hardware system you are using, such as a model
               number

            o  A brief description of the problem (one sentence if
               possible)

                                                                    B-1

 



      Recovering from Errors
      B.2 Failures During Product Use


            o  How critical the problem is

            When you submit information electronically or are speaking
            on the phone to the appropriate Micro Focus 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).

            To obtain information about purchasing a DIGITAL Software
            Product Services Support Agreement or other support
            services, please contact your local DIGITAL sales
            representative.







































      B-2
