 








             VAXELN Ada Installation Guide

             Order Number: AA-HH45C-TE



             June 1989

             This document contains instructions for installing VAXELN
             Ada on the VMS operating system. It also explains how to
             read the online release notes before or after installing the
             product. This document applies to VAXELN Ada Version 2.0 and
             all maintenance updates throughout that version.





             Revision/Update Information:  This revised manual supersedes
                                           the VAXELN Ada Installation
                                           Guide (Order Number AA-HH45B-
                                           TE)

             Operating System and Version: VMS Version 5.0 or higher.
                                           VAXELN Version 3.1 or higher.
                                           Future maintenance releases may
                                           require higher versions.

             Software Version:             VAXELN Ada Version 2.0





             digital equipment corporation
             maynard, massachusetts

 






             ___________________________________________________
             First Printing, February 1986
             Revised, January 1987
             Revised, June 1989

             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.

              Digital Equipment Corporation 1986, 1987, 1989.

             All Rights Reserved.
             Printed in U.S.A.

             The postpaid Reader's Comments forms at the end of this docu-
             ment request your critical evaluation to assist in preparing
             future documentation.

             The following are trademarks of Digital Equipment Corporation:

             ALL-IN-1        EduSystem     RT
             DEC             IAS           ULTRIX
             DEC/CMS         MASSBUS       UNIBUS
             DEC/MMS         PDP           VAX
             DECnet          PDT           VAXcluster
             DECmate         P/OS          VMS
             DECsystem-10    Professional  VT
             DECSYSTEM-20    Q-bus         Work Processor
             DECUS           Rainbow       VAXELN
             DECwriter       RSTS
             DIBOL           RSX           DIGITAL

                                                                    ZK5129

 















                                                                  Contents
          ________________________________________________________________


          Preface .......................................................v.
          Preparing to Install VAXELN Ada .............................  1
            Prerequisite Software....................................... 1
            Accessing the Online Release Notes........................   1
            Installation Procedure Requirements.......................   2
            User Account Quotas and Privileges........................   4
            VMS License Management Facility ...........................  5
            Using VMSINSTAL..............................................6
          Installing VAXELN Ada......................................... 8
            Installing VAXELN Ada on a VAXcluster ....................  15
          After the Installation........................................16
          Running the Installation Verification Procedure...........    16
          Error Conditions..............................................19
          Installing the VAXELN Remote Debugger as a Shared
            Image.......................................................20.
          Maintenance Updates ..........................................21
          Determining and Reporting Problems..........................  22
          Sample Installation ..........................................23









                                                                       iii

 














                                                                   Preface
          ________________________________________________________________



             This document describes how to install VAXELN Ada on the
             VMS operating system. It is intended for system managers.
             This document applies to VAXELN Ada Version 2.0 and all
             maintenance updates in that version. A major version number
             is represented by the digits to the left of the decimal
             point, and the maintenance update version number is indicated
             by the digits to the right of the decimal point.

             Keep this document with your distribution kit. You will need
             it to install maintenance updates or to reinstall VAXELN Ada
             for any other reason.

             At the back of this document are two Reader's Comments forms.
             If you have any comments about this document, fill out one
             form and mail it; your comments will be considered for the
             next revision of the installation guide.

             For more information about installing VAXELN Ada on VMS
             systems, see your processor-specific installation/operations
             guide.

             The installation procedure is described step-by-step and is,
             for the most part, self-explanatory. The system prompts you
             to answer questions and to change volumes, and waits for you
             to tell it to continue.

                                                                         v

 






             Defaults appear in brackets ([])  throughout the installation
             procedure. Text you type is indicated in red.





































          vi

 






          ____________________________________________________________

          Preparing to Install VAXELN Ada

             Your bill of materials (BOM) and indented bills report (BIL)
             specify the number and contents of your media. Be sure to
             check the contents of your kit against this information.
             If your kit is damaged or if you find that parts of it are
             missing, call your Digital representative.

          ____________________________________________________________

          Prerequisite Software

             VAXELN Ada requires Version 5.0 or higher of the VMS operat-
             ing system. It also requires VAX Ada Version 2.0 or higher
             and the VAXELN Toolkit Version 3.1 or higher.

             The VMS operating system comes with a variety of support
             options, or classes. Classes include such features as net-
             working and RMS journaling. To use VAXELN Ada, your system
             should be running a version of VMS that includes the classes
             listed in the Software Support Addendum (SSA), which comes
             with the Software Product Description (SPD).

          ____________________________________________________________

          Accessing the Online Release Notes

             VAXELN Ada provides online release notes. The prompt to
             display or print the release notes during the installation
             appears in step 4 of the installation procedure when you
             invoke VMSINSTAL with the OPTIONS N parameter.

             To obtain the release notes after the installation, type or
             print the file SYS$HELP:VAXELN_ADA02n.RELEASE_NOTES. The n
             represents the maintenance update of VAXELN Ada covered in
             the release notes. Thus, in the case of VAXELN Ada Version
             2.0, the release notes are in the file SYS$HELP:VAXELN_
             ADA020.RELEASE_NOTES.

                                           VAXELN Ada Installation Guide 1

 






             Online HELP also directs you to the release notes file. After
             the installation, type the following command:

               $ HELP VAXELN_ADA RELEASE_NOTES <RETURN>

          ____________________________________________________________

          Installation Procedure Requirements

             The installation takes approximately 15 minutes, depending
             on the type of media and your system configuration. Before
             installing VAXELN Ada, you must have the following privileges
             and resources:

              o SETPRV privileges, or CMKRNL, WORLD, BYPASS, and SYSPRV
                privileges

              o 5000 blocks of free disk space, minimum, during installa-
                tion.

              o If VAXELN Ada already exists on your system and the VAXELN
                Remote Debugger was specified as a known or shared im-
                age, VMSINSTAL automatically attempts to install the new
                version as a known or shared image. In this case, the in-
                stallation will require the following number of global
                sections and global pages:

                __________________________________________________________
                                        Global
                Image___________________Sections______Global_Pages________

                SYS$SYSTEM:RDBG$RDEBUG.EXE   1              42

                SYS$SHARE:RDBG$SHARE.EXE     2             186

                SYS$MESSAGE:RDBG$SHAREMSG.EXE1______________68____________

                Note that if you are running VAXELN Ada on a VAXcluster,
                VMSINSTAL automatically installs new versions as known or
                shared images only on the machine on which the installa-
                tion is actually performed. You must manually install new

          2  VAXELN Ada Installation Guide

 






                versions as known or shared images on other machines using
                the VMS Install Utility.

                See the Installing the VAXELN Remote Debugger as a Shared
                Image section for more information.

             To determine the number of available global pages on your
             system, invoke the VMS Install Utility by typing the follow-
             ing commands:

               $ INSTALL :== $INSTALL/COMMAND_MODE <RETURN>
               $ INSTALL <RETURN>

             Then type the following command:

          INSTALL> LIST/GLOBAL/SUMMARY <RETURN>

                  Summary of Local Memory Global Sections

              379 Global Sections Used,  31922/39978 Global Pages Used/Unused

          INSTALL> EXIT <RETURN>

             When you enter the LIST/GLOBAL/SUMMARY command, the system
             displays a summary of the number of global sections used, the
             number of global pages used, and the number of global pages
             unused. To exit from the VMS Install Utility, type the EXIT
             command.

                                          NOTE

                 If the necessary number of global pages and global
                 sections is not available, the DCL tables
                 (SYS$LIBRARY:DCLTABLES.EXE) could be corrupted in
                 some situations.

             If there are fewer than the required number of global pages
             available, you can delete an existing known image with the
             VMS Install Utility, or you can increase the GBLPAGES system
             parameter by editing the file SYS$SYSTEM:MODPARAMS.DAT and
             then invoking the SYS$UPDATE:AUTOGEN command procedure. For

                                           VAXELN Ada Installation Guide 3

 






             more information on modifying system parameters and using
             AUTOGEN, see the Guide to Setting Up a VMS System.

             You can determine the number of available global sections by
             invoking SYSGEN as follows:

               $ RUN SYS$SYSTEM:SYSGEN <RETURN>
               SYSGEN> USE CURRENT <RETURN>
               SYSGEN> SHOW GBLSECTIONS <RETURN>
                  .
                  .
                  .
               SYSGEN> EXIT <RETURN>

             Compare the maximum number of global sections with the num-
             ber of global sections in use displayed by the VMS Install
             Utility. If the number of global sections used plus the
             number of global sections required for the remote debug-
             ger exceeds the maximum number of global sections, you must
             increase the number of available global sections before you
             can install the remote debugger as a shared image. To in-
             crease the number, you must increase the GBLSECTIONS system
             parameter by editing the file SYS$SYSTEM:MODPARAMS.DAT and
             then invoking the SYS$UPDATE:AUTOGEN command procedure. For
             more information on modifying system parameters and using
             AUTOGEN, see the Guide to Setting Up a VMS System.

             If the number of global sections used plus the number of
             global sections required for the remote debugger is less
             than the maximum number of global sections, you can exit from
             SYSGEN and continue.

          ____________________________________________________________

          User Account Quotas and Privileges

             To use VAXELN Ada, each account must have TMPMBX and NETMBX
             privileges and the following requirements:

              o Enqueue quota (ENQLM): 60 (minimum)

          4  VAXELN Ada Installation Guide

 






              o Open file quota (FILLM): 50 (minimum)

              o Paging file quota (PGFLQUOTA): 17000 pages (minimum)

              o Subprocess creation quota (PRCLM): 2 (minimum)

              o Working set size (WSDEF): 750 pages (minimum)

              o Working set quota (WSQUOTA): 1500 pages (minimum)

              o Working set extent (WSEXTENT): 2500 pages (minimum)

             Use the VMS Authorize Utility (AUTHORIZE) to compare the
             current values of these quotas with the requirements for
             VAXELN Ada. The account used in the following example is the
             SYSTEM account:

               $ SET DEFAULT SYS$SYSTEM <RETURN>
               $ RUN AUTHORIZE <RETURN>
               UAF> SHOW SYSTEM <RETURN>

             To change the values of these quotas, use the VMS Authorize
             Utility's MODIFY command. For more information, see the VMS
             Authorize Utility Manual.

          ____________________________________________________________

          VMS License Management Facility

             The VMS License Management Facility (LMF) is available with
             Version 5.0 of the VMS operating system. Before installing
             VAXELN Ada, you should register and load your VAXELN Ada
             software license.

             The license registration information you need is contained
             in the Product Authorization Key (PAK) that is shipped with
             VAXELN Ada. The PAK is a paper certificate that contains
             information about the license you have to run a particular
             piece of software.

                                           VAXELN Ada Installation Guide 5

 






             During the installation, you are asked if you have registered
             the VAXELN Ada license and loaded the appropriate authoriza-
             tion key. You must register and load your license for VAXELN
             Ada before you run the Installation Verification Procedure
             (IVP) and use the software.

             To register a license under VMS Version 5.0, first log in to
             a privileged account. Digital recommends that you register
             and load the license from the system manager's account. You
             then have a choice of two ways to perform the registration:

              o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it
                prompts you for information, respond with data from your
                Product Authorization Key (PAK).

              o Enter the DCL LICENSE REGISTER command with the appro-
                priate qualifiers that correspond to information on the
                PAK.

             Depending on the way in which you have registered the VAXELN
             Ada license, you also have a choice of two ways to load the
             license:

              o Type YES in response to the appropriate question when you
                are running SYS$UPDATE:VMSLICENSE.COM.

              o Enter the DCL LICENSE LOAD command.

             Note that you need the CMKRNL, SYSNAM, and SYSPRV privileges
             to use this command. For complete information on using LMF,
             see the manual on the License Management Utility in the VMS
             documentation set.

          ____________________________________________________________

          Using VMSINSTAL

             After you log in to a privileged account to install VAXELN
             Ada, invoke VMSINSTAL, the command procedure that installs
             this product. An example of this procedure is shown in steps
             1 and 2 of the Installing VAXELN Ada section.

          6  VAXELN Ada Installation Guide

 






             The VMSINSTAL command procedure has the following syntax:

               $ @SYS$UPDATE:VMSINSTAL VAXELN_ADA02n ddcu: [OPTIONS N]

             n
             Represents the maintenance update of VAXELN Ada. Refer to
             the label on the VAXELN Ada distribution kit or the bill of
             materials for the maintenance update number of your kit. For
             VAXELN Ada Version 2.0, the maintenance update is 0.

             You can also type an asterisk (*)  in place of VAXELN_ADA02n.

             ddcu:
             Represents a device name where the distribution volumes will
             be mounted for the VAXELN Ada installation media, where dd
             is the device code, c is the controller code, and u is the
             unit number. It is not necessary to use the console drive
             to install VAXELN Ada. If you do use the console drive, you
             should replace any media you removed from the drive. MUA0: is
             the device name used in the examples in this document.

             OPTIONS N
             Is an optional parameter you should provide if you want to
             be prompted to display or print the release notes. If you
             do not include the OPTIONS N parameter, VMSINSTAL does not
             prompt you to display or print the release notes. VMSINSTAL
             permits the use of several other options. For more infor-
             mation on the other options, see your processor-specific
             installation/operations guide.

             VMSINSTAL requires the product and device names. If you do
             not supply these parameters, VMSINSTAL prompts you for them.
             VMSINSTAL will also prompt you for the optional parameter
             that indicates whether or not you want the release notes
             displayed or printed. If you wish to be prompted for the
             product and device names and to display or print the release
             notes, type the following:

               $ @SYS$UPDATE:VMSINSTAL <RETURN>

                                           VAXELN Ada Installation Guide 7

 






             When you invoke VMSINSTAL, it checks the following:

              o Whether you logged in to a privileged account. Digital
                recommends that you install software from the system
                manager's account with your default device and directory
                set to SYS$UPDATE.

              o Whether you have adequate quotas for installation.
                VMSINSTAL checks for the following quota values:

                 _ ASTLM = 24

                 _ BIOLM = 18

                 _ BYTLM = 18000

                 _ DIOLM = 18

                 _ ENQLM = 30

                 _ FILLM = 20

                VMSINSTAL then checks whether the following conditions
                exist. If so, discontinue the conditions before resuming
                the installation procedure.

                 o Whether DECnet is up and running

                 o Whether any users are logged in to the system

                If VMSINSTAL detects either of these conditions, you will
                be asked whether you want to continue the installation. If
                you want to continue, type YES. If you want to stop the
                installation, press RETURN.

          ____________________________________________________________

          Installing VAXELN Ada

             This section contains excerpts from the installation pro-
             cedure and explains each step. Defaults appear in brackets
             throughout the installation procedure.

          8  VAXELN Ada Installation Guide

 






             To abort the installation procedure at any time, press
             CTRL/Y. When you press CTRL/Y, the installation procedure
             deletes all files it has created up to that point and then
             returns you to DCL level. If you want to retry the installa-
             tion procedure after pressing CTRL/Y, you must proceed from
             step 2.

             Step 1: Log in to a privileged account and set your default
             device and directory to SYS$UPDATE.

          <RETURN>

               Username: SYSTEM  <RETURN>
               Password:         <RETURN>
               $ SET DEFAULT SYS$UPDATE <RETURN>

             Step 2: Invoke VMSINSTAL.

               $ @VMSINSTAL VAXELN_ADA02n MUA0: OPTIONS N <RETURN>

                      VAX/VMS Software Product Installation Procedure VX.X

               It is dd-mmm-yyyy at hh:mm.
               Enter a question mark (?) at any time for help.

               * Are you satisfied with the backup of your system
                 disk [YES]? <RETURN>

             If you are satisfied with the backup of your system disk,
             press RETURN. Otherwise, type NO and press RETURN to discon-
             tinue the installation. Digital recommends that you back up
             your system disk before installing any software.







                                           VAXELN Ada Installation Guide 9

 






             Step 3: Insert the installation kit volume.

               Please mount the first volume of the set on MUA0:.
               * Are you ready? YES <RETURN>
               The following products will be processed:

                 VAXELN_ADA V2.n

                       Beginning installation of VAXELN_ADA V2.n at hh:mm

               %VMSINSTAL-I-RESTORE, Restoring product saveset A...

             To indicate that you want to continue the installation, mount
             volume 1, type YES, and press RETURN.

             Step 4: Select a release notes option.

             This step applies only if you specified OPTIONS N in step 2.

               Release Notes Options:

                   1. Display release notes
                   2. Print release notes
                   3. Both 1 and 2
                   4. Copy release notes to SYS$HELP
                   5. Do not display, print or copy release notes

               * Select option [2]: <RETURN>

             If you select option 1, VMSINSTAL displays the release notes
             on line immediately. You can terminate the display at any
             time by pressing CTRL/C.

             If you select option 2, VMSINSTAL prompts you for a queue
             name. Either type a queue name or press RETURN to send the
             file to the default output print device.

               * Queue name [SYS$PRINT]: <RETURN>

          10  VAXELN Ada Installation Guide

 






             If you select option 3, VMSINSTAL displays the release
             notes on line immediately. You can terminate the display
             at any time by pressing CTRL/C. VMSINSTAL then prompts
             you for a queue name. Either type a queue name or press
             RETURN to send the file to the default output print de-
             vice. The VAXELN Ada release notes are then copied to
             SYS$HELP:VAXELN_ADA02n.RELEASE_NOTES.

             If you select option 4, VMSINSTAL copies the release notes to
             SYS$HELP immediately.

             If you select option 5, VMSINSTAL does not display, print, or
             copy the release notes; typically you select this option when
             you want to terminate the installation.

                                          NOTE

                 This version of the release notes file installed by
                 VMSINSTAL is labeled with the current product name and
                 version number. Take care not to delete release notes
                 for previous versions of VAXELN Ada.

             Next, VMSINSTAL displays the following prompt:

               * Do you want to continue the installation?: Y <RETURN>
               %VMSINSTAL-I-RELMOVED, The product release notes have been
                successfully moved to SYS$HELP.

             If you want to continue the installation, type YES and press
             RETURN. If you type NO or press RETURN, VMSINSTAL discon-
             tinues the installation. In either case, VMSINSTAL moves the
             release notes to SYS$HELP.

             Step 5: Select installation options.

               * Do you want to purge files replaced by this installation
                 [YES]? <RETURN>


                                          VAXELN Ada Installation Guide 11

 






             The directories SYS$EXAMPLES, SYS$HELP, SYS$LIBRARY,
             SYS$MANAGER, SYS$SYSTEM, SYS$TEST, and ELN$ may contain pre-
             vious versions of VAXELN Ada files. These files are replaced
             during the installation with new files, but the old files are
             not automatically purged. Purging is recommended. In response
             to the purging prompt, press RETURN to purge the files or
             type NO to keep them.

             Step 6: Respond to License Registration Queries.

             VAXELN Ada supports the VMS License Management Facility
             (LMF). The installation procedure displays license infor-
             mation about your product and then asks if you have regis-
             tered and loaded your authorization key for VAXELN Ada. The
             following is an example of such information:

                       Product:       VAXELN_ADA
                       Producer:      DEC
                       Version:       2.n
                       Release Date:  dd-mmm-yyyy

               * Does this product have an authorization key registered and
                 loaded?

             If you have not registered and loaded your authorization key,
             you must answer "NO" to this question. If you answer "NO",
             the installation still continues.

             Step 7: Read informational messages.

             The VAXELN Ada installation procedure produces a number of
             informational messages that report on the progress of the
             installation.

          There are no more questions.  The remainder of the installation
          procedure will take approximately 10 minutes.

          This kit contains an Installation Verification Procedure (IVP) to
          verify the correct installation of VAXELN ADA.  It can be invoked
          after the conclusion of this procedure as follows:

          12  VAXELN Ada Installation Guide

 






                  @SYS$TEST:VAXELN_ADA$IVP.COM

          You must reinstall VAXELN Ada if you install a new version of the
          VAXELN Toolkit.

          %VMSINSTAL-I-RESTORE, Restoring product saveset B ...

          Providing VAXELN Ada Run-Time Library images and objects.

          %VMSINSTAL-I-RESTORE, Restoring product saveset C ...

          Providing VAXELN Remote Debugger.

          %VMSINSTAL-I-RESTORE, Restoring product saveset D ...

          Providing IVP files.

          %VMSINSTAL-I-SYSDIR, This product creates system disk directory
           VMI$ROOT:[SYSTEST.VAXELN_ADA].
          %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.VAXELN_ADA] already exists

          Providing example program files.

          Providing HELP topic VAXELN_Ada.

             The success of the installation is indicated by the following
             message:

               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
                directories...

             If the installation procedure is successful, the files cre-
             ated by the procedure are moved to their target directories.
             The following files are created or modified by the installa-
             tion procedure:

             SYS$COMMON:[SYSTEST.VAXELN_ADA] and     (new)
             contents

             SYS$TEST:VAXELN_ADA$IVP.COM             (new)

             ELN$:ADA$DMATH.EXE                      (new)

                                          VAXELN Ada Installation Guide 13

 







             ELN$:ADA$FMATH.EXE                      (new)

             ELN$:ADA$GMATH.EXE                      (new)

             ELN$:ADA$HMATH.EXE                      (new)

             ELN$:ADA$ELNRTL.EXE                     (new)

             ELN$:ADA$ELNVMS.EXE                     (new)

             ELN$:RTLSHARE.OLB                       (modified)

             ELN$:RTL.OLB                            (modified)

             ELN$:RTLOBJECT.OLB                      (modified)

             ELN$:ERROR_HANDLING.ADA                 (new)

             ELN$:SQRT_SERVER.ADA                    (new)

             ELN$:SQRT_SERVER_TESTER.ADA             (new)

             SYS$SYSTEM:RDBG$RDEBUG.EXE              (new)

             SYS$SHARE:RDBG$SHARE.EXE                (new)

             SYS$MESSAGE:RDBG$SHAREMSG.EXE           (new)

             SYS$HELP:RDBG$HELPLIB.HLB               (new)

             SYS$HELP:HELPLIB.HLB                    (new)

             SYS$HELP:VAXELN_ADA02n.RELEASE_NOTES    (new)





          14  VAXELN Ada Installation Guide

 






             If you typed YES in response to the prompt that requests a
             file purge at
             step 5, previous versions of the VAXELN Ada files are now
             purged.

             Step 8: End the installation procedure.

                  Installation of VAXELN_ADA V2.n completed at hh:mm

                  VMSINSTAL procedure done at hh:mm

               $ LOGOUT <RETURN>
               SYSTEM     logged out at dd-mmm-yyyy hh:mm:ss.ss

             When the product installation procedure is complete, you
             can choose to install more products, or to log out (as shown
             here.) If you removed any media from the console drive before
             beginning the installation, you should replace it now.

             VMSINSTAL deletes or changes entries in the process symbol
             tables during the installation. Therefore, if you are going
             to continue using the system manager's account and you want
             to restore these symbols, you should log out and log in
             again.

          ____________________________________________________________

          Installing VAXELN Ada on a VAXcluster

             If you want to run VAXELN Ada on multiple nodes of a
             VAXcluster, first check to see that you have the appropriate
             software license. Then, follow these steps after installing
             VAXELN Ada:

              1.Enter the LICENSE LOAD command to activate the license
                on each node in the VAXcluster on which VAXELN Ada is to
                be executed, as described in the VMS License Management
                Utility Manual.

                                          VAXELN Ada Installation Guide 15

 






              2.If the other nodes do not share a common system disk with
                the installation node, you must run a separate installa-
                tion on each node.

              3.If previous versions of VAXELN Ada or remote debugger
                have been specified as known or shared images, VMSINSTAL
                automatically attempts to install the new versions as
                known or shared images. However, if you are running VAXELN
                Ada on a VAXcluster, VMSINSTAL automatically installs new
                versions as known or shared images only on the node on
                which the installation is actually performed. You must
                manually install new versions as known or shared images on
                other nodes using the VMS Install Utility.

          ____________________________________________________________

          After the Installation

             VAXELN Ada is now installed. The VAXELN Remote Debugger can
             be invoked with the DEBUG/REMOTE command.

             If VAXELN Ada will be used extensively on your system, you
             can reduce system overhead and memory requirements by in-
             stalling it as a shared image using the VMS Install Utility.
             For more information, see the Installing the VAXELN Remote
             Debugger as a Shared Image section.

          ____________________________________________________________

          Running the Installation Verification Procedure

             The VAXELN Ada installation procedure creates the files
             needed to run the Installation Verification Procedure (IVP)
             (see step 7 of the Installing VAXELN Ada section).

             To run the IVP, execute the following command procedure:

               $ @SYS$TEST:VAXELN_ADA$IVP.COM <RETURN>

          16  VAXELN Ada Installation Guide

 






             The procedure compiles, links, and builds a VAXELN Ada test
             program to verify that the packages and run-time library
             have been properly installed. First, the following message is
             issued:

               VAXELN Ada Version 2.n Installation Verification Procedure.

             Then, a temporary program library is created and defined to
             be the current program library; the VAX Ada predefined units
             just installed in ADA$PREDEFINED are entered into the program
             library. Messages like the following are issued:

               %ACS-I-CL_LIBCRE, Library SYS$SYSROOT:[SYSUPD.ADAELN$IVP_LIB]
                created
               %ACS-I-CL_LIBIS, Current program library is
                SYS$SYSROOT:[SYSUPD.ADAELN$IVP_LIB]

             The IVP consists of two programs that are compiled, linked,
             and then built into two versions of a bootable VAXELN system.
             One version is suitable for copying to a disk; the other is
             suitable for downline loading. The following messages are
             issued:

          Compiling IVP programs.
          Linking IVP programs.
          %ACS-I-CL_LINKING, Invoking the VMS Linker for VAXELN target
          %ACS-I-CL_LINKING, Invoking the VMS Linker for VAXELN target

          An Installation Verification Program can be built for each target CPU
          type.  Answer YES if you want an IVP built for any of the following targets.
          NO is the default.

          QBUS - MicroVAX I, MicroVAX II (KA630), KA620, MicroVAX 3500,
                 MicroVAX 3600: <RETURN>
          UBUS - 725, 730, 750: <RETURN>
          62xx: <RETURN>
          85xx,8700: <RETURN>
          8800: <RETURN>
          MicroVAX 2000: <RETURN>

          The Installation Verification Procedure is building the system...

                                          VAXELN Ada Installation Guide 17

 






          Verifying installation of VAXELN Remote Debugger.

          Two bootable VAXELN Ada test systems have been provided for each specified
          target.  They are in directory SYS$COMMON:[SYSTEST.VAXELN_ADA].

              VAXELN_ADA$IVP_target_DISK.SYS is a disk or tape-bootable system.
              VAXELN_ADA$IVP_target_DOWNLINE.SYS is a downline-loadable system.

          Use the ELN$:COPYSYS.COM procedure to copy VAXELN_ADA$IVP_target_DISK.SYS
          to a disk or tape and boot it on a target VAX, or use downline load
          procedures to boot VAXELN_ADA$IVP_target_DOWNLINE.SYS.  See the VAXELN
          Ada User's Manual for more details.

          Any of these systems will verify that the execution environment of VAXELN
          Ada has been correctly installed.  Because the IVP system does not include
          the Network Service, you cannot use the VAXELN Remote Debugger on these
          systems.

          VAXELN Ada Version 2.n Installation Verification Procedure has completed.

             After you run the IVP, you will have two bootable VAXELN
             systems available for you to verify that the VAXELN Ada
             execution environment is correct. SYS$COMMON:[SYSTEST.VAXELN_
             ADA]:VAXELN_ADA$IVP_target_DISK.SYS is a version that can
             be copied to a disk or tape using ELN$:COPYSYS.COM, and then
             booted on a target VAX processor; SYS$COMMON:[SYSTEST.VAXELN_
             ADA]:VAXELN_ADA$IVP_target_DOWNLINE.SYS is a version that can
             be downline-loaded. To verify that the VAXELN Ada execution
             environment is correct, you should boot one of these systems
             on a target VAX processor following the instructions in the
             VAXELN Ada User's Manual. When you boot one of these systems,
             the following messages should be displayed on your system
             console terminal:






          18  VAXELN Ada Installation Guide

 






          VAXELN Ada Version 2.n Installation Verification Program

          IVP_OK - Job 1 starting
          IVP_OK - Job 2 starting
          IVP_OK - Test task activated
          IVP_OK - Test starting
          IVP_OK - Test task finished

          VAXELN Ada Version 2.n Installation Verification Program passed.

             If you do not see these messages, or other messages are
             displayed, the execution environment may be incorrect and
             you should contact Digital for assistance.

          ____________________________________________________________

          Error Conditions

             If the VAXELN Ada installation procedure fails for any rea-
             son, a message like the following is displayed:

               %VMSINSTAL-E-INSFAIL, The installation of VAXELN_ADA V2.n has
                failed.

             An error during the installation can occur if one or more of
             the following conditions exist:

              o Operating system version is incorrect.

              o Prerequisite software version is incorrect.

              o Quotas necessary for successful installation are in-
                sufficient (see the Installation Procedure Requirements
                section).

              o Process quotas required by VMSINSTAL are incorrect (see
                the Using VMSINSTAL section).

              o The VMS HELP library is currently in use.

              o The product was registered incorrectly or not registered.

                                          VAXELN Ada Installation Guide 19

 






             For descriptions of the error messages generated by these
             conditions, see the VMS System Messages and Recovery
             Procedures Reference Volume, your processor-specific in-
             stallation/operations guide, or the VMS License Management
             Utility Manual.

             If you are notified that any of these conditions exist, you
             should take the appropriate action as described in the mes-
             sage. You may need to change a system parameter or increase
             an authorized quota value.

             If the installation fails, you must restart the installation
             procedure from step 2.

          ____________________________________________________________

          Installing the VAXELN Remote Debugger as a Shared Image

             If VAXELN Ada will be used extensively on your system, you
             can reduce the system overhead and memory requirements by
             installing the VAXELN Remote Debugger as a shared image.

             First, determine the number of available global pages
             and global sections on your system. See the Installation
             Procedure Requirements section for information on how to do
             this.

             Then, invoke the VMS Install Utility and install the remote
             debugger as a shared image by typing the following commands:

               $ RUN SYS$SYSTEM:INSTALL <RETURN>
               INSTALL> REPLACE SYS$SYSTEM:RDBG$RDEBUG.EXE/OPEN -
               _INSTALL>/SHARED/HEADER_RESIDENT <RETURN>
               INSTALL> REPLACE SYS$SHARE:RDBG$SHARE.EXE/OPEN -
               _INSTALL>/SHARED/HEADER_RESIDENT <RETURN>
               INSTALL> EXIT <RETURN>

             By using the /HEADER_RESIDENT qualifier, you save disk I/O on
             image activation (at the expense of a permanently allocated
             page of memory). By using the REPLACE command, you guarantee
             that the installation will work whether the images are newly
             installed or were previously installed. If a file has not

          20  VAXELN Ada Installation Guide

 






             been previously installed, you may get a warning message;
             however, you can ignore the message because the file will be
             installed correctly.

             To ensure that the remote debugger is installed as a shared
             image each time the system is bootstrapped, include the
             following lines in SYS$MANAGER:SYSTARTUP_V5.COM (the site-
             specific startup file):

               $ INSTALL :== $INSTALL/COMMAND_MODE
               $ INSTALL
               REPLACE SYS$SYSTEM:RDBG$RDEBUG.EXE/OPEN/SHARED/HEADER_RESIDENT
               REPLACE SYS$SHARE:RDBG$SHARE.EXE/OPEN/SHARED/HEADER_RESIDENT
               EXIT

          ____________________________________________________________

          Maintenance Updates

             Digital may periodically issue maintenance updates of VAXELN
             Ada. Each update consists of an installation kit. You should
             install this kit as described in this document or in any
             documentation that may accompany the maintenance update.

             Each time a maintenance update is released, the version
             number changes. For example, if the current version is 2.0,
             the version number of the first maintenance update will
             be 2.1. In addition, each maintenance update includes new
             release notes. The release notes describe the changes that
             have been made to VAXELN Ada since the previous release.

             The update release notes are provided on line. You should
             read the release notes when you first install VAXELN Ada;
             they are also accessible at any time after the product is
             installed. For information on reading the release notes at
             the time that you install VAXELN Ada, follow the installation
             procedure through step 4. After VAXELN Ada is installed,
             display or print the file SYS$HELP:VAXELN_ADA02n.RELEASE_
             NOTES to locate the release notes (where n is the number

                                          VAXELN Ada Installation Guide 21

 






             of the current maintenance update), or type the following
             command:

               $ HELP VAXELN_Ada Release_Notes <RETURN>

          ____________________________________________________________

          Determining and Reporting Problems

             If an error occurs while you are using VAXELN Ada and you
             believe that the error is caused by a problem with VAXELN
             Ada, take one of the following actions:

              o If you purchased VAXELN Ada within the past 90 days and
                you think the problem is caused by a software error, you
                can submit a Software Performance Report (SPR).

              o If you have a Basic or DECsupport Software Agreement,
                you should call your Customer Support Center. With these
                services, you receive telephone support that provides
                high-level advisory and remedial assistance. For more
                information, contact your local Digital representative.

              o If you have a Self-Maintenance Software Agreement, you can
                submit a Software Performance Report (SPR).

             If you find an error in the VAXELN Ada documentation, you
             should fill out and submit a Reader's Comments form from the
             back of the document in which the error was found. Include
             the section and page number where the error was found.

             When you prepare to submit an SPR, please take the following
             steps:

              1.Describe as accurately as possible the state of the system
                and the circumstance when the problem occurred. Include
                in the description the version number of VAXELN Ada being
                used. Demonstrate the problem with specific examples.

              2.Reduce the problem to as small a size as possible.

              3.Remember to include listings of any command files, rele-
                vant data files, and so on.

          22  VAXELN Ada Installation Guide

 






              4.Provide a listing of the program.

              5.If the program is longer than 50 lines, submit a copy of
                the program on machine-readable media (floppy diskette or
                magnetic tape). If necessary, also submit a copy of the
                program library used to build the application. Use the VMS
                Backup Utility to copy the program library to the machine-
                readable media. All media will be returned to you when the
                SPR is answered.

              6.Report only one problem per SPR. This will facilitate a
                more rapid response.

              7.Mail the SPR package to Digital.

             Experience shows that many SPRs do not contain enough in-
             formation to duplicate or identify the problem. Complete and
             concise information helps Digital give accurate and timely
             service to software problems.

          ____________________________________________________________

          Sample Installation

             This section contains a sample installation of VAXELN Ada.
             Note that this is only a sample. Sometimes the installation
             procedure is modified in maintenance updates of this prod-
             uct. Because this installation guide is not usually revised
             for maintenance updates, be sure to read the Read Before
             Installing or Using VAXELN Ada letter before you install this
             product. This letter notes any significant changes in the
             installation that vary from this sample.

          $ SET DEFAULT SYS$UPDATE
          $ @VMSINSTAL VAXELN_ADA020 MUA0: OPTIONS N

                  VAX/VMS Software Product Installation Procedure V5.0

          It is 25-APR-1989 at 17:22.
          Enter a question mark (?) at any time for help.

          * Are you satisfied with the backup of your system disk [YES]? <RETURN>

                                          VAXELN Ada Installation Guide 23

 






          The following products will be processed:

            VAXELN_ADA V2.0

                  Beginning installation of VAXELN_ADA V2.0 at 17:23

          %VMSINSTAL-I-RESTORE, Restoring product saveset A ...

              Release Notes Options:

                  1.  Display release notes
                  2.  Print release notes
                  3.  Both 1 and 2
                  4.  Copy release notes to SYS$HELP
                  5.  Do not display, print or copy release notes

          * Select option [2]: 4 <RETURN>
          * Do you want to continue the installation? YES <RETURN>
          %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully
           moved to SYS$HELP.

           VAXELN Ada V2.0-00 Installation Procedure

          This product requires that the following products already be installed:
                  VMS Version 5.0 or higher,
                  VAX Ada Version 2.0 or higher, and
                  VAXELN Toolkit Version 3.1 or higher.

          The installation procedure will now verify that these products are present.

          %VAXELN_ADA-S-PREREQ_OK, prerequsisite software check completed

          Checking to see if enough space is available for installation.

          * Do you want to purge files replaced by this installation [YES]? <RETURN>

          Checking for correct licensing agreements.

                  Product:      VAXELN-ADA
                  Producer:     DEC
                  Version:      2.0
                  Release Date: 15-MAR-1989

          24  VAXELN Ada Installation Guide

 






          * Does this product have an authorization key registered and
            loaded? YES <RETURN>

          There are no more questions.  The remainder of the installation
          procedure will take approximately 10 minutes.

          This kit contains an Installation Verification Procedure (IVP) to
          verify the correct installation of VAXELN ADA.  It can be invoked
          after the conclusion of this procedure as follows:

                  @SYS$TEST:VAXELN_ADA$IVP.COM

          You must reinstall VAXELN Ada if you install a new version of the
          VAXELN Toolkit.

          %VMSINSTAL-I-RESTORE, Restoring product saveset B ...

          Providing VAXELN Ada Run-Time Library images and objects.

          %VMSINSTAL-I-RESTORE, Restoring product saveset C ...

          Providing VAXELN Remote Debugger.

          %VMSINSTAL-I-RESTORE, Restoring product saveset D ...

          Providing IVP files.

          %VMSINSTAL-I-SYSDIR, This product creates system disk directory
           VMI$ROOT:[SYSTEST.VAXELN_ADA].
          %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.VAXELN_ADA] already exists

          Providing example program files.

          Providing HELP topic VAXELN_Ada.

          %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
                  Installation of VAXELN_ADA V2.0 completed at 17:33

                  VMSINSTAL procedure done at 17:34

          $ @SYS$TEST:VAXELN_ADA$IVP.COM

          VAXELN ADA Version 2.0 Installation Verification Procedure.

                                          VAXELN Ada Installation Guide 25

 






          %ACS-I-CL_LIBCRE, Library SYS$SYSROOT:[SYSUPD.ADAELN$IVP_LIB] created
          %ACS-I-CL_LIBIS, Current program library is
           SYS$SYSROOT:[SYSUPD.ADAELN$IVP_LIB]
          Compiling IVP programs.
          Linking IVP programs.
          %ACS-I-CL_LINKING, Invoking the VMS Linker for VAXELN target
          %ACS-I-CL_LINKING, Invoking the VMS Linker for VAXELN target

          An Installation Verification Program can be built for each target CPU type.
          Answer YES if you want a system image built for any of the following targets.
          No is the default.

          QBUS - MicroVAX I, MicroVAX II (KA630), KA620, MicroVAX 3500,
           MicroVAX 3600: YES <RETURN>
          UBUS - 725, 730, 750: <RETURN>
          62xx: <RETURN>
          85xx,8700: <RETURN>
          8800: <RETURN>
          MicroVAX 2000: <RETURN>

          The Installation Verification Procedure is building the system...

          Q-bus IVP building ...
          System image size is 520 pages (260K bytes)
          System image size is 520 pages (260K bytes)

          Verifying installation of VAXELN Remote Debugger.

          Two bootable VAXELN Ada test systems have been provided for each specified
          target.  They are in directory SYS$COMMON:[SYSTEST.VAXELN_ADA].

              VAXELN_ADA$IVP_target_DISK.SYS is a disk or tape-bootable system.
              VAXELN_ADA$IVP_target_DOWNLINE.SYS is a downline-loadable system.

          Use the ELN$:COPYSYS.COM procedure to copy VAXELN_ADA$IVP_target_DISK.SYS
          to a disk or tape and boot it on a target VAX, or use downline load
          procedures to boot VAXELN_ADA$IVP_target_DOWNLINE.SYS.  See the VAXELN
          Ada User's Manual for more details.

          26  VAXELN Ada Installation Guide

 






          Any of these systems will verify that the execution environment of VAXELN
          Ada has been correctly installed.  Because the IVP system does not include
          the Network Service, you cannot use the VAXELN Remote Debugger on these
          systems.

          VAXELN ADA Version 2.0 Installation Verification Procedure has completed.

          $ LOGOUT <RETURN>
            SYSTEM       logged out at 25-APR-1989 17:45:05.61






























                                          VAXELN Ada Installation Guide 27
