 












                     Compaq_BASIC_for_OpenVMS_Alpha_Systems________
                     Installation Guide

                     Order Number: AA-Q29SD-TE


                     April 2002

                     This guide describes how to install Compaq BASIC
                     on an Alpha processor running the OpenVMS Alpha
                     operating system.





                     Revision/Update Information: This guide supersedes
                                                  the Compaq BASIC for
                                                  OpenVMS Alpha Systems
                                                  Installation Guide,
                                                  Version 1.4.

                     Operating System & Version:  OpenVMS for Alpha
                                                  Systems Version
                                                  7.1 to 7.3 (with
                                                  IEEE floating-
                                                  point support) or
                                                  OpenVMS for Alpha
                                                  Systems Version
                                                  6.2 to 7.3 (without
                                                  IEEE floating-point
                                                  support)

                     Software Version:            Compaq BASIC Version
                                                  1.5 for OpenVMS Alpha
                                                  Systems

                     Compaq Computer Corporation
                     Houston, Texas

 






           __________________________________________________________
           April 2002

            2002 Compaq Information Technologies Group, L.P.

           Compaq, the Compaq logo, Alpha, DECNET, OpenVMS, VAX,
           VMS, and the DIGITAL logo are trademarks of Compaq
           Information Technologies Group, L.P. in the U.S. and/or
           other countries.

           Motif is a trademark of The Open Group in the U.S. and/or
           other countries.

           All other product names mentioned herein may be trademarks
           of their respective companies.

           Confidential computer software. Valid license from Compaq
           required for possession, use or copying. Consistent with
           FAR 12.211 and 12.212, Commercial Computer Software,
           Computer Software Documentation, and Technical Data for
           Commercial Items are licensed to the U.S. Government under
           vendor's standard commercial license.

           Compaq shall not be liable for technical or editorial
           errors or omissions contained herein. The information
           is provided "as is" without warranty of any kind and is
           subject to change without notice. The warranties for
           Compaq products are set forth in the express limited
           warranty statements accompanying such products. Nothing
           herein should be construed as constituting an additional
           warranty.

           This document is available on CD-ROM.

           This document was prepared using VAX DOCUMENT Version 2.1.

 













   ________________________________________________________________

                                                           Contents


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


   1  Preparing for Compaq BASIC Installation

         1.1   Registering Your Software License ...........    1-1
         1.2   Required Hardware............................    1-2
         1.3   Required Operating System Components and
               Software.....................................    1-2
         1.4   Installation Procedure Requirements..........    1-3
         1.4.1     VMSINSTAL Checks.........................    1-3
         1.4.2     Account Privileges.......................    1-3
         1.4.3     Disk Space...............................    1-3
         1.5   Backing Up Your System Disk..................    1-4

   2  Installing Compaq BASIC

         2.1   Installation Procedure.......................    2-1
         2.2   Installing the Compaq BASIC Translator
               Run-Time Library.............................   2-12
         2.3   Installing the Compaq BASIC Translator RMS
               Server.......................................   2-12

   3  After Installing Compaq BASIC

         3.1   Running the Installation Verification
               Procedure Separately.........................    3-1
         3.2   Making Compaq BASIC Usable in an OpenVMS
               Cluster Environment..........................    3-2
         3.3   Making the Compaq BASIC Translator Usable in
               an OpenVMS Cluster Environment...............    3-3
         3.4   Setting User Account Requirements............    3-4
         3.4.1     User Account Privileges..................    3-5

                                                                iii

 






           3.5   Reporting Problems to Compaq.................    3-5


     A  Sample Installation

           A.1   Full Development Kit.........................    A-1

     B  Files Installed on Your System

           B.1   Installed Files..............................    B-1

     C  Recovering from Errors

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

     Examples

           A-1       Sample Compaq BASIC Installation.........    A-1

     Tables

           1         Conventions Used in This Guide...........    vii

           1-1       Disk Space Requirements..................    1-4




















     iv

 











        ________________________________________________________________

                                                                 Preface



              This guide describes how to install Compaq BASIC for
              OpenVMS Alpha Systems on Alpha processors that are running
              the OpenVMS operating system.

              Keep this guide with your distribution kit. You will need
              it to install maintenance updates or to reinstall Compaq
              BASIC for any other reason.

        Intended Audience

              This guide is intended for system managers who install
              Compaq BASIC.

        Document Structure

              This guide contains the following chapters and appendixes:

              o  Chapter 1 describes the preparations necessary for
                 installing Compaq BASIC.

              o  Chapter 2 describes how to install Compaq BASIC.

              o  Chapter 3 describes postinstallation tasks.

              o  Appendix A shows a sample Compaq BASIC installation.

              o  Appendix B lists the files installed on your system
                 during the Compaq BASIC installation.

              o  Appendix C describes how to recover from failures and
                 errors that may occur during installation and product
                 use.


                                                                       v

 






     Comments About Compaq BASIC Documentation

           If you have suggestions for improving the documentation or
           if you find errors, please send your comments to us at the
           following Internet address:

           basic_docs@compaq.com

     Associated Documentation

           In addition to this guide, the Compaq BASIC documentation
           set includes the following:

           o  The Compaq BASIC for OpenVMS Alpha and VAX Systems User
              Manual

           o  The Compaq BASIC for OpenVMS Alpha and VAX Systems
              Reference Manual

           o  A letter titled Read Before Installing or Using Compaq
              BASIC Version 1.5 for OpenVMS Alpha Systems

           o  The Compaq BASIC online release notes, which provide
              more information about Compaq BASIC. The release notes
              are located in (n is the minor point release):

              SYS$HELP:BASIC01n.RELEASE_NOTES

           Information about the Compaq BASIC Translator is contained
           in:

           o  The Compaq BASIC Translator User Manual

           o  The Compaq BASIC Translator online release notes,
              which provide more information about the Compaq BASIC
              Translator. The release notes are located in (n is the
              minor point release):

              SYS$HELP:DB2VB01n.RELEASE_NOTES






     vi

 






        Conventions

              Table 1 shows the conventions used in this guide.

              Table_1_Conventions_Used_in_This_Guide____________________

              Convention_______Description______________________________

              $                A dollar sign represents the OpenVMS DCL
                               prompt.

              Ctrl/x           The key combination Ctrl/x indicates that
                               you must press the key labeled Ctrl while
                               you simultaneously press another key, for
                               example, Ctrl/Y or Ctrl/Z.

              UPPERCASE        Uppercase letters indicate the name of a
                               command, a routine, the name of a file,
                               the name of a file protection code, or
                               the abbreviation for a system privilege.

              italic text      Italic text represents parameters,
                               arguments, and information that can vary
                               in system messages (for example, Internal
              _________________error_number),_as_well_as_book_titles.___




















                                                                     vii

 









                                                                       1
        ________________________________________________________________

                                 Preparing for Compaq BASIC Installation



              Your distribution kit includes a letter titled Read Before
              Installing or Using Compaq BASIC Version 1.5 for OpenVMS
              Alpha Systems. This letter discusses important information
              that might not be included in this guide. You should read
              this letter now. You should also read the Compaq BASIC
              Release Notes before continuing with the installation.
              For information about accessing the Release Notes, see
              Chapter 2.

        1.1 Registering Your Software License

              Before you install and run Compaq BASIC Version 1.5 on a
              newly licensed node or an OpenVMS Cluster environment, you
              must first register a License Product Authorization Key
              (License PAK) using the License Management Facility (LMF).
              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 Compaq BASIC as an update
              on a node or cluster already licensed for this software,
              you have already completed the License PAK registration
              requirements.

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

              You must register and load your license for Compaq BASIC
              before you start the installation in order to run the
              Installation Verification Procedure (IVP) and use the
              software.



                             Preparing for Compaq BASIC Installation 1-1

 






           To register a license under the OpenVMS operating system,
           first log in to a privileged 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 License PAK.

           o  At the DCL prompt, enter the LICENSE REGISTER command
              with the appropriate qualifiers that correspond to
              License PAK information.

           If you plan to use Compaq BASIC on more than one node in
           an OpenVMS Cluster environment, you will need to perform
           a license load on the other nodes after you complete this
           installation. See Section 3.2 for more information.

           For complete information about using the LMF, see the
           OpenVMS License Management Utility Manual.

     1.2 Required Hardware

           For a complete list of required hardware and supported
           processors, see the Compaq BASIC Version 1.5 Software
           Product Description (SPD).

     1.3 Required Operating System Components and Software

           Compaq BASIC Version 1.5 for OpenVMS Alpha systems
           requires OpenVMS for Alpha Systems Version 7.1 to 7.3
           (with IEEE floating-point support) or OpenVMS for Alpha
           Systems Version 6.2 to 7.3 (without IEEE floating-point
           support).

           The following optional software can be used with Compaq
           BASIC:

           o  Oracle CDD/Repository

           o  Language-Sensitive Editor

           o  Source Code Analyzer



     1-2 Preparing for Compaq BASIC Installation

 






        1.4 Installation Procedure Requirements

              This section describes the requirements for installing
              Compaq BASIC (process account quotas, system parameters,
              disk space, and so on).

        1.4.1 VMSINSTAL Checks

              VMSINSTAL checks:

              o  If the user is logged in to a privileged account

              o  If any other processes are running on the system

              o  If minimum account quotas are met

        1.4.2 Account Privileges

              To install Compaq BASIC, you must be logged in to an
              account that has SETPRV or at least the following
              privileges:

              o  CMKRNL

              o  WORLD

              o  SYSPRV

              Note that VMSINSTAL turns off BYPASS privilege at the
              start of the installation.

              Privileges required for product use are defined in
              Section 3.4.1.

        1.4.3 Disk Space

              Compaq BASIC requirements for free disk storage space
              are different during installation and after installation.
              The total blocks needed include Help, Starlet, and Motif
              files. Table 1-1 summarizes the storage requirements.





                             Preparing for Compaq BASIC Installation 1-3

 






           Table_1-1_Disk_Space_Requirements_________________________

                            Blocks During         Blocks After
           Kit______________Installation__________Installation_______

           Compaq BASIC     32500                 24500
           Version 1.5

           Compaq BASIC     4400                  4400
           Translator
           Version 1.3

           Compaq BASIC     20000                 20000
           Translator RTL
           Version_1.3_______________________________________________

           To determine the number of free disk blocks on the target
           disk, enter the following command at the DCL prompt:

           $ SHOW DEVICE  device_name

     1.5 Backing Up Your System Disk

           At the beginning of the installation, VMSINSTAL asks if
           you have backed up your system disk. It is recommended
           that you do a system disk backup before installing any
           software.

           Use the backup procedures that are established at your
           site. For details about performing a system disk backup,
           see the section on the Backup utility in the OpenVMS
           System Manager's Manual.













     1-4 Preparing for Compaq BASIC Installation

 









                                                                       2
        ________________________________________________________________

                                                 Installing Compaq BASIC



              After you register and load the license PAK, the
              installation takes approximately 15 minutes, depending on
              your system configuration and the kit components chosen.

              If you encounter any failures during installation, see
              Appendix C.

        2.1 Installation Procedure

              Mount the media.

              To abort the installation procedure at any time, press
              Ctrl/Y. When you press Ctrl/Y, the installation procedure
              deletes all the files it has created up to that point and
              exits. You can then start the installation again.

              When the system prompts you with a question during the
              installation procedure, the default answer is often listed
              in brackets ([]).

              To install Compaq BASIC, perform the following steps:

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

                  Username: SYSTEM
                  Password:

                 $ SET DEFAULT SYS$UPDATE

              2. Invoke VMSINSTAL.

                 $ @VMSINSTAL saveset-name device-name option-list

                 VMSINSTAL is in the SYS$UPDATE directory. The elements
                 that you specify when you invoke the VMSINSTAL command
                 procedure are as follows:

                                             Installing Compaq BASIC 2-1

 






              saveset-name
              The installation name for the component. For Compaq
              BASIC, enter the following installation name (n is the
              minor point release number):

              BASIC01n

              device-name
              The name of the device on which you have mounted the
              media and the directory containing the Compaq BASIC
              save set. For example, DKA300: is the device name
              used in examples in this guide. The directory is
              [BASIC01n.KIT].

              To specify the device name on the @VMSINSTAL command
              line, enter:

              DKA300:[BASIC01n.KIT]

              option-list
              The word OPTIONS followed by one or more of the
              following option designators-A, G, L, N, R:

              o  Auto_answer option (A)

                 Initially creates a file that contains your answers
                 to VMSINSTAL questions and prompts. You can then use
                 the option (and the answer file) to save time during
                 a reinstallation (typically after upgrading your
                 system).

              o  Get save-set option (G)

                 Lets you store product save sets temporarily on a
                 magnetic tape or in a disk directory.

              o  File log option (L)

                 Logs all activity to the terminal during installa-
                 tion.

              o  Display or print the release notes (N)

                 Indicates that you want to see the installation
                 question on release notes. If you do not include
                 the N option, VMSINSTAL does not ask you about
                 the release notes. You should review the release
                 notes before proceeding with the installation in

     2-2 Installing Compaq BASIC

 






                    case they contain additional information about the
                    installation.

                    If you are restarting the installation and have
                    already reviewed the release notes, you do not
                    need to specify the N option. (Even if you omit
                    the N option when you invoke VMSINSTAL, the Compaq
                    BASIC release notes are copied automatically to the
                    SYS$HELP directory.)

                 o  Alternate root option (R)

                    Lets you install the product to a system root other
                    than that of the running system.

                 For detailed information on these software installation
                 options, see the OpenVMS operating system documenta-
                 tion. If you specify more than one option, separate
                 each option with a comma, such as:

                 OPTIONS A,N

                 The following example invokes VMSINSTAL to install
                 Compaq BASIC and shows the system response. This
                 example uses the OPTIONS N release note option.

                 $ @VMSINSTAL BASIC01n DKA300:[BASIC01n.KIT] OPTIONS N

                       OpenVMS AXP Software Product Installation Procedure V6.2

                 It is dd-mmm-yyyy at hh:mm.

                 Enter a question mark (?) at any time for help.

                 If you do not supply the product name, or the device
                 name, VMSINSTAL prompts you for this information later
                 in the installation procedure.

                 When you invoke VMSINSTAL, it checks whether you are
                 logged in to a privileged account. It is recommended
                 that you install software from the system manager's
                 account with your default device and directory set to
                 SYS$UPDATE.

                 VMSINSTAL then checks to determine whether any users
                 are logged in to the system. If users are logged
                 in, VMSINSTAL asks whether you want to continue the
                 installation:

                                             Installing Compaq BASIC 2-3

 






              * Do you want to continue anyway [NO]?

              If you want to continue, enter Y. If you want to stop
              the installation, press Return.

           3. Confirm system backup.

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

              If you are satisfied with the backup of your system
              disk, press Return. Otherwise, enter N to discontinue
              the installation. After you back up your system disk,
              you can restart the installation.

              If you omitted the device name on the VMSINSTAL command
              line, the following prompt appears:

              * Where will the distribution volumes be mounted:

              If this prompt appears, enter the name of the
              distribution (media) device and directory that contains
              the Compaq BASIC kit (save set). For example, if the
              media is contained on a CD-ROM located on unit DKA300:,
              enter DKA300:[BASIC01n.KIT] in reply to this question
              (where n is the minor version number).

              If you omitted the product name on the VMSINSTAL
              command line, the following prompt appears:

              Products:

              Enter the kit name, BASIC01n.

              If you did not choose an installation option at the
              options prompt on the VMSINSTAL command line, the
              following prompt appears and you can enter one of the
              installation options:

              Enter installation options you wish to use (none): N

              Depending on the type of device and whether the device
              is already mounted, the following prompt may appear:

              Please mount the first volume of the set on DKA300:.
              * Are you ready? YES
              %MOUNT-I-MOUNTED, DKA300:  mounted

              If you have not already done so, you should now insert
              the distribution volume on the device you specified
              when you invoked VMSINSTAL. The device name appears in

     2-4 Installing Compaq BASIC

 






                 the line preceding the question. VMSINSTAL then asks if
                 you are ready to continue with the installation.

                 If you respond Y to indicate that you are ready,
                 VMSINSTAL displays a message that the media containing
                 Compaq BASIC has been mounted on the specified device
                 and that the installation has begun.

                 If you entered the wrong device name when you invoked
                 VMSINSTAL and need to restart the installation, enter N
                 in response to the "Are you ready?" question. To stop
                 the installation for other reasons, press Ctrl/Y.

              4. Verify the product being installed.

                  The following products will be processed:

                    BASIC V1.n

                          Beginning installation of BASIC V1.n  at hh:mm

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

                 The product name and version are displayed. The
                 first save set (A) is restored to a subdirectory of
                 SYS$UPDATE.

              5. Select a release notes option.

                     Additional Release Notes Options:

                         1.  Display release notes
                         2.  Print release notes
                         3.  Both 1 and 2
                         4.  None of the above

                 * Select option [2]:

                 If you specified OPTIONS N when you invoked VMSINSTAL
                 or at the options prompt, you are now asked to choose
                 one of the options for reviewing the release notes. All
                 options copy the release notes to SYS$HELP.

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

                                             Installing Compaq BASIC 2-5

 






              If you select option 2, VMSINSTAL prompts you for the
              name of the print queue that you want to use. Either
              supply the name of the print queue that you want to use
              or press Return to send the file to the default output
              print device. For example:

              * Queue name [SYS$PRINT]: CLUSTER_PRINT

              If you select option 3, VMSINSTAL displays the release
              notes immediately on the console terminal and then
              prompts you for a queue name for the printed version.

              If you select option 4, the installation procedure will
              only copy the release notes to the SYS$HELP directory.

              Next, VMSINSTAL asks if you wish to continue the
              installation process.

              * Do you want to continue the installation [NO]?

              If you want to continue, enter Y. If you want to stop
              the installation, press Return. If you are continuing
              the installation, VMSINSTAL displays the following
              message:

     %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.
     %VMSINSTAL-I-RELNOTMOV, A PostScript version of the release notes has been moved
      to SYS$HELP.

                Compaq BASIC V1.n Installation Procedure

       Copyright 2002 Compaq Information Technologies Group, L.P.

              The release notes are copied to the following files in
              the SYS$HELP directory:

              BASIC01n.RELEASE_NOTES
              BASIC01n_RELEASE_NOTES.PS

              After the installation, you can enter the following
              command to view the location of the release notes
              through the Help facility:

              $ HELP BASIC RELEASE_NOTES

           6. Select an installation option.

     2-6 Installing Compaq BASIC

 






                 The installation procedure lets you select the
                 components of the kit that you want to install. The
                 choices are as follows:

           There are six possible installation options. They are as follows:

           1) Perform a complete installation of Compaq BASIC.

           2) Install only OpenVMS Alpha system definitions text library (5-15 minutes).

           3) Install only the Motif bindings and examples for BASIC.

           4) Install only the Compaq BASIC language help library.

           5) Obtain a copy of the Compaq BASIC message text for modification.

           6) Install only the Compaq BASIC Translator.

        * Which option do you want to use [1]:

                 If you specify option 1, which is the default, the
                 installation continues.

                 Select the components you want to install by answering
                 Y or N to the questions. If you want a more detailed
                 description of any component, enter a question mark
                 (?). After the explanation is displayed, you are
                 prompted again for a response.

                 If you enter Y, the installation procedure installs the
                 component.

              7. Install OpenVMS Alpha system definitions.

                 * Do you want to install the OpenVMS Alpha system definitions [NO]?

                 This option generates a text library (SYS$LIBRARY:BASIC$STARLET.TLB)
                 that contains OpenVMS Alpha system definitions.
                 Depending on your processor and system load, creating
                 this library takes approximately 5 to 15 minutes. The
                 OpenVMS Alpha system definitions require 5000 blocks of
                 disk space.

              8. Install Motif definitions.

                 * Do you want to install the Motif definitions [YES]?

                                             Installing Compaq BASIC 2-7

 






              Answering YES to this option puts the Compaq BASIC
              version of the Motif definitions, DECW$MOTIF.BAS,
              into the SYS$LIBRARY directory. These definitions
              require 1500 blocks of disk space and contain the
              Constant, Record, and External declarations needed
              to do Motif programming. Examples are also put into the
              DECW$EXAMPLES area provided it exists. Note that if the
              DECW$EXAMPLES area does not exist, the default for this
              question is NO, and the examples are not provided.

           9. Install BASIC Help files.

              * Do you want to install the Compaq BASIC language HELP library [YES]?

              The Help files describe how to invoke Compaq BASIC from
              the DCL command line and the BASIC language features.
              The Help files require 430 blocks of disk space. It is
              recommended that you install these files.

           10.Obtain the BASIC message file.

              * Do you want to copy the Compaq BASIC message file [NO]?

              The BASIC message source file contains the text of the
              Compaq BASIC messages that may be copied for customiza-
              tion purposes. It is placed in SYS$UPDATE:BASIC$MSG.MSG.
              The message file requires 85 blocks of disk space.
              Normally you do not need to copy this file.

           11.Install the Compaq BASIC Translator.

              * Do you want to install the Compaq BASIC Translator [NO]?

              The Compaq BASIC Translator assists in translating
              Compaq BASIC source programs into Visual BASIC
              programs. Further information about the Translator
              is provided in separate Compaq BASIC Translator Release
              Notes. The Translator requires 4400 blocks of disk
              space.

              If you elect to install the Compaq BASIC Translator,
              the following question is asked.

              * Do you want a copy of the Compaq BASIC Translator RTL [NO]?

     2-8 Installing Compaq BASIC

 






                 Answering YES to this option puts a copy of the Compaq
                 BASIC Translator RTL file, DB2VB$DBTRTL_I.ZIP, into
                 the SYS$LIBRARY directory. This file must be copied
                 to and installed on the target Windows system (See
                 Section 2.2). The file is also available from the
                 Internet at http://www.openvms.compaq.com/commercial/basic/db2vb_index.html.
                 The Internet is the recommended source for this file.
                 Because DB2VB$DBTRTL_I.ZIP is quite large, 20000
                 blocks, and is not used on the OpenVMS system, direct
                 downloading from the Internet to the Windows system is
                 simpler.

              12.Purge files.

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

                 The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE,
                 SYS$SYSTEM, SYS$TEST, and SYS$EXAMPLES may contain
                 previous versions of Compaq BASIC files. These files
                 are replaced with new files during the installation,
                 but the previous files are not automatically purged.
                 Purging is recommended. In response to the purging
                 prompt, press Return or enter Y to purge the files, or
                 enter N to keep them.

              13.Respond to license registration queries.

                 Compaq BASIC supports the OpenVMS License Management
                 Facility (LMF). The installation procedure displays
                 license information about Compaq BASIC. It asks
                 whether you have registered and loaded your Product
                 Authorization Key (PAK) for each product. The following
                 is an example of the information and the queries
                 presented by the installation procedure:

                       Product:      BASIC
                       Producer:     DEC
                       Version:      1.n
                       Release Date: dd-mmm-yyyy

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




                                             Installing Compaq BASIC 2-9

 






              If you have not registered and loaded your PAK,
              you must answer NO to this question. You have to
              register and load a PAK to successfully complete the
              installation (see Section 1.1). If you have not done
              so, you should stop the installation, register and load
              your PAK, and then restart the installation.

           14.Read informational messages.

              At this point, the installation procedure displays a
              number of informational messages that report on the
              progress of the installation. There are no further
              questions. If the installation procedure has been
              successful up to this point, VMSINSTAL moves the new
              or modified files to their target directories, updates
              help files, and updates DCL tables, if necessary.

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

              The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE
              files are updated to include the new versions of the
              Compaq BASIC help text and the BASIC command-line
              definition.

              Also, if you answered Y in response to the prompt that
              requests a file purge, previous versions of the Compaq
              BASIC files are now purged.

           15.Observe the IVP.

              VMSINSTAL now places the IVP files into the directory
              SYS$TEST and invokes the IVP to verify that Compaq
              BASIC and/or the Compaq BASIC Translator were installed
              successfully.

              You can also run the IVPs independently, after Compaq
              BASIC and/or the Compaq BASIC Translator are installed,
              to verify that the software is available on your
              system. You might need to run the IVPs after a system
              failure to make sure that users can access Compaq BASIC
              and/or the Compaq BASIC Translator. You can do this by
              invoking either of the following command procedures:

              $ @SYS$TEST:BASIC$IVP.COM

              or

              $ @SYS$TEST:DB2VB$IVP.COM

     2-10 Installing Compaq BASIC

 






                 If Compaq BASIC was installed successfully, the IVP
                 displays the following:

                 %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC V1.n Installation test PASSED

                 The Compaq BASIC V1.n IVP has succeeded!

                 If the Compaq BASIC Translator was installed success-
                 fully, the IVP displays the following:

                 %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC Translator V1.n Installation test PASSED

                 The Compaq BASIC Translator V1.n IVP has succeeded!

              16.End the installation procedure.

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

                         Installation of BASIC V1.n completed at hh:mm

                     Adding history entry in VMI$ROOT:{SYSUPD]VMSINSTAL.HISTORY

                     Creating installation data file: VMI$ROOT:[SYSUPD]BASIC01n.VMI_DATA

                         VMSINSTAL procedure done at hh:mm

                 Depending on whether you specified parameters on the
                 VMSINSTAL command line, the * Products: prompt or
                 the DCL prompt ($) may appear. If the * Products:
                 prompt appears, you can return to the DCL prompt ($)
                 by pressing Ctrl/Z.

                 VMSINSTAL deletes or changes entries in the process
                 symbol tables during the installation. Therefore,
                 if you are going to continue using the installation
                 account (such as SYSTEM) and you want to restore these
                 symbols, you should log out and log in again.







                                            Installing Compaq BASIC 2-11

 






     2.2 Installing the Compaq BASIC Translator Run-Time Library

           The Run-Time Library for the Compaq BASIC Translator
           is available as a .ZIP file named DBTRTL_I.ZIP from the
           Internet (URL http://www.openvms.compaq.com/commercial/basic/db2vb_index.html),
           or in SYS$LIBRARY:DB2VB$DBTRTL_I.ZIP if you chose to copy
           it from the compiler kit. The Run-Time Library must be
           installed on every Windows system that runs translated
           applications. Follow these steps to install the Run-Time
           Library:

           1. Create an empty folder. The installation requires
              approximately six megabytes of disk space (four
              megabytes on the device where it is unpacked and two
              megabytes on the system device).

           2. Make a copy of the Run-Time Library .ZIP file available
              either on some removable media or via a network
              connection.

           3. Copy DBTRTL_I.ZIP or DB2VB$DBTRTL_I.ZIP as applicable
              to the empty folder (rename DB2VB$DBTRTL_I.ZIP to
              DBTRTL_I.ZIP).

           4. Unpack the .ZIP file using an Unzip utility.

           5. Run SETUP.EXE and follow the instructions.

     2.3 Installing the Compaq BASIC Translator RMS Server

           Two images are required to provide the server side of the
           RMS support provided by the Compaq BASIC Translator RTL.
           These are:

           o  DB2VB$SPAWNER.EXE

           o  DB2VB$RMS_SERVER.EXE

           They have been placed in SYS$SYSTEM by the installation
           procedure. Also placed in SYS$SYSTEM during installation
           of the Compaq BASIC Translator are two sets of correspond-
           ing images, one for the VAX platform and one for the Alpha
           platform. They are named as follows:


     2-12 Installing Compaq BASIC

 





              __________________________________________________________
              VAX________________________ALPHA__________________________

              DB2VB$SPAWNER.EXE_VAX      DB2VB$SPAWNER.EXE_ALPHA

              DB2VB$RMS_SERVER.EXE_VAX___DB2VB$RMS_SERVER.EXE_ALPHA_____

              To access RMS files from a translated application, the
              appropriate pair of server images must be copied and
              renamed to the server platform. For example, if the
              server platform is an Alpha machine, then the files
              DB2VB$SPAWNER.EXE_ALPHA and DB2VB$RMS_SERVER.EXE_ALPHA
              must be copied to the Alpha platform and renamed to have
              the .EXE file type, as follows:

        $ COPY SYS$SYSTEM:DB2VB$SPAWNER.EXE_ALPHA alpha_node::SYS$SYSTEM:DB2VB$SPAWNER.EXE
        $ COPY SYS$SYSTEM:DB2VB$RMS_SERVER.EXE_ALPHA alpha_node::SYS$SYSTEM:DB2VB$RMS_SERVER.EXE





























                                            Installing Compaq BASIC 2-13

 









                                                                       3
        ________________________________________________________________

                                           After Installing Compaq BASIC



              After Compaq BASIC is installed, it can be invoked by all
              users with the BASIC command.

              The installation procedure modifies the DCL command table
              so that the BASIC command is recognized and processed.
              However, the previous command table is still in effect
              for those users who are currently logged in. All logged-in
              users who want to use the BASIC command must log out and
              log in again, or use the following DCL command:

              $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES

              You can perform the following tasks after Compaq BASIC is
              installed:

              o  Running the Installation Verification Procedure (IVP)
                 separately

              o  Making the product usable in an OpenVMS Cluster
                 environment

        3.1 Running the Installation Verification Procedure Separately

              You usually run the Installation Verification Procedure
              (IVP) during installation. If you have system problems and
              want to run the IVP separately to ensure the integrity of
              installed files, use the following command:

              $ @SYS$TEST:BASIC$IVP.COM

              or

              $ @SYS$TEST:DB2VB$IVP.COM

              as appropriate.

                                       After Installing Compaq BASIC 3-1

 






     3.2 Making Compaq BASIC Usable in an OpenVMS Cluster
         Environment

           If you want to run Compaq BASIC on multiple nodes of an
           OpenVMS Cluster environment, first check to see that you
           have the appropriate software license (see Section 1.1).
           Then, perform the following steps after you install Compaq
           BASIC:

           1. Enter the LICENSE LOAD command to activate the license
              on each node on which Compaq BASIC is to be executed.

           2. Use the OpenVMS System Management (SYSMAN) utility to
              execute a set of commands on all cluster nodes, whether
              or not the nodes are licensed to use Compaq BASIC.
              Failure to do so may cause unexpected errors for users.

              ________________________Note ________________________

              If you are using a dual-architecture (VAX and Alpha
              systems), heterogeneous cluster, before executing
              these commands, make sure the appropriate logical
              names have been set to define the scope of the
              SYSMAN DO commands. For more information, see the
              OpenVMS system management documentation.

              _____________________________________________________

              While logged in as SYSTEM or as another user name
              that has the SETPRV privilege or the CMKRNL and
              SYSPRV privileges, use SYSMAN to update the version
              of DCLTABLES.EXE available, as follows:

              $ RUN SYS$SYSTEM:SYSMAN
              SYSMAN> SET ENVIRONMENT/CLUSTER
              %SYSMAN-I-ENV, current command environment:
                      Clusterwide on local cluster
                      Username SYSTEM       will be used on nonlocal nodes
              SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE
              %SYSMAN-I-OUTPUT, command execution on node NODE1
              %SYSMAN-I-OUTPUT, command execution on node NODE2

              SYSMAN will cause each DO command to be executed on all
              nodes of the local cluster.

     3-2 After Installing Compaq BASIC

 






              3. If Compaq BASIC is installed as a known image, then do
                 the following:

                 SYSMAN> DO INSTALL REPLACE SYS$SYSTEM:BASIC.EXE
                 %SYSMAN-I-OUTPUT, command execution on node NODE1
                 %SYSMAN-I-OUTPUT, command execution on node NODE2

              4. If the Compaq BASIC message file is installed as a
                 known image, then do the following:

                 SYSMAN> DO INSTALL REPLACE SYS$MESSAGE:BASIC$MSG.EXE
                 %SYSMAN-I-OUTPUT, command execution on node NODE1
                 %SYSMAN-I-OUTPUT, command execution on node NODE2

              5. Finally, exit from SYSMAN:

                 SYSMAN> EXIT
                 $

        3.3 Making the Compaq BASIC Translator Usable in an OpenVMS
            Cluster Environment

              If you want to run the Compaq BASIC Translator on multiple
              nodes of an OpenVMS Cluster environment, first check to
              see that you have the appropriate software license (see
              Section 1.1). The Compaq BASIC Translator uses the same
              license as Compaq BASIC. Then, perform the following steps
              after you install the Compaq BASIC Translator:

              1. Enter the LICENSE LOAD command to activate the license
                 on each node on which the Compaq BASIC Translator is to
                 be executed.

              2. Use the OpenVMS System Management utility (SYSMAN)
                 to execute a set of commands on all cluster nodes,
                 whether or not the nodes are licensed to use the Compaq
                 BASIC Translator. Failure to do so may cause unexpected
                 errors for users.

                ________________________Note  ________________________

                If you are using a mixed-architecture (VAX and Alpha
                systems), heterogeneous cluster, before executing
                these commands, make sure the appropriate logical
                names have been set to define the scope of the

                                       After Installing Compaq BASIC 3-3

 






              SYSMAN DO commands. For more information, see the
              OpenVMS system management documentation.

              _____________________________________________________

              While logged in as SYSTEM or as another user name
              that has the SETPRV privilege or the CMKRNL and
              SYSPRV privileges, use SYSMAN to update the version
              of DCLTABLES.EXE available as follows:

              $ RUN SYS$SYSTEM:SYSMAN
              SYSMAN> SET ENVIRONMENT/CLUSTER
              %SYSMAN-I-ENV, current command environment:
                      Clusterwide on local cluster
                      Username SYSTEM       will be used on nonlocal nodes
              SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE
              %SYSMAN-I-OUTPUT, command execution on node NODE1
              %SYSMAN-I-OUTPUT, command execution on node NODE2

              SYSMAN will cause each DO command to be executed on all
              nodes of the local cluster.

           3. If the Compaq BASIC Translator is installed as a known
              image, then enter the following:

              SYSMAN> DO INSTALL REPLACE SYS$SYSTEM:DB2VB.EXE
              %SYSMAN-I-OUTPUT, command execution on node NODE1
              %SYSMAN-I-OUTPUT, command execution on node NODE2

           4. If the Compaq BASIC Translator message file is
              installed as a known image, then enter the following:

              SYSMAN> DO INSTALL REPLACE SYS$MESSAGE:DB2VB$MSG.EXE
              %SYSMAN-I-OUTPUT, command execution on node NODE1
              %SYSMAN-I-OUTPUT, command execution on node NODE2

           5. Finally, exit from SYSMAN:

              SYSMAN> EXIT
              $

     3.4 Setting User Account Requirements

           To work with Compaq BASIC or the Compaq BASIC Translator,
           user accounts on your system must have certain privileges.

     3-4 After Installing Compaq BASIC

 






        3.4.1 User Account Privileges

              To use Compaq BASIC or the Compaq BASIC Translator,
              each account must have at least the TMPMBX and NETMBX
              privileges. Use the OpenVMS Authorize utility to determine
              whether users have the privileges they require.

        3.5 Reporting Problems to Compaq

              If you encounter a problem while using Compaq BASIC or
              Compaq BASIC Translator, and your software contract or
              warranty agreement entitles you to telephone support, call
              Compaq.

              Review the Software Product Description (SPD) and Warranty
              Addendum for an explanation of warranty. If you encounter
              a problem during the warranty period, report the problem
              as previously indicated or follow alternate instructions
              provided by Compaq for reporting SPD nonconformance
              problems.

























                                       After Installing Compaq BASIC 3-5

 









                                                                       A
        ________________________________________________________________

                                                     Sample Installation



              This appendix provides a sample listing for the Compaq
              BASIC full development kit.



        A.1 Full Development Kit

              Example A-1 is a sample installation for the Compaq BASIC
              full development kit.

              This installation was performed on an OpenVMS Alpha
              Version V7.2 system that had no previous version of Compaq
              BASIC installed. Depending on which layered products you
              have on your system, you might see additional messages and
              questions when you perform your installation.

              This installation assumes that DECnet has been shut down
              and that OPTIONS N is specified to print the release
              notes.

        Example A-1 Sample Compaq BASIC Installation

         Welcome to OpenVMS Alpha Operating System, Version V7.2

        Username: SYSTEM
        Password:

            Last interactive login on Monday, dd-mmm-yyyy hh:mm:ss
            Last non-interactive login on Wednesday, dd-mmm-yyyy hh:mm:ss

        $ SET DEF SYS$UPDATE
        $ @SYS$UPDATE:VMSINSTAL BASIC015 MKA500: OPTIONS N

                OpenVMS AXP Software Product Installation Procedure V7.2

                                                (continued on next page)

                                                 Sample Installation A-1

 






     Example A-1 (Cont.) Sample Compaq BASIC Installation

     It is dd-MMM-yyyy at hh:mm.

     Enter a question mark (?) at any time for help.

     %VMSINSTAL-W-ACTIVE, The following processes are still active:
            APLTOO
     * Do you want to continue anyway [NO]? y
     * Are you satisfied with the backup of your system disk [YES]?

     The following products will be processed:

       BASIC V1.5

             Beginning installation of BASIC V1.5 at hh:mm

     %VMSINSTAL-I-RESTORE, Restoring product save set A ...

         Release notes included with this kit are always copied to SYS$HELP.

         Additional Release Notes Options:

             1.  Display release notes
             2.  Print release notes
             3.  Both 1 and 2
             4.  None of the above

     * Select option [2]: 4

     * Do you want to continue the installation [NO]? y
     %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.
     %VMSINSTAL-I-RELNOTMOV, A PostScript version of the release notes has been moved
      to SYS$HELP.

               Compaq BASIC V1.5 Installation Procedure

        Copyright 2002 Compaq Information Technologies Group, L.P.

        Compaq and the Compaq logo are trademarks of Compaq Information
        Technologies Group, L.P. in the U.S. and/or other countries.

                                             (continued on next page)


     A-2 Sample Installation

 






        Example A-1 (Cont.) Sample Compaq BASIC Installation

           Confidential computer software.  Valid license from Compaq required for
           possession, use or copying.  Consistent with FAR 12.211 and 12.212,
           Commercial Computer Software, Computer Software Documentation, and
           Technical Data for Commercial Items are licensed to the U.S. Government
           under vendor's standard commercial license.


           There are six possible installation options. They are as follows:

           1) Perform a complete installation of Compaq BASIC.

           2) Install only OpenVMS Alpha system definitions text library (5-15 minutes).

           3) Install only the Motif bindings and examples for BASIC.

           4) Install only the Compaq BASIC language help library.

           5) Obtain a copy of the Compaq BASIC message text for modification.

           6) Install only the Compaq BASIC Translator.

        * Which option do you want to use [1]:

        * Do you want to install the OpenVMS Alpha system definitions [NO]? y
        * Do you want to install the Motif definitions [YES]?
        * Do you want to install the Compaq BASIC language HELP library [YES]?
        * Do you want to copy the Compaq BASIC message file [NO]? y
        * Do you want to install the Compaq BASIC Translator [NO]? y
        * Do you want a copy of the Compaq BASIC Translator RTL [NO]? y

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

                Product:      BASIC
                Producer:     DEC
                Version:      1.5
                Release Date: dd-mmm-yyyy

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

           No further questions will be asked.  The installation will take
           5 - 15 more minutes depending upon options chosen, configuration,
           and system activity.

                                                (continued on next page)

                                                 Sample Installation A-3

 






     Example A-1 (Cont.) Sample Compaq BASIC Installation

     %VMSINSTAL-I-RESTORE, Restoring product save set B ...
     %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSTE
     ST.BASIC].
     %VMSINSTAL-I-INSHELP, Installing Compaq BASIC environment emulator
     %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSHL
     P.EXAMPLES.BASIC].
     %VMSINSTAL-I-RESTORE, Restoring product save set D ...
     %VMSINSTAL-I-INSSTARLET, Installing Compaq BASIC system definitions
     %VMSINSTAL-I-INSSTARLET, requires approximately 15 minutes
     %VMSINSTAL-I-RESTORE, Restoring product save set E ...
     %VMSINSTAL-I-INSMOTIG, Installing Motif definitions and examples
     %VMSINSTAL-I-RESTORE, Restoring product save set F ...
     %VMSINSTAL-I-INSHELP, Installing Compaq BASIC language Help file
     %VMSINSTAL-I-RESTORE, Restoring product save set G ...
     %VMSINSTAL-I-MSGLOC, BASIC$MSG.MSG will be placed in [SYSUPD]
     %VMSINSTAL-I-RELNOTMOV, Text and PostScript versions of the Compaq BASIC Transla
     tor release notes have been moved to SYS$HELP.
     %VMSINSTAL-I-RESTORE, Restoring product save set H ...
     %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSTE
     ST.DB2VB].
     %VMSINSTAL-I-RESTORE, Restoring product save set I ...
     %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

       Copyright 2002 Compaq Information Technologies Group, L.P.

       Compaq and the Compaq logo are trademarks of Compaq Information
       Technologies Group, L.P. in the U.S. and/or other countries.

       Confidential computer software.  Valid license from Compaq required for
       possession, use or copying.  Consistent with FAR 12.211 and 12.212,
       Commercial Computer Software, Computer Software Documentation, and
       Technical Data for Commercial Items are licensed to the U.S. Government
       under vendor's standard commercial license.

     %VMSINSTAL-I-DOIVP, Executing the Compaq BASIC V1.5 Installation Verification Pr
     ocedure

     %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC V1.5 Installation test PASSED

     The Compaq BASIC V1.5 IVP has succeeded!

                                             (continued on next page)

     A-4 Sample Installation

 






        Example A-1 (Cont.) Sample Compaq BASIC Installation


          Copyright 2002 Compaq Information Technologies Group, L.P.

          Compaq and the Compaq logo are trademarks of Compaq Information
          Technologies Group, L.P. in the U.S. and/or other countries.

          Confidential computer software.  Valid license from Compaq required for
          possession, use or copying.  Consistent with FAR 12.211 and 12.212,
          Commercial Computer Software, Computer Software Documentation, and
          Technical Data for Commercial Items are licensed to the U.S. Government
          under vendor's standard commercial license.

        %VMSINSTAL-I-DOIVP, Executing the Compaq BASIC Translator V1.3 Installation Veri
        fication Procedure

        %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC Translator V1.3 Installation test PASSED

        The Compaq BASIC Translator V1.3 IVP has succeeded!

                Installation of BASIC V1.5 completed at hh:mm

            Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY

            Creating installation data file: VMI$ROOT:[SYSUPD]BASIC015.VMI_DATA

                VMSINSTAL procedure done at hh:mm

        $















                                                 Sample Installation A-5

 









                                                                       B
        ________________________________________________________________

                                          Files Installed on Your System



        B.1 Installed Files

              The Compaq BASIC installation procedure installs a
              number of files on your system and defines some logical
              names. The first list shows the files installed during
              installation. The second list shows the files modified by
              the installation. Note this list assumes that all options
              were selected.

              Files Provided by the Installation

                 SYS$COMMON:[SYSEXE]BASIC.EXE
                 SYS$COMMON:[SYSEXE]DB2VB.EXE
                 SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE
                 SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE_ALPHA
                 SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE_VAX
                 SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXE
                 SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXE_ALPHA
                 SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXE_VAX
                 SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]BASIC$ENV.TPU
                 SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$HELLOMOTIF.BAS
                 SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$HELLOMOTIF.UIL
                 SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER.BAS
                 SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER.UIL
                 SYS$COMMON:[SYSHLP.EXAMPLES.DECW]
                    BASIC$MOTIFBURGER_DEFS.BAS
                 SYS$COMMON:[SYSHLP]BASIC015.RELEASE_NOTES
                 SYS$COMMON:[SYSHLP]BASIC015_RELEASE_NOTES.PS
                 SYS$COMMON:[SYSHLP]DB2VB013.RELEASE_NOTES
                 SYS$COMMON:[SYSHLP]DB2VB013_RELEASE_NOTES.PS
                 SYS$COMMON:[SYSHLP]BASICHELP.HLB
                 SYS$COMMON:[SYSLIB]DEC$BASRTL.EXE
                 SYS$COMMON:[SYSLIB]BASIC$STARLET.TLB
                 SYS$COMMON:[SYSLIB]DECW$MOTIF.BAS
                 SYS$COMMON:[SYSLIB]DECW$MOTIF_DEFS.BAS

                                      Files Installed on Your System B-1

 






              SYS$COMMON:[SYSLIB]DB2VB$LIBRARY.TLB
              SYS$COMMON:[SYSLIB]DB2VB$DBTRTL_I.ZIP
              SYS$COMMON:[SYSMSG]BASIC$MSG.EXE
              SYS$COMMON:[SYSMSG]DB2VB$MSG.EXE
              SYS$COMMON:[SYSTEST]BASIC$IVP.COM
              SYS$COMMON:[SYSTEST.BASIC]BASIC$IVP.BAS
              SYS$COMMON:[SYSTEST]DB2VB$IVP.COM
              SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.BAS
              SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.BMK
              SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.EXE
              SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.VBP_BMK
              SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.VPD_BMK
              SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP_GBLS.BMK
              SYS$COMMON:[SYSUPD]BASIC$MSG.MSG

           Files Modified by the Installation

              SYS$COMMON:[SYSHLP]HELPLIB.HLB
              SYS$COMMON:[SYSLIB]DCLTABLES.EXE
              SYS$COMMON:[SYSLIB]IMAGELIB.OLB

























     B-2 Files Installed on Your System

 









                                                                       C
        ________________________________________________________________

                                                  Recovering from Errors



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

        C.1 Failures During Product Installation

              If VMSINSTAL detects any problems during the installation,
              it notifies you and asks if you want to continue the
              installation. In some instances, you can enter Y to
              continue. To stop the installation process and correct
              the situation, enter N or press Return. Then correct the
              problem and restart the installation.

              If errors occur during the installation itself or when
              the Installation Verification Procedure (IVP) is running,
              VMSINSTAL displays failure messages. If the installation
              fails, you see the following message:

              %VMSINSTAL-E-INSFAIL, The installation of Compaq BASIC Version 1.5 has failed.

              If an IVP fails, you see messages like these:

              The Compaq BASIC Version 1.5 IVP has failed!

              %VMSINSTAL-E-IVPFAIL, Compaq BASIC Version 1.5 Installation test FAILED.

              Errors can occur during the installation if any of the
              following conditions exist:

              o  The operating system version is incorrect.

              o  A prerequisite software version is incorrect.

              o  Quotas necessary for successful installation are
                 insufficient.

              o  System parameter values for successful installation are
                 insufficient.

              o  The OpenVMS help library is currently in use.

                                              Recovering from Errors C-1

 






           o  The product license has not been registered and loaded.

           For descriptions of the error messages generated by these
           conditions, see the OpenVMS documentation on system
           messages, recovery procedures, and OpenVMS software
           installation. If you are notified that any of these
           conditions exist, you should take the appropriate action
           as described in the message.

           For information about installation requirements, see
           Chapter 1.

     C.2 Failures During Product Use

           If you encounter a problem while using Compaq BASIC or
           Compaq BASIC Translator, and your software contract or
           warranty agreement entitles you to telephone support, call
           Compaq.

           Review the Software Product Description (SPD) and Warranty
           Addendum for an explanation of warranty. If you encounter
           a problem during the warranty period, report the problem
           as previously indicated or follow alternate instructions
           provided by Compaq for reporting SPD nonconformance
           problems.




















     C-2 Recovering from Errors
