 










                     Micro_Focus_COBOL
                     _____________________________
                     Installation Guide for
                     DIGITAL UNIX Systems

                     Order Number: AA-Q42CH-TE


                     April 1998

                     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 super-
                                                  sedes AA-Q42CG-TE,
                                                  Micro Focus COBOL
                                                  Installation Guide
                                                  for DIGITAL UNIX.

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

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

                     Digital Equipment Corporation
                     Maynard, Massachusetts

 






              __________________________________________________________
              April 1998

              Digital Equipment Corporation makes no representations
              that the use of its products in the manner described in
              this publication will not infringe on existing or future
              patent rights, nor do the descriptions contained in this
              publication imply the granting of licenses to make, use,
              or sell equipment or software in accordance with the
              description.

              Possession, use, or copying of the software described
              in this publication is authorized only pursuant to a
              valid written license from Digital or an authorized
              sublicensor.

              © Digital Equipment Corporation 1998. All Rights Reserved.

              The following are trademarks of Digital Equipment
              Corporation: Bookreader, DEC, DECdocument, 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, Application Server,
              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-2
           1.3   Special Checks and Requirements for
                 Installing Micro Focus COBOL.................    1-2
           1.4   Checking Installation Procedure
                 Requirements.................................    1-3
           1.4.1     Checking Login Privileges................    1-3
           1.4.2     Checking Hardware Requirements...........    1-3
           1.4.3     Checking Software Requirements...........    1-3
           1.4.4     Determining Which Subsets to Load........    1-4
           1.4.5     Determining Disk Space Requirements......    1-5
           1.4.5.1     Checking Current Disk Space............    1-9
           1.4.5.2     Increasing Disk Space by Using
                       Alternative Disks .....................   1-10
           1.5   Installing from Media or Using RIS...........   1-10
           1.6   Backing Up Your System Disk..................   1-11
           1.7   Stopping the Installation....................   1-11

     2  Installing Micro Focus COBOL

           2.1   Using CD-ROM Distribution Media..............    2-1
           2.2   Using a RIS Distribution Area ...............    2-2
           2.3   Responding to Installation Procedure
                 Prompts......................................    2-2
           2.3.1     Selecting Subsets........................    2-3
           2.3.2     Monitoring Displays During the Subset
                     Loading Process..........................    2-3


                                                                  iii

 






     3  After Installation

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

     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 Application
                     Server ..................................    A-4
           A.2   Sample Installation Verification Procedure
                 .............................................    A-7
           A.2.1     Installation Verification Procedure for
                     Micro Focus COBOL .......................    A-7
           A.2.2     Installation Verification Procedure for
                     Micro Focus Application Server ..........    A-8

     B  Recovering from Errors

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


     Tables

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

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













     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 a Read Before
              Installing or Using Micro Focus COBOL V4.1A for DIGITAL
              UNIX Systems letter, which provide specific information to
              the product installation on DIGITAL UNIX.

              The Micro Focus COBOL Developer Suite for UNIX set
              includes:

              Getting Started (Issue 1, August 1996)
              Object COBOL User Guide (Issue 4, August 1996)
              Object COBOL Character Tools (Issue 1, August 1996)
              Dialog System Character Mode User Guide (Issue 5,
              September 1994)
              Master Index & Glossary (Issue 5, August 1996)
              Programmer's Guide to Writing Programs (Issue 2)
              Programmer's Guide to Creating User Interfaces (Issue 2)
              Programmer's Guide to File Handling (Issue 2)

                                                                       v

 






              Programmer's Guide to Communications (Issue 2)
              OO Programming with Object COBOL (Issue 3)
              DCE Programmer's Guide and Reference (Issue 1)
              Compatibility Guide (Issue 3, April 1993)
              Language Reference (Issue 15, May 1995)
              Language Reference-Additional Topics (Issue 15, May 1995)
              Error Messages (Issue 11, May 1995)
              Pocket Guide (Issue 9, August 1996)


        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.

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

                                                (continued on next page)



        vi

 






              Table_1_(Cont.)_Conventions_Used_in_This_Guide____________

              Convention_____Meaning____________________________________

              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.























                                                                     vii


 











                                                                       1
        ________________________________________________________________

                            Preparing for Micro Focus COBOL Installation



              Your distribution kit includes a letter entitled Read
              Before Installing or Using Micro Focus COBOL V4.1A 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-1

 



        Preparing for Micro Focus COBOL Installation
        1.2 Registering Your Software License

        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.

              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 DIGITAL UNIX Software License Management
              manual 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.

        1-2

 



                            Preparing for Micro Focus COBOL Installation
    1.3 Special Checks and Requirements for Installing Micro Focus COBOL

              The Micro Focus COBOL Software Developer Suite provides
              the development environment for your COBOL applications.
              Micro Focus COBOL Application Server for DIGITAL UNIX,
              previously known as Micro Focus Operating System
              Extensions (OSX), is used for the deployment of COBOL
              applications and is for installation on systems that are
              not installing 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.

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

        1.4.3 Checking Software Requirements

              Micro Focus COBOL V4.1A requires 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

                                                                     1-3

 



        Preparing for Micro Focus COBOL Installation
        1.4 Checking Installation Procedure Requirements

              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 that you
              want to load.

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

              o  MFCBASE411

                 Micro Focus COBOL V4.1A for DIGITAL UNIX

              o  MFCDOC411

                 Micro Focus Product Release Notes and Online Information

              o  MFCMAN411

        1-4

 



                            Preparing for Micro Focus COBOL Installation
                        1.4 Checking Installation Procedure Requirements

                 Micro Focus COBOL V4.1A Reference Pages

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

              o  MFOBASE411

                 Micro Focus Application Server V4.1A for DIGITAL UNIX

              o  MFODOC411

                 Micro Focus Product Release Notes

              o  MFOMAN411

                 Micro Focus Application Server V4.1A Reference Pages

        1.4.5 Determining Disk Space Requirements

              Table 1-1 lists the approximate 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)__

        MFCBASE411
        contains
        MFCDOC411
        and MFCMAN411

                         usr/bin                                   1

                         usr/lib/cmplrs/cob                    12240

                         usr/lib/cmplrs/cob/bin                 3767

                         usr/lib/cmplrs/cob/coblib             20353

                         usr/lib/cmplrs/cob/conversion           473

                         usr/lib/cmplrs/cob/cpylib                33

                         usr/lib/cmplrs/cob/demo                 146

                                                (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/demo/ccitcp           41

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

                         usr/lib/cmplrs/cob/demo/dialog          118

                         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/oops             79

                         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              2343

                         usr/lib/cmplrs/cob/docs                 607

                         usr/lib/cmplrs/cob/forms2                78

                         usr/lib/cmplrs/cob/help                  12

                         usr/lib/cmplrs/cob/lang/C               124

                         usr/lib/cmplrs/cob/lang/En_GB           124

                         usr/lib/cmplrs/cob/lang/en_GB           124

                         usr/lib/cmplrs/cob/lang/en_US           124

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

                                                (continued on next page)

        1-6

 



                            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                   96

                         usr/lib/cmplrs/cob/src/daisgen           12

                         usr/lib/cmplrs/cob/src/dialog           582

                         usr/lib/cmplrs/cob/src/fs               396

                         usr/lib/cmplrs/cob/src/lfs              369

                         usr/lib/cmplrs/cob/src/makeasp           12

                         usr/lib/cmplrs/cob/src/mfisamv4         418

                         usr/lib/cmplrs/cob/src/mfisamv5         386

                         usr/lib/cmplrs/cob/src/oops            2538

                         usr/lib/cmplrs/cob/src/rebuild          171

                         usr/lib/cmplrs/cob/src/rts                4

                         usr/lib/cmplrs/cob/src/www               10

                         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                                                  47936K

                                                (continued on next page)

                                                                     1-7

 



        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)__

        MFOBASE411
        contains
        MFODOC411
        and MFOMAN411

                         usr/bin                                   1

                         usr/lib/cmplrs/cob                     6468

                         usr/lib/cmplrs/cob/bin                 1695

                         usr/lib/cmplrs/cob/coblib             20353

                         usr/lib/cmplrs/cob/dialog               285

                         usr/lib/cmplrs/cob/docs                 259

                         usr/lib/cmplrs/cob/lang/C               124

                         usr/lib/cmplrs/cob/lang/En_GB           124

                         usr/lib/cmplrs/cob/lang/en_GB           124

                         usr/lib/cmplrs/cob/lang/en_US           124

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

                         usr/lib/cmplrs/cob/src                   33

                         usr/lib/cmplrs/cob/src/dialog           400

                         usr/lib/cmplrs/cob/src/mfisamv4         417

                         usr/lib/cmplrs/cob/src/mfisamv5         385

                         usr/lib/cmplrs/cob/src/oops            1331

                         usr/lib/cmplrs/cob/src/rebuild          171

                         usr/lib/cmplrs/cob/src/rts                4


        1-8





                            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/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__________________________________________________32416K___

              Using the disk space requirements in Table 1-1, 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.


                                                                     1-9

 



        Preparing for Micro Focus COBOL Installation
        1.4 Checking Installation Procedure Requirements

              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

              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.


        1-10

 



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

              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 the Micro
              Focus Application Server:

              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 DIGITAL UNIX Sharing
              Software on a Local Area Network manual.

              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:

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


 



        Preparing for Micro Focus COBOL Installation
        1.6 Backing Up Your System Disk

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




 









                                                                       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:

                                                                     2-1

 



        Installing Micro Focus COBOL
        2.1 Using CD-ROM Distribution Media

                     # setld -l /cdrom/mfc411/kit

                     # setld -l /cdrom/mfo411/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. 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-2

 



                                            Installing Micro Focus COBOL
                        2.3 Responding to Installation Procedure Prompts

        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.

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



        After Installation
        3.2 Deleting Micro Focus COBOL from Your System

        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'

              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.1A Reference Pages
                   2) Micro Focus COBOL V4.1A 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:

                                                                     A-1

 



        Sample Listings
        A.1 Sample Micro Focus COBOL Installation

              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.1A Reference Pages
                      Micro Focus COBOL V4.1A 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:

              File system space checked OK.

              3 subset(s) will be installed.

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

              Micro Focus COBOL V4.1A 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.1A Reference Pages
                 Copying from . (disk)
                 Verifying

              3 of 3 subset(s) installed successfully.

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

        A-2

 



                                                        Sample Listings
                              A.1 Sample Micro Focus COBOL Installation

              MFCBASE411, 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

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

              Configuring "Micro Focus COBOL V4.1A for UNIX on DIGITAL
              UNIX" (MFCBASE411)

              MFCDOC411, 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" (MFCDOC411)

              Configuring "Micro Focus COBOL V4.1A Reference Pages"
              (MFCMAN411)





                                                                     A-3

 



        Sample Listings
        A.1 Sample Micro Focus COBOL Installation

        A.1.2 Installation of Micro Focus Application Server

              Note that the installation of Micro Focus Application
              Server 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 Application Server V4.1A Reference Pages
                   2) Micro Focus Application Server V4.1A for DIGITAL UNIX
                   3) Micro Focus Product Release Notes and Application
                      Server 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 Application Server V4.1A Reference Pages
                      Micro Focus Application Server V4.1A for DIGITAL UNIX
                      Micro Focus Product Release Notes and Application
                         Server 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.

        A-4

 



                                                        Sample Listings
                              A.1 Sample Micro Focus COBOL Installation

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

              Micro Focus Application Server V4.1A for DIGITAL UNIX
                 Copying from . (disk)
                 Verifying

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

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

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

              Micro Focus Application Server V4.1A Reference Pages
                 Copying from . (disk)
                 Verifying

              3 of 3 subset(s) installed successfully.

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

              MFOBASE411, information: Before running Micro Focus
                      Application Server for DIGITAL
                      UNIX or the Micro Focus Application
                      Server 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

                                                                     A-5

 



        Sample Listings
        A.1 Sample Micro Focus COBOL Installation

              Configuring "Micro Focus Application Server V4.1A for DIGITAL
              UNIX" (MFOBASE411)

              MFODOC411, 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
              Application Server On-line Information" (MFODOC411)

              Configuring "Micro Focus Application Server V4.1A Reference
              Pages" (MFOMAN411)

































        A-6

 



                                                        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 MFCBASE411 MFCDOC411 MFCMAN411

              Micro Focus COBOL V4.1A for DIGITAL UNIX (MFCBASE411)

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

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

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

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

              Micro Focus COBOL V4.1A Reference Pages (MFCMAN411)

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



                                                                     A-7

 



        Sample Listings
        A.2 Sample Installation Verification Procedure

        A.2.2 Installation Verification Procedure for Micro Focus
              Application Server


              # setld -v MFOBASE411 MFODOC411 MFOMAN411

              Micro Focus Application Server V4.1A for DIGITAL UNIX
              (MFOBASE411)

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

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

              Micro Focus Product Release Notes and Application
              Server On-line Information (MFODOC411)

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

              Micro Focus Application Server V4.1A Reference Pages
              (MFOMAN411)

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









        A-8

 









                                                                       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 instal-
              lation fails due to insufficient disk space, the following
              message appears:

              There is not enough space for subset MFCBASE411
              Micro Focus COBOL MFCBASE411 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-1

 



        Recovering from Errors
        B.2 Failures During Product Use

        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)

              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
