                           C                      Compaq_BASIC_for_OpenVMS_Alpha_Systems________ '                      Installation Guide   .                      Order Number: AA-Q29SD-TE                          April 2002   E                      This guide describes how to install Compaq BASIC D                      on an Alpha processor running the OpenVMS Alpha&                      operating system.          G                      Revision/Update Information: This guide supersedes F                                                   the Compaq BASIC forG                                                   OpenVMS Alpha Systems E                                                   Installation Guide, >                                                   Version 1.4.  C                      Operating System & Version:  OpenVMS for Alpha A                                                   Systems Version B                                                   7.1 to 7.3 (with@                                                   IEEE floating-C                                                   point support) or C                                                   OpenVMS for Alpha A                                                   Systems Version E                                                   6.2 to 7.3 (without E                                                   IEEE floating-point :                                                   support)  F                      Software Version:            Compaq BASIC VersionG                                                   1.5 for OpenVMS Alpha 9                                                   Systems   0                      Compaq Computer Corporation#                      Houston, Texas                  E            __________________________________________________________             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 B            Information Technologies Group, L.P. in the U.S. and/or            other countries.   D            Motif is a trademark of The Open Group in the U.S. and/or            other countries.   E            All other product names mentioned herein may be trademarks )            of their respective companies.   D            Confidential computer software. Valid license from CompaqC            required for possession, use or copying. Consistent with ?            FAR 12.211 and 12.212, Commercial Computer Software, B            Computer Software Documentation, and Technical Data forE            Commercial Items are licensed to the U.S. Government under 0            vendor's standard commercial license.  @            Compaq shall not be liable for technical or editorial@            errors or omissions contained herein. The informationB            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 B            warranty statements accompanying such products. NothingC            herein should be construed as constituting an additional             warranty.  0            This document is available on CD-ROM.  E            This document was prepared using VAX DOCUMENT Version 2.1.                                C    ________________________________________________________________   C                                                            Contents     C    Preface..................................................      v     -    1  Preparing for Compaq BASIC Installation   C          1.1   Registering Your Software License ...........    1-1 C          1.2   Required Hardware............................    1-2 7          1.3   Required Operating System Components and C                Software.....................................    1-2 C          1.4   Installation Procedure Requirements..........    1-3 C          1.4.1     VMSINSTAL Checks.........................    1-3 C          1.4.2     Account Privileges.......................    1-3 C          1.4.3     Disk Space...............................    1-3 C          1.5   Backing Up Your System Disk..................    1-4       2  Installing Compaq BASIC   C          2.1   Installation Procedure.......................    2-1 5          2.2   Installing the Compaq BASIC Translator C                Run-Time Library.............................   2-12 9          2.3   Installing the Compaq BASIC Translator RMS C                Server.......................................   2-12   #    3  After Installing Compaq BASIC   4          3.1   Running the Installation VerificationC                Procedure Separately.........................    3-1 7          3.2   Making Compaq BASIC Usable in an OpenVMS C                Cluster Environment..........................    3-2 ;          3.3   Making the Compaq BASIC Translator Usable in C                an OpenVMS Cluster Environment...............    3-3 C          3.4   Setting User Account Requirements............    3-4 C          3.4.1     User Account Privileges..................    3-5   C                                                                 iii                  E            3.5   Reporting Problems to Compaq.................    3-5           A  Sample Installation   E            A.1   Full Development Kit.........................    A-1   &      B  Files Installed on Your System  E            B.1   Installed Files..............................    B-1         C  Recovering from Errors  E            C.1   Failures During Product Installation.........    C-1 E            C.2   Failures During Product Use..................    C-2   
      Examples   E            A-1       Sample Compaq BASIC Installation.........    A-1         Tables   E            1         Conventions Used in This Guide...........    vii   E            1-1       Disk Space Requirements..................    1-4                                               iv                            H         ________________________________________________________________  H                                                                  Preface      B               This guide describes how to install Compaq BASIC forH               OpenVMS Alpha Systems on Alpha processors that are running+               the OpenVMS operating system.   G               Keep this guide with your distribution kit. You will need F               it to install maintenance updates or to reinstall Compaq)               BASIC for any other reason.            Intended Audience   D               This guide is intended for system managers who install               Compaq BASIC.            Document Structure  H               This guide contains the following chapters and appendixes:  C               o  Chapter 1 describes the preparations necessary for )                  installing Compaq BASIC.   A               o  Chapter 2 describes how to install Compaq BASIC.   <               o  Chapter 3 describes postinstallation tasks.  E               o  Appendix A shows a sample Compaq BASIC installation.   D               o  Appendix B lists the files installed on your system6                  during the Compaq BASIC installation.  F               o  Appendix C describes how to recover from failures andF                  errors that may occur during installation and product                  use.     H                                                                        v                 .      Comments About Compaq BASIC Documentation  E            If you have suggestions for improving the documentation or E            if you find errors, please send your comments to us at the &            following Internet address:               basic_docs@compaq.com        Associated Documentation   D            In addition to this guide, the Compaq BASIC documentation&            set includes the following:  E            o  The Compaq BASIC for OpenVMS Alpha and VAX Systems User                Manual  @            o  The Compaq BASIC for OpenVMS Alpha and VAX Systems               Reference Manual  D            o  A letter titled Read Before Installing or Using Compaq9               BASIC Version 1.5 for OpenVMS Alpha Systems   B            o  The Compaq BASIC online release notes, which provideD               more information about Compaq BASIC. The release notes<               are located in (n is the minor point release):  -               SYS$HELP:BASIC01n.RELEASE_NOTES   E            Information about the Compaq BASIC Translator is contained             in:  5            o  The Compaq BASIC Translator User Manual   ?            o  The Compaq BASIC Translator online release notes, C               which provide more information about the Compaq BASIC D               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.   H               Table_1_Conventions_Used_in_This_Guide____________________  H               Convention_______Description______________________________  G               $                A dollar sign represents the OpenVMS DCL &                                prompt.  H               Ctrl/x           The key combination Ctrl/x indicates thatH                                you must press the key labeled Ctrl whileH                                you simultaneously press another key, for9                                example, Ctrl/Y or Ctrl/Z.   G               UPPERCASE        Uppercase letters indicate the name of a F                                command, a routine, the name of a file,E                                the name of a file protection code, or G                                the abbreviation for a system privilege.   A               italic text      Italic text represents parameters, G                                arguments, and information that can vary H                                in system messages (for example, InternalH               _________________error_number),_as_well_as_book_titles.___                                        H                                                                      vii                       H                                                                        1H         ________________________________________________________________  H                                  Preparing for Compaq BASIC Installation      H               Your distribution kit includes a letter titled Read BeforeF               Installing or Using Compaq BASIC Version 1.5 for OpenVMSH               Alpha Systems. This letter discusses important informationG               that might not be included in this guide. You should read D               this letter now. You should also read the Compaq BASICD               Release Notes before continuing with the installation.D               For information about accessing the Release Notes, see               Chapter 2.  -         1.1 Registering Your Software License   F               Before you install and run Compaq BASIC Version 1.5 on aH               newly licensed node or an OpenVMS Cluster environment, youE               must first register a License Product Authorization Key H               (License PAK) using the License Management Facility (LMF).F               The License PAK may be shipped along with the kit if youF               ordered the license and media together. Otherwise, it isD               shipped separately to a location based on your licenseD               order. If you are installing Compaq BASIC as an updateF               on a node or cluster already licensed for this software,E               you have already completed the License PAK registration                requirements.   E               If you are installing prerequisite or optional software H               along with Compaq BASIC, review the PAK status and installG               the PAKs for any prerequisite or optional software before '               you install Compaq BASIC.   F               You must register and load your license for Compaq BASICC               before you start the installation in order to run the C               Installation Verification Procedure (IVP) and use the                software.       H                              Preparing for Compaq BASIC Installation 1-1                 D            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:  B            o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. WhenD               it prompts you for information, respond with data from               your License PAK.   C            o  At the DCL prompt, enter the LICENSE REGISTER command @               with the appropriate qualifiers that correspond to&               License PAK information.  C            If you plan to use Compaq BASIC on more than one node in C            an OpenVMS Cluster environment, you will need to perform D            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 the5            OpenVMS License Management Utility Manual.         1.2 Required Hardware  A            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.3B            (with IEEE floating-point support) or OpenVMS for AlphaB            Systems Version 6.2 to 7.3 (without IEEE floating-point            support).  B            The following optional software can be used with Compaq            BASIC:   #            o  Oracle CDD/Repository   '            o  Language-Sensitive Editor   "            o  Source Code Analyzer      0      1-2 Preparing for Compaq BASIC Installation                 /         1.4 Installation Procedure Requirements   D               This section describes the requirements for installingF               Compaq BASIC (process account quotas, system parameters,%               disk space, and so on).            1.4.1 VMSINSTAL Checks                 VMSINSTAL checks:   A               o  If the user is logged in to a privileged account   A               o  If any other processes are running on the system   2               o  If minimum account quotas are met            1.4.2 Account Privileges  B               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   C               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  C               Compaq BASIC requirements for free disk storage space G               are different during installation and after installation. F               The total blocks needed include Help, Starlet, and MotifC               files. Table 1-1 summarizes the storage requirements.           H                              Preparing for Compaq BASIC Installation 1-3                 E            Table_1-1_Disk_Space_Requirements_________________________   >                             Blocks During         Blocks AfterE            Kit______________Installation__________Installation_______   7            Compaq BASIC     32500                 24500             Version 1.5  6            Compaq BASIC     4400                  4400            Translator             Version 1.3  7            Compaq BASIC     20000                 20000             Translator RTL E            Version_1.3________________________________________________  D            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  B            At the beginning of the installation, VMSINSTAL asks ifA            you have backed up your system disk. It is recommended A            that you do a system disk backup before installing anye            software.  A            Use the backup procedures that are established at your C            site. For details about performing a system disk backup, ?            see the section on the Backup utility in the OpenVMSe#            System Manager's Manual.                           0      1-4 Preparing for Compaq BASIC Installation :  p                  H                                                                        2H         ________________________________________________________________  H                                                  Installing Compaq BASIC      >               After you register and load the license PAK, theG               installation takes approximately 15 minutes, depending on F               your system configuration and the kit components chosen.  D               If you encounter any failures during installation, see               Appendix C.o  "         2.1 Installation Procedure                 Mount the media.  D               To abort the installation procedure at any time, pressG               Ctrl/Y. When you press Ctrl/Y, the installation procedurehG               deletes all the files it has created up to that point and ?               exits. You can then start the installation again.u  D               When the system prompts you with a question during theH               installation procedure, the default answer is often listed               in brackets ([]).e  C               To install Compaq BASIC, perform the following steps:e  D               1. Log in to a privileged account and set your default4                  device and directory to SYS$UPDATE.  "                   Username: SYSTEM                   Password:i  )                  $ SET DEFAULT SYS$UPDATEn  "               2. Invoke VMSINSTAL.  B                  $ @VMSINSTAL saveset-name device-name option-list  G                  VMSINSTAL is in the SYS$UPDATE directory. The elementspG                  that you specify when you invoke the VMSINSTAL commandi*                  procedure are as follows:  H                                              Installing Compaq BASIC 2-1    t                           saveset-nameA               The installation name for the component. For Compaq D               BASIC, enter the following installation name (n is the*               minor point release number):                 BASIC01n                 device-namerB               The name of the device on which you have mounted theA               media and the directory containing the Compaq BASICT?               save set. For example, DKA300: is the device nameh>               used in examples in this guide. The directory is               [BASIC01n.KIT].   B               To specify the device name on the @VMSINSTAL command               line, enter:  #               DKA300:[BASIC01n.KIT]                  option-listp=               The word OPTIONS followed by one or more of the 9               following option designators-A, G, L, N, R:_  '               o  Auto_answer option (A)   D                  Initially creates a file that contains your answersE                  to VMSINSTAL questions and prompts. You can then use E                  the option (and the answer file) to save time duringaA                  a reinstallation (typically after upgrading your.                  system).   (               o  Get save-set option (G)  B                  Lets you store product save sets temporarily on a6                  magnetic tape or in a disk directory.  $               o  File log option (L)  C                  Logs all activity to the terminal during installa-                   tion.  7               o  Display or print the release notes (N)s  @                  Indicates that you want to see the installationA                  question on release notes. If you do not includeg?                  the N option, VMSINSTAL does not ask you about.A                  the release notes. You should review the releaseaA                  notes before proceeding with the installation in.         2-2 Installing Compaq BASIC h  o            F                     case they contain additional information about the!                     installation.i  C                     If you are restarting the installation and havenB                     already reviewed the release notes, you do notC                     need to specify the N option. (Even if you omit F                     the N option when you invoke VMSINSTAL, the CompaqG                     BASIC release notes are copied automatically to then(                     SYS$HELP directory.)  -                  o  Alternate root option (R)m  G                     Lets you install the product to a system root other.4                     than that of the running system.  H                  For detailed information on these software installationE                  options, see the OpenVMS operating system documenta-eD                  tion. If you specify more than one option, separate3                  each option with a comma, such as:                     OPTIONS A,N  C                  The following example invokes VMSINSTAL to installfA                  Compaq BASIC and shows the system response. This.@                  example uses the OPTIONS N release note option.  F                  $ @VMSINSTAL BASIC01n DKA300:[BASIC01n.KIT] OPTIONS N  O                        OpenVMS AXP Software Product Installation Procedure V6.2n  ,                  It is dd-mmm-yyyy at hh:mm.  @                  Enter a question mark (?) at any time for help.  E                  If you do not supply the product name, or the device G                  name, VMSINSTAL prompts you for this information later_/                  in the installation procedure.   E                  When you invoke VMSINSTAL, it checks whether you arerE                  logged in to a privileged account. It is recommendedmD                  that you install software from the system manager'sF                  account with your default device and directory set to                  SYS$UPDATE.  E                  VMSINSTAL then checks to determine whether any users A                  are logged in to the system. If users are logged D                  in, VMSINSTAL asks whether you want to continue the                  installation:  H                                              Installing Compaq BASIC 2-3 e  a            4               * Do you want to continue anyway [NO]?  C               If you want to continue, enter Y. If you want to stop -               the installation, press Return.   $            3. Confirm system backup.  L               * Are you satisfied with the backup of your system disk [YES]?  A               If you are satisfied with the backup of your system C               disk, press Return. Otherwise, enter N to discontinueqC               the installation. After you back up your system disk,r/               you can restart the installation.   E               If you omitted the device name on the VMSINSTAL command 1               line, the following prompt appears:   ?               * Where will the distribution volumes be mounted:p  ;               If this prompt appears, enter the name of therE               distribution (media) device and directory that contains B               the Compaq BASIC kit (save set). For example, if theE               media is contained on a CD-ROM located on unit DKA300:,oC               enter DKA300:[BASIC01n.KIT] in reply to this questiona4               (where n is the minor version number).  >               If you omitted the product name on the VMSINSTAL9               command line, the following prompt appears:O                 Products:s  +               Enter the kit name, BASIC01n.o  A               If you did not choose an installation option at the ?               options prompt on the VMSINSTAL command line, thehC               following prompt appears and you can enter one of thee#               installation options:r  B               Enter installation options you wish to use (none): N  D               Depending on the type of device and whether the deviceB               is already mounted, the following prompt may appear:  B               Please mount the first volume of the set on DKA300:."               * Are you ready? YES0               %MOUNT-I-MOUNTED, DKA300:  mounted  D               If you have not already done so, you should now insertA               the distribution volume on the device you specifiednD               when you invoked VMSINSTAL. The device name appears in         2-4 Installing Compaq BASIC                 H                  the line preceding the question. VMSINSTAL then asks ifA                  you are ready to continue with the installation._  A                  If you respond Y to indicate that you are ready,_G                  VMSINSTAL displays a message that the media containingpF                  Compaq BASIC has been mounted on the specified device5                  and that the installation has begun.   F                  If you entered the wrong device name when you invokedH                  VMSINSTAL and need to restart the installation, enter NF                  in response to the "Are you ready?" question. To stopB                  the installation for other reasons, press Ctrl/Y.  4               4. Verify the product being installed.  ;                   The following products will be processed:r                       BASIC V1.n  H                           Beginning installation of BASIC V1.n  at hh:mm  F                   %VMSINSTAL-I-RESTORE, Restoring product saveset A...  @                  The product name and version are displayed. TheD                  first save set (A) is restored to a subdirectory of                  SYS$UPDATE.  /               5. Select a release notes option.   6                      Additional Release Notes Options:  2                          1.  Display release notes0                          2.  Print release notes)                          3.  Both 1 and 2_.                          4.  None of the above  %                  * Select option [2]:   F                  If you specified OPTIONS N when you invoked VMSINSTALF                  or at the options prompt, you are now asked to chooseH                  one of the options for reviewing the release notes. All<                  options copy the release notes to SYS$HELP.  G                  If you select option 1, VMSINSTAL displays the release C                  notes immediately on the console terminal. You can F                  terminate the display at any time by pressing Ctrl/C.  H                                              Installing Compaq BASIC 2-5 e  .            C               If you select option 2, VMSINSTAL prompts you for thesB               name of the print queue that you want to use. EitherE               supply the name of the print queue that you want to userD               or press Return to send the file to the default output(               print device. For example:  5               * Queue name [SYS$PRINT]: CLUSTER_PRINTa  D               If you select option 3, VMSINSTAL displays the release@               notes immediately on the console terminal and thenC               prompts you for a queue name for the printed version.i  E               If you select option 4, the installation procedure willlD               only copy the release notes to the SYS$HELP directory.  >               Next, VMSINSTAL asks if you wish to continue the#               installation process.q  >               * Do you want to continue the installation [NO]?  C               If you want to continue, enter Y. If you want to stopeC               the installation, press Return. If you are continuingp@               the installation, VMSINSTAL displays the following               message:  P      %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.U      %VMSINSTAL-I-RELNOTMOV, A PostScript version of the release notes has been moved        to SYS$HELP.  8                 Compaq BASIC V1.n Installation Procedure  A        Copyright 2002 Compaq Information Technologies Group, L.P.g  D               The release notes are copied to the following files in%               the SYS$HELP directory:r  $               BASIC01n.RELEASE_NOTES'               BASIC01n_RELEASE_NOTES.PSe  A               After the installation, you can enter the followingh?               command to view the location of the release notest(               through the Help facility:  (               $ HELP BASIC RELEASE_NOTES  ,            6. Select an installation option.         2-6 Installing Compaq BASIC                 ?                  The installation procedure lets you select thesD                  components of the kit that you want to install. The(                  choices are as follows:  L            There are six possible installation options. They are as follows:  >            1) Perform a complete installation of Compaq BASIC.  X            2) Install only OpenVMS Alpha system definitions text library (5-15 minutes).  E            3) Install only the Motif bindings and examples for BASIC.,  B            4) Install only the Compaq BASIC language help library.  N            5) Obtain a copy of the Compaq BASIC message text for modification.  7            6) Install only the Compaq BASIC Translator.   .         * Which option do you want to use [1]:  C                  If you specify option 1, which is the default, theS(                  installation continues.  G                  Select the components you want to install by answeringeE                  Y or N to the questions. If you want a more detailed D                  description of any component, enter a question markA                  (?). After the explanation is displayed, you are2/                  prompted again for a response.   H                  If you enter Y, the installation procedure installs the                  component.r  :               7. Install OpenVMS Alpha system definitions.  T                  * Do you want to install the OpenVMS Alpha system definitions [NO]?  U                  This option generates a text library (SYS$LIBRARY:BASIC$STARLET.TLB)r@                  that contains OpenVMS Alpha system definitions.F                  Depending on your processor and system load, creatingF                  this library takes approximately 5 to 15 minutes. TheH                  OpenVMS Alpha system definitions require 5000 blocks of                  disk space.  +               8. Install Motif definitions.   F                  * Do you want to install the Motif definitions [YES]?  H                                              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 definitionso?               require 1500 blocks of disk space and contain thes@               Constant, Record, and External declarations neededE               to do Motif programming. Examples are also put into the1E               DECW$EXAMPLES area provided it exists. Note that if the E               DECW$EXAMPLES area does not exist, the default for this @               question is NO, and the examples are not provided.  '            9. Install BASIC Help files.D  T               * Do you want to install the Compaq BASIC language HELP library [YES]?  E               The Help files describe how to invoke Compaq BASIC from C               the DCL command line and the BASIC language features. D               The Help files require 430 blocks of disk space. It is7               recommended that you install these files.   ,            10.Obtain the BASIC message file.  G               * Do you want to copy the Compaq BASIC message file [NO]?b  D               The BASIC message source file contains the text of theE               Compaq BASIC messages that may be copied for customiza- F               tion purposes. It is placed in SYS$UPDATE:BASIC$MSG.MSG.@               The message file requires 85 blocks of disk space.9               Normally you do not need to copy this file.o  2            11.Install the Compaq BASIC Translator.  H               * 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 TranslatorE               is provided in separate Compaq BASIC Translator Releasep@               Notes. The Translator requires 4400 blocks of disk               space.  B               If you elect to install the Compaq BASIC Translator,.               the following question is asked.  K               * Do you want a copy of the Compaq BASIC Translator RTL [NO]?d         2-8 Installing Compaq BASIC    n            G                  Answering YES to this option puts a copy of the CompaqoD                  BASIC Translator RTL file, DB2VB$DBTRTL_I.ZIP, intoD                  the SYS$LIBRARY directory. This file must be copiedC                  to and installed on the target Windows system (SeeeB                  Section 2.2). The file is also available from the]                  Internet at http://www.openvms.compaq.com/commercial/basic/db2vb_index.html. F                  The Internet is the recommended source for this file.A                  Because DB2VB$DBTRTL_I.ZIP is quite large, 20000 F                  blocks, and is not used on the OpenVMS system, directG                  downloading from the Internet to the Windows system is                   simpler.                  12.Purge files.,  R                  * Do you want to purge files replaced by this installation [YES]?  D                  The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE,C                  SYS$SYSTEM, SYS$TEST, and SYS$EXAMPLES may contain E                  previous versions of Compaq BASIC files. These filesME                  are replaced with new files during the installation,oE                  but the previous files are not automatically purged.eC                  Purging is recommended. In response to the purgingIG                  prompt, press Return or enter Y to purge the files, or &                  enter N to keep them.  9               13.Respond to license registration queries.e  E                  Compaq BASIC supports the OpenVMS License Management D                  Facility (LMF). The installation procedure displays@                  license information about Compaq BASIC. It asksD                  whether you have registered and loaded your ProductH                  Authorization Key (PAK) for each product. The followingA                  is an example of the information and the queriesA9                  presented by the installation procedure:   *                        Product:      BASIC(                        Producer:     DEC(                        Version:      1.n0                        Release Date: dd-mmm-yyyy  U                  * Does this product have an authorization key registered and loaded?         H                                              Installing Compaq BASIC 2-9                 =               If you have not registered and loaded your PAK,a>               you must answer NO to this question. You have toB               register and load a PAK to successfully complete theB               installation (see Section 1.1). If you have not doneE               so, you should stop the installation, register and load :               your PAK, and then restart the installation.  *            14.Read informational messages.  B               At this point, the installation procedure displays aA               number of informational messages that report on thei@               progress of the installation. There are no further?               questions. If the installation procedure has been B               successful up to this point, VMSINSTAL moves the newD               or modified files to their target directories, updates?               help files, and updates DCL tables, if necessary.   S      %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...   D               The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXEB               files are updated to include the new versions of the?               Compaq BASIC help text and the BASIC command-line                definition.e  D               Also, if you answered Y in response to the prompt thatD               requests a file purge, previous versions of the Compaq)               BASIC files are now purged.               15.Observe the IVP.  C               VMSINSTAL now places the IVP files into the directoryr@               SYS$TEST and invokes the IVP to verify that CompaqE               BASIC and/or the Compaq BASIC Translator were installed                successfully.p  C               You can also run the IVPs independently, after CompaqnE               BASIC and/or the Compaq BASIC Translator are installed,w>               to verify that the software is available on yourC               system. You might need to run the IVPs after a systemtE               failure to make sure that users can access Compaq BASICcD               and/or the Compaq BASIC Translator. You can do this byB               invoking either of the following command procedures:  '               $ @SYS$TEST:BASIC$IVP.COM                  or  '               $ @SYS$TEST:DB2VB$IVP.COM   !      2-10 Installing Compaq BASIC0 D  0            D                  If Compaq BASIC was installed successfully, the IVP(                  displays the following:  T                  %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC V1.n Installation test PASSED  9                  The Compaq BASIC V1.n IVP has succeeded!r  F                  If the Compaq BASIC Translator was installed success-7                  fully, the IVP displays the following:l  _                  %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC Translator V1.n Installation test PASSED   D                  The Compaq BASIC Translator V1.n IVP has succeeded!  0               16.End the installation procedure.  @                  The end of the installation is indicated by the#                  following message:U  F                          Installation of BASIC V1.n completed at hh:mm  O                      Adding history entry in VMI$ROOT:{SYSUPD]VMSINSTAL.HISTORY   X                      Creating installation data file: VMI$ROOT:[SYSUPD]BASIC01n.VMI_DATA  :                          VMSINSTAL procedure done at hh:mm  E                  Depending on whether you specified parameters on theuB                  VMSINSTAL command line, the * Products: prompt orB                  the DCL prompt ($) may appear. If the * Products:E                  prompt appears, you can return to the DCL prompt ($)f$                  by pressing Ctrl/Z.  D                  VMSINSTAL deletes or changes entries in the processB                  symbol tables during the installation. Therefore,D                  if you are going to continue using the installationG                  account (such as SYSTEM) and you want to restore these >                  symbols, you should log out and log in again.              H                                             Installing Compaq BASIC 2-11 o  o            @      2.2 Installing the Compaq BASIC Translator Run-Time Library  ?            The Run-Time Library for the Compaq BASIC TranslatorcB            is available as a .ZIP file named DBTRTL_I.ZIP from theZ            Internet (URL http://www.openvms.compaq.com/commercial/basic/db2vb_index.html),D            or in SYS$LIBRARY:DB2VB$DBTRTL_I.ZIP if you chose to copyA            it from the compiler kit. The Run-Time Library must beoA            installed on every Windows system that runs translatedeC            applications. Follow these steps to install the Run-Time             Library:   ?            1. Create an empty folder. The installation requirest=               approximately six megabytes of disk space (fourAB               megabytes on the device where it is unpacked and two.               megabytes on the system device).  E            2. Make a copy of the Run-Time Library .ZIP file available(=               either on some removable media or via a networkh               connection.   C            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.  8            5. Run SETUP.EXE and follow the instructions.  :      2.3 Installing the Compaq BASIC Translator RMS Server  D            Two images are required to provide the server side of theC            RMS support provided by the Compaq BASIC Translator RTL.             These are:h              o  DB2VB$SPAWNER.EXE   "            o  DB2VB$RMS_SERVER.EXE  B            They have been placed in SYS$SYSTEM by the installationC            procedure. Also placed in SYS$SYSTEM during installationeE            of the Compaq BASIC Translator are two sets of correspond-nE            ing images, one for the VAX platform and one for the Alphaa/            platform. They are named as follows:e    !      2-12 Installing Compaq BASICd               H               __________________________________________________________H               VAX________________________ALPHA__________________________  @               DB2VB$SPAWNER.EXE_VAX      DB2VB$SPAWNER.EXE_ALPHA  H               DB2VB$RMS_SERVER.EXE_VAX___DB2VB$RMS_SERVER.EXE_ALPHA_____  D               To access RMS files from a translated application, theB               appropriate pair of server images must be copied andA               renamed to the server platform. For example, if the.A               server platform is an Alpha machine, then the fileseD               DB2VB$SPAWNER.EXE_ALPHA and DB2VB$RMS_SERVER.EXE_ALPHAF               must be copied to the Alpha platform and renamed to have-               the .EXE file type, as follows:e  Z         $ 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                                                          H                                             Installing Compaq BASIC 2-13 N  L                  H                                                                        3H         ________________________________________________________________  H                                            After Installing Compaq BASIC      G               After Compaq BASIC is installed, it can be invoked by allo+               users with the BASIC command.   G               The installation procedure modifies the DCL command table D               so that the BASIC command is recognized and processed.D               However, the previous command table is still in effectH               for those users who are currently logged in. All logged-inF               users who want to use the BASIC command must log out and=               log in again, or use the following DCL command:l  9               $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES   G               You can perform the following tasks after Compaq BASIC isc               installed:  F               o  Running the Installation Verification Procedure (IVP)                  separatelyt  @               o  Making the product usable in an OpenVMS Cluster                  environment  F         3.1 Running the Installation Verification Procedure Separately  E               You usually run the Installation Verification Procedure H               (IVP) during installation. If you have system problems andG               want to run the IVP separately to ensure the integrity ofo9               installed files, use the following command:   '               $ @SYS$TEST:BASIC$IVP.COMi                 or  '               $ @SYS$TEST:DB2VB$IVP.COMf                 as appropriate.   H                                        After Installing Compaq BASIC 3-1 L               9      3.2 Making Compaq BASIC Usable in an OpenVMS Clusterh          Environment  B            If you want to run Compaq BASIC on multiple nodes of anC            OpenVMS Cluster environment, first check to see that youPC            have the appropriate software license (see Section 1.1).eE            Then, perform the following steps after you install CompaqR            BASIC:   D            1. Enter the LICENSE LOAD command to activate the licenseC               on each node on which Compaq BASIC is to be executed.o  C            2. Use the OpenVMS System Management (SYSMAN) utility to E               execute a set of commands on all cluster nodes, whethern@               or not the nodes are licensed to use Compaq BASIC.E               Failure to do so may cause unexpected errors for users.h  C               ________________________Note ________________________e  A               If you are using a dual-architecture (VAX and Alphax?               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 6               OpenVMS system management documentation.  C               _____________________________________________________f  ?               While logged in as SYSTEM or as another user namen=               that has the SETPRV privilege or the CMKRNL andiA               SYSPRV privileges, use SYSMAN to update the versionn5               of DCLTABLES.EXE available, as follows:l  %               $ RUN SYS$SYSTEM:SYSMANc-               SYSMAN> SET ENVIRONMENT/CLUSTERn9               %SYSMAN-I-ENV, current command environment: 2                       Clusterwide on local clusterJ                       Username SYSTEM       will be used on nonlocal nodesB               SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE?               %SYSMAN-I-OUTPUT, command execution on node NODE1d?               %SYSMAN-I-OUTPUT, command execution on node NODE2.  E               SYSMAN will cause each DO command to be executed on alla)               nodes of the local cluster.n  &      3-2 After Installing Compaq BASIC g  r            G               3. If Compaq BASIC is installed as a known image, then doO                  the following:   @                  SYSMAN> DO INSTALL REPLACE SYS$SYSTEM:BASIC.EXEB                  %SYSMAN-I-OUTPUT, command execution on node NODE1B                  %SYSMAN-I-OUTPUT, command execution on node NODE2  C               4. If the Compaq BASIC message file is installed as aM4                  known image, then do the following:  E                  SYSMAN> DO INSTALL REPLACE SYS$MESSAGE:BASIC$MSG.EXE B                  %SYSMAN-I-OUTPUT, command execution on node NODE1B                  %SYSMAN-I-OUTPUT, command execution on node NODE2  +               5. Finally, exit from SYSMAN:T                    SYSMAN> EXITS                  $  C         3.3 Making the Compaq BASIC Translator Usable in an OpenVMSn             Cluster Environments  H               If you want to run the Compaq BASIC Translator on multipleE               nodes of an OpenVMS Cluster environment, first check to E               see that you have the appropriate software license (see E               Section 1.1). The Compaq BASIC Translator uses the sameOH               license as Compaq BASIC. Then, perform the following steps<               after you install the Compaq BASIC Translator:  G               1. Enter the LICENSE LOAD command to activate the licenseoH                  on each node on which the Compaq BASIC Translator is to                  be executed.   C               2. Use the OpenVMS System Management utility (SYSMAN) C                  to execute a set of commands on all cluster nodes,bH                  whether or not the nodes are licensed to use the CompaqH                  BASIC Translator. Failure to do so may cause unexpected"                  errors for users.  F                 ________________________Note  ________________________  D                 If you are using a mixed-architecture (VAX and AlphaA                 systems), heterogeneous cluster, before executing A                 these commands, make sure the appropriate logicaln>                 names have been set to define the scope of the  H                                        After Installing Compaq BASIC 3-3 C  a            ?               SYSMAN DO commands. For more information, see thet6               OpenVMS system management documentation.  C               _____________________________________________________B  ?               While logged in as SYSTEM or as another user namer=               that has the SETPRV privilege or the CMKRNL andfA               SYSPRV privileges, use SYSMAN to update the versionh4               of DCLTABLES.EXE available as follows:  %               $ RUN SYS$SYSTEM:SYSMANa-               SYSMAN> SET ENVIRONMENT/CLUSTERS9               %SYSMAN-I-ENV, current command environment:h2                       Clusterwide on local clusterJ                       Username SYSTEM       will be used on nonlocal nodesB               SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE?               %SYSMAN-I-OUTPUT, command execution on node NODE1 ?               %SYSMAN-I-OUTPUT, command execution on node NODE2   E               SYSMAN will cause each DO command to be executed on alle)               nodes of the local cluster.t  D            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 isC               installed as a known image, then enter the following:B  B               SYSMAN> DO INSTALL REPLACE SYS$MESSAGE:DB2VB$MSG.EXE?               %SYSMAN-I-OUTPUT, command execution on node NODE1B?               %SYSMAN-I-OUTPUT, command execution on node NODE2f  (            5. Finally, exit from SYSMAN:                 SYSMAN> EXIT               $l  *      3.4 Setting User Account Requirements  D            To work with Compaq BASIC or the Compaq BASIC Translator,E            user accounts on your system must have certain privileges.t  &      3-4 After Installing Compaq BASIC e  t            %         3.4.1 User Account Privilegesu  A               To use Compaq BASIC or the Compaq BASIC Translator,FC               each account must have at least the TMPMBX and NETMBXrH               privileges. Use the OpenVMS Authorize utility to determine=               whether users have the privileges they require.K  (         3.5 Reporting Problems to Compaq  D               If you encounter a problem while using Compaq BASIC orD               Compaq BASIC Translator, and your software contract orH               warranty agreement entitles you to telephone support, call               Compaq.r  H               Review the Software Product Description (SPD) and WarrantyG               Addendum for an explanation of warranty. If you encounterdF               a problem during the warranty period, report the problemF               as previously indicated or follow alternate instructionsA               provided by Compaq for reporting SPD nonconformances               problems.                                                   H                                        After Installing Compaq BASIC 3-5    e                  H                                                                        AH         ________________________________________________________________  H                                                      Sample Installation      D               This appendix provides a sample listing for the Compaq)               BASIC full development kit.                 A.1 Full Development Kit  G               Example A-1 is a sample installation for the Compaq BASIC #               full development kit.w  A               This installation was performed on an OpenVMS AlphasH               Version V7.2 system that had no previous version of CompaqF               BASIC installed. Depending on which layered products youH               have on your system, you might see additional messages and;               questions when you perform your installation.r  F               This installation assumes that DECnet has been shut downB               and that OPTIONS N is specified to print the release               notes.  4         Example A-1 Sample Compaq BASIC Installation  @          Welcome to OpenVMS Alpha Operating System, Version V7.2           Username: SYSTEM         Password:   B             Last interactive login on Monday, dd-mmm-yyyy hh:mm:ssI             Last non-interactive login on Wednesday, dd-mmm-yyyy hh:mm:ssA           $ SET DEF SYS$UPDATE:         $ @SYS$UPDATE:VMSINSTAL BASIC015 MKA500: OPTIONS N  H                 OpenVMS AXP Software Product Installation Procedure V7.2  H                                                 (continued on next page)  H                                                  Sample Installation A-1 h  e            9      Example A-1 (Cont.) Sample Compaq BASIC Installationt         It is dd-MMM-yyyy at hh:mm.  4      Enter a question mark (?) at any time for help.  C      %VMSINSTAL-W-ACTIVE, The following processes are still active:o             APLTOO-      * Do you want to continue anyway [NO]? y C      * Are you satisfied with the backup of your system disk [YES]?i  .      The following products will be processed:          BASIC V1.5w  :              Beginning installation of BASIC V1.5 at hh:mm  ;      %VMSINSTAL-I-RESTORE, Restoring product save set A ...p  L          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]: 4n  7      * Do you want to continue the installation [NO]? yAP      %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.U      %VMSINSTAL-I-RELNOTMOV, A PostScript version of the release notes has been moved        to SYS$HELP.  7                Compaq BASIC V1.5 Installation Procedure.  B         Copyright 2002 Compaq Information Technologies Group, L.P.  G         Compaq and the Compaq logo are trademarks of Compaq InformationaD         Technologies Group, L.P. in the U.S. and/or other countries.  E                                              (continued on next page)o          A-2 Sample Installation    u            <         Example A-1 (Cont.) Sample Compaq BASIC Installation  R            Confidential computer software.  Valid license from Compaq required forN            possession, use or copying.  Consistent with FAR 12.211 and 12.212,M            Commercial Computer Software, Computer Software Documentation, and R            Technical Data for Commercial Items are licensed to the U.S. Government6            under vendor's standard commercial license.    L            There are six possible installation options. They are as follows:  >            1) Perform a complete installation of Compaq BASIC.  X            2) Install only OpenVMS Alpha system definitions text library (5-15 minutes).  E            3) Install only the Motif bindings and examples for BASIC.   B            4) Install only the Compaq BASIC language help library.  N            5) Obtain a copy of the Compaq BASIC message text for modification.  7            6) Install only the Compaq BASIC Translator.n  .         * Which option do you want to use [1]:  M         * Do you want to install the OpenVMS Alpha system definitions [NO]? y =         * Do you want to install the Motif definitions [YES]?tN         * Do you want to install the Compaq BASIC language HELP library [YES]?C         * Do you want to copy the Compaq BASIC message file [NO]? ydD         * Do you want to install the Compaq BASIC Translator [NO]? yG         * Do you want a copy of the Compaq BASIC Translator RTL [NO]? yi  I         * Do you want to purge files replaced by this installation [YES]?   #                 Product:      BASICr!                 Producer:     DEC !                 Version:      1.5 )                 Release Date: dd-mmm-yyyy   N         * Does this product have an authorization key registered and loaded? y  J            No further questions will be asked.  The installation will takeL            5 - 15 more minutes depending upon options chosen, configuration,            and system activity.t  H                                                 (continued on next page)  H                                                  Sample Installation A-3                 9      Example A-1 (Cont.) Sample Compaq BASIC Installation   ;      %VMSINSTAL-I-RESTORE, Restoring product save set B ...oU      %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSTEa      ST.BASIC].pG      %VMSINSTAL-I-INSHELP, Installing Compaq BASIC environment emulatorhU      %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSHLt      P.EXAMPLES.BASIC].o;      %VMSINSTAL-I-RESTORE, Restoring product save set D ...eH      %VMSINSTAL-I-INSSTARLET, Installing Compaq BASIC system definitions?      %VMSINSTAL-I-INSSTARLET, requires approximately 15 minutes ;      %VMSINSTAL-I-RESTORE, Restoring product save set E ..._E      %VMSINSTAL-I-INSMOTIG, Installing Motif definitions and examplesA;      %VMSINSTAL-I-RESTORE, Restoring product save set F ....E      %VMSINSTAL-I-INSHELP, Installing Compaq BASIC language Help filep;      %VMSINSTAL-I-RESTORE, Restoring product save set G ...eB      %VMSINSTAL-I-MSGLOC, BASIC$MSG.MSG will be placed in [SYSUPD]U      %VMSINSTAL-I-RELNOTMOV, Text and PostScript versions of the Compaq BASIC Translae3      tor release notes have been moved to SYS$HELP._;      %VMSINSTAL-I-RESTORE, Restoring product save set H ...lU      %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSTE       ST.DB2VB].B;      %VMSINSTAL-I-RESTORE, Restoring product save set I ...ES      %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...M  A        Copyright 2002 Compaq Information Technologies Group, L.P.   F        Compaq and the Compaq logo are trademarks of Compaq InformationC        Technologies Group, L.P. in the U.S. and/or other countries.   N        Confidential computer software.  Valid license from Compaq required forJ        possession, use or copying.  Consistent with FAR 12.211 and 12.212,I        Commercial Computer Software, Computer Software Documentation, and,N        Technical Data for Commercial Items are licensed to the U.S. Government2        under vendor's standard commercial license.  U      %VMSINSTAL-I-DOIVP, Executing the Compaq BASIC V1.5 Installation Verification Pr       ocedure  H      %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC V1.5 Installation test PASSED  -      The Compaq BASIC V1.5 IVP has succeeded!n  E                                              (continued on next page)         A-4 Sample Installation t  f            <         Example A-1 (Cont.) Sample Compaq BASIC Installation    D           Copyright 2002 Compaq Information Technologies Group, L.P.  I           Compaq and the Compaq logo are trademarks of Compaq InformationlF           Technologies Group, L.P. in the U.S. and/or other countries.  Q           Confidential computer software.  Valid license from Compaq required fornM           possession, use or copying.  Consistent with FAR 12.211 and 12.212, L           Commercial Computer Software, Computer Software Documentation, andQ           Technical Data for Commercial Items are licensed to the U.S. Government 5           under vendor's standard commercial license.o  X         %VMSINSTAL-I-DOIVP, Executing the Compaq BASIC Translator V1.3 Installation Veri         fication Procedure  V         %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC Translator V1.3 Installation test PASSED  ;         The Compaq BASIC Translator V1.3 IVP has succeeded!S  =                 Installation of BASIC V1.5 completed at hh:mmn  F             Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  O             Creating installation data file: VMI$ROOT:[SYSUPD]BASIC015.VMI_DATAs  1                 VMSINSTAL procedure done at hh:mmi  	         $l                              H                                                  Sample Installation A-5    B                  H                                                                        BH         ________________________________________________________________  H                                           Files Installed on Your System               B.1 Installed Filesn  @               The Compaq BASIC installation procedure installs aE               number of files on your system and defines some logicalsD               names. The first list shows the files installed duringG               installation. The second list shows the files modified by G               the installation. Note this list assumes that all optionsn               were selected.  0               Files Provided by the Installation  -                  SYS$COMMON:[SYSEXE]BASIC.EXE -                  SYS$COMMON:[SYSEXE]DB2VB.EXEr8                  SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE>                  SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE_ALPHA<                  SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE_VAX5                  SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXEe;                  SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXE_ALPHAi9                  SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXE_VAXf@                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]BASIC$ENV.TPUF                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$HELLOMOTIF.BASF                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$HELLOMOTIF.UILG                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER.BAS G                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER.UILE2                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW].                     BASIC$MOTIFBURGER_DEFS.BAS:                  SYS$COMMON:[SYSHLP]BASIC015.RELEASE_NOTES=                  SYS$COMMON:[SYSHLP]BASIC015_RELEASE_NOTES.PSd:                  SYS$COMMON:[SYSHLP]DB2VB013.RELEASE_NOTES=                  SYS$COMMON:[SYSHLP]DB2VB013_RELEASE_NOTES.PS 1                  SYS$COMMON:[SYSHLP]BASICHELP.HLBa2                  SYS$COMMON:[SYSLIB]DEC$BASRTL.EXE5                  SYS$COMMON:[SYSLIB]BASIC$STARLET.TLBS2                  SYS$COMMON:[SYSLIB]DECW$MOTIF.BAS7                  SYS$COMMON:[SYSLIB]DECW$MOTIF_DEFS.BAS,  H                                       Files Installed on Your System B-1 e  l            2               SYS$COMMON:[SYSLIB]DB2VB$LIBRARY.TLB3               SYS$COMMON:[SYSLIB]DB2VB$DBTRTL_I.ZIPL.               SYS$COMMON:[SYSMSG]BASIC$MSG.EXE.               SYS$COMMON:[SYSMSG]DB2VB$MSG.EXE/               SYS$COMMON:[SYSTEST]BASIC$IVP.COMe5               SYS$COMMON:[SYSTEST.BASIC]BASIC$IVP.BASf/               SYS$COMMON:[SYSTEST]DB2VB$IVP.COM 5               SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.BAS 5               SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.BMKn5               SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.EXEa9               SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.VBP_BMKp9               SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.VPD_BMKe:               SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP_GBLS.BMK.               SYS$COMMON:[SYSUPD]BASIC$MSG.MSG  -            Files Modified by the Installationa  ,               SYS$COMMON:[SYSHLP]HELPLIB.HLB.               SYS$COMMON:[SYSLIB]DCLTABLES.EXE-               SYS$COMMON:[SYSLIB]IMAGELIB.OLBL                                                  '      B-2 Files Installed on Your SystemI r  l                  H                                                                        CH         ________________________________________________________________  H                                                   Recovering from Errors      A               This appendix provides information to help you deal E               with failures or errors that might occur during product *               installation or product use.  0         C.1 Failures During Product Installation  H               If VMSINSTAL detects any problems during the installation,B               it notifies you and asks if you want to continue theA               installation. In some instances, you can enter Y tonD               continue. To stop the installation process and correctF               the situation, enter N or press Return. Then correct the3               problem and restart the installation.   D               If errors occur during the installation itself or whenG               the Installation Verification Procedure (IVP) is running, F               VMSINSTAL displays failure messages. If the installation3               fails, you see the following message:i  \               %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!  V               %VMSINSTAL-E-IVPFAIL, Compaq BASIC Version 1.5 Installation test FAILED.  D               Errors can occur during the installation if any of the)               following conditions exist:D  ;               o  The operating system version is incorrect.   >               o  A prerequisite software version is incorrect.  A               o  Quotas necessary for successful installation areb                  insufficient.  H               o  System parameter values for successful installation are                  insufficient.  >               o  The OpenVMS help library is currently in use.  H                                               Recovering from Errors C-1 m               E            o  The product license has not been registered and loaded.   D            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 theseC            conditions exist, you should take the appropriate actiond'            as described in the message.r  ?            For information about installation requirements, see3            Chapter 1.   $      C.2 Failures During Product Use  A            If you encounter a problem while using Compaq BASIC orsA            Compaq BASIC Translator, and your software contract orsE            warranty agreement entitles you to telephone support, calli            Compaq.  E            Review the Software Product Description (SPD) and Warranty D            Addendum for an explanation of warranty. If you encounterC            a problem during the warranty period, report the problem C            as previously indicated or follow alternate instructionse>            provided by Compaq for reporting SPD nonconformance            problems.                                              C-2 Recovering from Errorsn