                                     C                      Compaq_BASIC_for_OpenVMS_VAX_Systems__________ '                      Installation Guide   .                      Order Number: AA-HY12G-TE    "                      November 2000  H                      This guide describes how to install Compaq BASIC onF                      a VAX processor running the OpenVMS VAX operating                      system.            G                      Revision/Update Information: This guide supersedes ?                                                   the VAX BASIC E                                                   Installation Guide.   A                      Operating System & Version:  OpenVMS for VAX G                                                   Systems Version 5.5-2 :                                                   to 7.2-1  F                      Software Version:            Compaq BASIC VersionE                                                   3.9 for OpenVMS VAX 9                                                   Systems     0                      Compaq Computer Corporation#                      Houston, Texas                  E            __________________________________________________________             November 2000  -             2000 Compaq Computer Corporation   B            COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo:            Registered in U.S. Patent and Trademark Office.  D            OpenVMS is a trademark of Compaq Information Technologies@            Group, L.P. in the United States and other countries.  2            Motif is a trademark of The Open Group.  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 information@            in this document 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.   E                                                                ZK6380   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 8          1.3   Required Operating System Components, andC                Software.....................................    1-2 C          1.4   Installation Procedure Requirements..........    1-2 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.4.4     Backing Up Your System Disk..............    1-4       2  Installing Compaq BASIC   C          2.1   Installation Procedure.......................    2-1   #    3  After Installing Compaq BASIC   4          3.1   Running the Installation VerificationC                Procedure Separately.........................    3-1 4          3.2   Making Compaq BASIC Usable in an OpenC                VMScluster Environment.......................    3-2 C          3.3   Setting User Account Requirements............    3-3 C          3.3.1     User Account Privileges..................    3-3               C                                                                 iii                        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 ..........     vi   E            1-1       Disk Space Requirements..................    1-3                                                   iv                            H         ________________________________________________________________  H                                                                  Preface      B               This guide describes how to install Compaq BASIC forD               OpenVMS VAX Systems on VAX 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.   F               Compaq BASIC for OpenVMS VAX Systems is the new name forF               VAX BASIC. Compaq BASIC for OpenVMS Alpha Systems is the%               new name for DEC BASIC.            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 ?            if you find errors, please send your comments to us:               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 Compaq7               BASIC Version 3.9 for OpenVMS VAX 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:BASIC03n.RELEASE_NOTES         Conventions  @            Table 1 describes the conventions used in this guide.  E            Table_1_Conventions_Used_in_this_Guide____________________   E            Convention_______Description______________________________   D            $                A dollar sign represents the OpenVMS DCL#                             prompt.   E            Ctrl/x           The key combination Ctrl/x indicates that E                             you must press the key labeled Ctrl while E                             you simultaneously press another key, for 6                             example, Ctrl/Y or Ctrl/Z.  E                                              (continued on next page)         vi                  H               Table_1_(Cont.)_Conventions_Used_in_this_Guide____________  H               Convention_______Description______________________________  E               UPPERCASE        Uppercase letters indicate the name of B                                a command, routine, or file, a fileC                                protection code, or the abbreviation 6                                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 3.9 for OpenVMSF               VAX Systems. This letter discusses important informationG               that might not be included in this guide. You should read F               this letter now. You should also review the Compaq BASICH               Release Notes before continuing with the installation. ForH               information on accessing the Release Notes, see Chapter 2.  -         1.1 Registering Your Software License   F               Before you install and run Compaq BASIC Version 3.9 on aH               newly licensed node or an Open VMScluster 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 priviliged 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 Open VMScluster 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 3.9 Software%            Product Description (SPD).   ;      1.3 Required Operating System Components, and Software   =            Compaq BASIC Version 3.9 for OpenVMS Alpha systems C            requires OpenVMS for VAX Systems Version 5.5-2 to 7.2-1.   B            The following optional software can be used with Compaq            BASIC:   #            o  Oracle CDD/Repository   '            o  Language-Sensitive Editor   "            o  Source Code Analyzer  ,      1.4 Installation Procedure Requirements  A            This section describes the requirements for installing C            Compaq BASIC (process account quotas, system parameters, "            disk space, and so on).  0      1-2 Preparing for Compaq BASIC Installation                          1.4.1 VMSINSTAL Checks                 VMSINSTAL checks:   @               o  If the user is logged into a privileged account  A               o  If any other processes are running on the system   6               o  If the 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.3.1.           1.4.3 Disk Space  C               Compaq BASIC requirements for free disk storage space G               are different during installation and after installation. <               Table 1-1 summarizes the storage requirements.  H               Table_1-1_Disk_Space_Requirements_________________________  A                                Blocks During         Blocks After H               Kit______________Installation__________Installation_______  :               Compaq BASIC      2850                  1350               Version 3.9,               with no options   :               Compaq BASIC        +0                  +500               HELP file                option  H                                                 (continued on next page)  H                              Preparing for Compaq BASIC Installation 1-3                 E            Table_1-1_(Cont.)_Disk_Space_Requirements_________________   >                             Blocks During         Blocks AfterE            Kit______________Installation__________Installation_______   7            Compaq BASIC      +400                  +400             sample graphics            examples   7            Compaq BASIC     +8300                 +6500             system             definitions            option   7            Compaq BASIC     +1600                 +1600             Motif bindings             and examples   7            Compaq BASIC     13000                 11000             with all E            options___________________________________________________   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.4.4 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 any             software.  A            Use the backup procedures that are established at your D            site. For details on performing a system disk backup, seeB            the section on the Backup Utility in the OpenVMS System            Manager's Manual.              0      1-4 Preparing for Compaq BASIC Installation I  a                  H                                                                        2H         ________________________________________________________________  H                                                  Installing Compaq BASIC      ?               After you register and load your License PAK, the @               installation takes approximately 15 to 45 minutes,@               depending on your system configuration and the kit                components chosen.  D               If you encounter any failures during installation, see               Appendix C.   "         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 procedure G               deletes all the files it has created up to that point and ?               exits. You can then start the installation again.   D               When the system prompts you with a question during theH               installation procedure, the default answer is often listed               in brackets ([]).m  C               To install Compaq BASIC, perform the following steps:   D               1. Log in to a privileged account and set your default4                  device and directory to SYS$UPDATE:  "                   Username: SYSTEM                   Password:   )                  $ SET DEFAULT SYS$UPDATEt  "               2. Invoke VMSINSTAL:  B                  $ @VMSINSTAL saveset-name device-name option-list  >                  VMSINSTAL is in the SYS$UPDATE directory. The@                  parameters that you specify when you invoke the<                  VMSINSTAL command procedure are as follows:  H                                              Installing Compaq BASIC 2-1 e  o                           saveset-nameA               The installation name for the component. For CompaqrD               BASIC, enter the following installation name (n is the*               minor point release number):                 BASIC03n                 device-name >               The name of the device on which you have mountedA               the media containing the Compaq BASIC save set. For E               example, MKA400: is the device name used in examples inw               this guide.t  B               To specify the device name on the @VMSINSTAL command               line, enter:                 MKA400:e                 option-list =               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 during A                  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)o  @                  Indicates that you want to see the installationA                  question on release notes. If you do not includec?                  the N option, VMSINSTAL does not ask you about A                  the release notes. You should review the release A                  notes before proceeding with the installation inlC                  case they contain additional information about the.                  installation.         2-2 Installing Compaq BASIC    1            C                     If you are restarting the installation and have.B                     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 the.(                     SYS$HELP directory.)  -                  o  Alternate root option (R)   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- D                  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 install.A                  Compaq BASIC and shows the system response. Thisn@                  example uses the OPTIONS N release note option.  8                  $ @VMSINSTAL BASIC03n MKA400: OPTIONS N  O                        OpenVMS VAX Software Product Installation Procedure V7.2_  ,                  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 devicepG                  name, VMSINSTAL prompts you for this information latere/                  in the installation procedure.t  E                  When you invoke VMSINSTAL, it checks whether you arelE                  logged in to a privileged account. It is recommended D                  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 loggedsD                  in, VMSINSTAL asks whether you want to continue the                  installation:  7                  * Do you want to continue anyway [NO]?   H                                              Installing Compaq BASIC 2-3                 C               If you want to continue, enter Y. If you want to stopt-               the installation, press Return.3  $            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 discontinuepC               the installation. After you back up your system disk,e/               you can restart the installation.u  E               If you omitted the device name on the VMSINSTAL command 1               line, the following prompt appears:   ?               * Where will the distribution volumes be mounted:a  ?               If this prompt appears, enter the location of theoC               distribution media that contains the Compaq BASIC kiteD               (save sets). For example, if the media is contained onD               a tape located on unit MKA400:, enter MKA400: in reply               to this question.u  >               If you omitted the product name on the VMSINSTAL9               command line, the following prompt appears:                  Products:O  +               Enter the kit name, BASIC03n.e  A               If you did not choose an installation option at theo?               options prompt on the VMSINSTAL command line, theyC               following prompt appears and you can enter one of thep#               installation options:n  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 MKA400:."               * Are you ready? YES0               %MOUNT-I-MOUNTED, MKA400:  mounted  D               If you have not already done so, you should now insertA               the distribution volume on the device you specified D               when you invoked VMSINSTAL. The device name appears inE               the line preceding the question. VMSINSTAL then asks if >               you are ready to continue with the installation.         2-4 Installing Compaq BASIC ,  r            A                  If you respond Y to indicate that you are ready,xG                  VMSINSTAL displays a message that the media containingoF                  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:                        BASIC V3.n  B                     Beginning installation of BASIC V3.n  at hh:mm  H                     %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._  '                  Release Notes Options:_  +                   1.  Display release notesa)                   2.  Print release notes "                   3.  Both 1 and 24                   4.  Copy release notes to SYS$HELP  %                  * Select option [2]:f  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 releasetC                  notes immediately on the console terminal. You can F                  terminate the display at any time by pressing Ctrl/C.  F                  If you select option 2, VMSINSTAL prompts you for theE                  name of the print queue that you want to use. Either H                  supply the name of the print queue that you want to useG                  or press Return to send the file to the default output +                  print device. For example:o  H                                              Installing Compaq BASIC 2-5 o  o            5               * Queue name [SYS$PRINT]: CLUSTER_PRINT   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.y  E               If you select option 4, the installation procedure will D               only copy the release notes to the SYS$HELP directory.  =               Next, VMSINSTAL displays the following message:   Y               %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.   L                      Compaq BASIC V3.n Installation beginning at hh:mm:ss.cc  :                 Copyright 2000 Compaq Computer Corporation  C               The release notes are copied to the following file in %               the SYS$HELP directory:i  $               BASIC03n.RELEASE_NOTES  A               After the installation, you can enter the followingf?               command to view the location of the release notesc(               through the Help facility:  (               $ HELP BASIC RELEASE_NOTES  *            6. Select installation options.  <               The installation procedure lets you select theA               components of the kit that you want to install. Thet%               choices are as follows:   T                   There are three possible installation options.  They are described                   as follows:n  E                   1) Perform a complete installation of Compaq BASIC.s  M                   2) Install OpenVMS VAX system definitions text library onlyr%                      (10-45 minutes).   U                   3) Obtain a copy of the Compaq BASIC message text for modification.t  5                * Which option do you want to use [1]:n  A               If you specifiy choice 1, which is the default, the %               installation continues.r         2-6 Installing Compaq BASIC s  ,            G                  Select the components you want to install by answering E                  Y or N to the questions. If you want a more detailed D                  description of any component, enter a question markE                  (?). After the explanation is displayed, you will bee/                  prompted again for a response.p  H                  If you enter Y, the installation procedure installs the                  component.   *               7. Install BASIC HELP files.  E                  * Do you want to install the BASIC HELP files [YES]?i  H                  The HELP files describe how to invoke Compaq BASIC fromF                  the DCL command line and the BASIC language features.G                  The HELP files require 500 blocks of disk space. It is :                  recommended that you install these files.  8               8. Install OpenVMS VAX system definitions.  L                  * Do you want to install the OpenVMS VAX system definitions#                  (10-45 min.) [NO]?o  U                  This option generates a text library (SYS$LIBRARY:BASIC$STARLET.TLB) H                  that contains OpenVMS VAX system definitions. DependingA                  on your processor and system load, creating this E                  library requires approximately 10 to 45 minutes. The F                  OpenVMS VAX system definitions require 6500 blocks of                  disk space.  @               9. Install Compaq BASIC graphics support examples.  K                  * Do you want to install the sample graphic programs [NO]?   D                  Answering YES to this options puts the Compaq BASICT                  sample graphic programs into the SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]E                  directory. These programs require 400 blocks of diskaH                  space, and illustrate how to use Compaq BASIC graphics.  +               10.Install Motif definitions.   F                  * Do you want to install the Motif definitions [YES]?  C                  Answering YES to this option puts the Compaq BASICoB                  version of the Motif definitions, DECW$MOTIF.BAS,B                  into the SYS$LIBRARY directory. These definitionsB                  require 1600 blocks of disk space and contain theC                  Constant, Record, and External declarations neededmH                  to do Motif programming. Examples are also put into the  H                                              Installing Compaq BASIC 2-7 c  D            E               DECW$EXAMPLES area provided it exists. Note that if thelE               DECW$EXAMPLES area does not exist, the default for this0@               question is NO, and the examples are not provided.              11.Purge files.  O               * Do you want to purge files replaced by this installation [YES]?   A               The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE,M@               SYS$SYSTEM, SYS$TEST, and SYS$EXAMPLES may containB               previous versions of Compaq BASIC files. These filesB               are replaced during the installation with new files,E               but the old files are not automatically purged. Purging @               is recommended. In response to the purging prompt,D               press Return or enter Y to purge the files, or enter N               to keep them.i  6            12.Respond to license registration queries.  B               Compaq BASIC supports the OpenVMS License ManagementA               Facility (LMF). The installation procedure displaysf=               license information about Compaq BASIC. It askssA               whether you have registered and loaded your ProductiE               Authorization Key (PAK) for each product. The followingn>               is an example of the information and the queries6               presented by the installation procedure:  '                     Product:      BASIC %                     Producer:     DEC2%                     Version:      3.n_-                     Release Date: dd-mmm-yyyy   R               * Does this product have an authorization key registered and loaded?  =               If you have not registered and loaded your PAK,n>               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 loada:               your PAK, and then restart the installation.  *            13.Read informational messages.  B               At this point, the installation procedure displays aA               number of informational messages that report on thet@               progress of the installation. There are no further?               questions. If the installation procedure has been          2-8 Installing Compaq BASIC                 E                  successful up to this point, VMSINSTAL moves the newkG                  or modified files to their target directories, updatesgB                  help files, and updates DCL tables, if necessary.  P                  %VMSINSTAL-I-MOVEFILES, files will now be moved to their target                  directories...   G                  The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE E                  files are updated to include the new versions of thedB                  Compaq BASIC help text and the BASIC command-line                  definition.  G                  Also, if you answered Y in response to the prompt thatVG                  requests a file purge, previous versions of the Compaq ,                  BASIC files are now purged.  !               14.Observe the IVP.e  F                  VMSINSTAL now places the IVP files into the directoryC                  SYS$TEST and invokes the IVP to verify that CompaqtG                  BASIC was installed successfully. You can also run the G                  IVP independently, after Compaq BASIC is installed, tocF                  verify that the software is available on your system.H                  You might need to run the IVP after a system failure toF                  make sure that users can access Compaq BASIC. You canE                  do this by invoking the following command procedure:   +                  $ @SYS$TEST:BASIC$IVP.COM.s  D                  If Compaq BASIC was installed successfully, the IVP(                  displays the following:  T                  %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC V3.n Installation test PASSED9                  The Compaq BASIC V3.n IVP has succeeded!t  0               15.End the installation procedure.  @                  The end of the installation is indicated by the#                  following message:o  >                  Installation of BASIC V3.n completed at hh:mm  2                  VMSINSTAL procedure done at hh:mm  E                  Depending on whether you specified parameters on the B                  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 ($)r$                  by pressing Ctrl/Z.  H                                              Installing Compaq BASIC 2-9 t               A               VMSINSTAL deletes or changes entries in the processT?               symbol tables during the installation. Therefore,oA               if you are going to continue using the installationiD               account (such as SYSTEM) and you want to restore these;               symbols, you should log out and log in again.                                                                                 !      2-10 Installing Compaq BASICa h  .                  H                                                                        3H         ________________________________________________________________  H                                            After Installing Compaq BASIC      G               After Compaq BASIC is installed, it can be invoked by allo+               users with the BASIC command.t  G               The installation procedure modifies the DCL command tableoD               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:   9               $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLESv  G               You can perform the following tasks after Compaq BASIC ist               installed:  F               o  Running the Installation Verification Procedure (IVP)                  separatelyA  @               o  Making the product usable in an Open VMScluster                  environment  F         3.1 Running the Installation Verification Procedure Separately  E               You usually run the Installation Verification ProcedurenH               (IVP) during installation. If you have system problems andG               want to run the IVP separately to ensure the integrity ofl9               installed files, use the following command:N  '               $ @SYS$TEST:BASIC$IVP.COM             H                                        After Installing Compaq BASIC 3-1 n  l            9      3.2 Making Compaq BASIC Usable in an Open VMSclusterr          Environment  B            If you want to run Compaq BASIC on multiple nodes of anC            Open VMScluster environment, first check to see that youeC            have the appropriate software license (see Section 1.1).VE            Then, perform the following steps after you install Compaql            BASIC:   D            1. Enter the LICENSE LOAD command to activate the licenseC               on each node on which Compaq BASIC is to be executed.   C            2. Use the OpenVMS System Management (SYSMAN) utility to E               execute a set of commands on all cluster nodes, whether @               or not the nodes are licensed to use Compaq BASIC;E               failure to do so may cause unexpected errors for users.   C               ________________________Note ________________________,  A               If you are using a dual-architecture (VAX and Alphaa?               systems), heterogeneous cluster, before executingl?               these commands, make sure the appropriate logicalM<               names have been set to define the scope of the?               SYSMAN DO commands. For more information, see them6               OpenVMS system management documentation.  C               _____________________________________________________e  @               While logged in as SYSTEM, or as another user name=               that has the SETPRV privilege or the CMKRNL and0A               SYSPRV privileges, use SYSMAN to update the version 5               of DCLTABLES.EXE available, as follows:T  %               $ RUN SYS$SYSTEM:SYSMANw-               SYSMAN> SET ENVIRONMENT/CLUSTERO9               %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 NODE1l?               %SYSMAN-I-OUTPUT, command execution on node NODE2n  E               SYSMAN will cause each DO command to be executed on allm)               nodes of the local cluster.   &      3-2 After Installing Compaq BASIC f  e            G               3. If Compaq BASIC is installed as a known image, then do                   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  H               4. If the Compaq BASIC messages file is installed as 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. Exit from SYSMAN:                    SYSMAN> EXIT                   $  -         3.3 Setting User Account Requirementso  E               To work with Compaq BASIC, user accounts on your systemT+               must have certain privileges.r  %         3.3.1 User Account PrivilegesA  F               To use Compaq BASIC, each account must have at least theE               TMPMBX and NETMBX privileges. Use the OpenVMS Authorize D               utility to determine whether users have the privileges               they require.A                              H                                        After Installing Compaq BASIC 3-3 N  L                  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 BASICs#               full development kit.l  G               This installation was performed on an OpenVMS VAX VersionvF               V7.2 system that had no previous version of Compaq BASICE               installed. Depending on which layered products you haveeC               on your system, you might see additional messages andS;               questions when you perform your installation.L  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  A         $ @sys$update:vmsinstal BASIC039 DKA100:[BASIC] options n   H                 OpenVMS VAX Software Product Installation Procedure V7.2  #         It is dd-mmm-yyyy at hh:mm.   7         Enter a question mark (?) at any time for help.   F         * Are you satisfied with the backup of your system disk [YES]?  1         The following products will be processed:   H                                                 (continued on next page)  H                                                  Sample Installation A-1    e            9      Example A-1 (Cont.) Sample Compaq BASIC Installation           BASIC V3.9p  :              Beginning installation of BASIC V3.9 at hh:mm  ;      %VMSINSTAL-I-RESTORE, Restoring product save set A ...s  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 2I"              4.  None of the above        * Select option [2]: 407      * Do you want to continue the installation [NO]? ysP      %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.  7                Compaq BASIC V3.9 Installation Procedure   2         Copyright 2000 Compaq Computer Corporation  R         Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office.  K         All other product names mentioned herein may be trademarks of their6         respective companies.   O         Confidential computer software.  Valid license from Compaq required fornK         possession, use or copying.  Consistent with FAR 12.211 and 12.212,fJ         Commercial Computer Software, Computer Software Documentation, andO         Technical Data for Commercial Items are licensed to the U.S. Governmento3         under vendor's standard commercial license.   Q         Compaq shall not be liable for technical or editorial errors or omissions O         contained herein.  The information in this document is provided "as is"SM         without warranty of any kind and is subject to change without notice. O         The warranties for Compaq products are set forth in the express limited Q         warranty statements accompanying such products.  Nothing herein should be,9         construed as constituting an additional warranty.n  U      %VMSINSTAL-I-RELNOTMOV, A PostScript version of the release notes has been movedd       to SYS$HELP.  E                                              (continued on next page)         A-2 Sample Installation s  y            <         Example A-1 (Cont.) Sample Compaq BASIC Installation  L            There are three possible installation options. They are described            as follows:  >            1) Perform a complete installation of Compaq BASIC.  W            2) Install OpenVMS VAX system definitions text library only (10-45 minutes).e  N            3) Obtain a copy of the Compaq BASIC message text for modification.  .         * Which option do you want to use [1]:  C         * Do you want to install the Compaq BASIC HELP files [YES]?eX         * Do you want to install the OpenVMS VAX system definitions (10-45 min.) [NO]? yE         * Do you want to install the sample graphics programs [NO]? ym=         * Do you want to install the Motif definitions [YES]?   I         * Do you want to purge files replaced by this installation [YES]?   #                 Product:      BASICV!                 Producer:     DEC !                 Version:      3.9d)                 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 takeM            10 - 45 more minutes depending upon options chosen, configuration,             and system activity.h  >         %VMSINSTAL-I-RESTORE, Restoring product save set B ...X         %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSTE         ST.BASIC].  T             ************************************************************************Q             If you have Digital GKS for OpenVMS VAX V2.0 or later on your system, T             Compaq BASIC for OpenVMS VAX systems allows you to use graphics language&             statements. The procedure:  A                 SYS$SYSROOT:[SYSTEST.BASIC]BASIC$GRAPHICS_IVP.COM   Q             will verify that VAX BASIC graphics capabilities work on your system.$U             You must execute this procedure on a terminal with graphics capabilities.eT             ************************************************************************  H                                                 (continued on next page)  H                                                  Sample Installation A-3                 9      Example A-1 (Cont.) Sample Compaq BASIC Installationh  =      %VMSINSTAL-I-INSHELP, Installing Compaq BASIC Help filesdM      %VMSINSTAL-I-INSSAMPLE, Installing sample programs and PICTURE librariese;      %VMSINSTAL-I-RESTORE, Restoring product save set D ...nU      %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSHL       P.EXAMPLES.BASIC].S  N          *********************************************************************L          A number of sample programs demonstrating BASIC graphics statements5          have been copied to [SYSHLP.EXAMPLES.BASIC].   N          Read [SYSHLP.EXAMPLES.BASIC]BASIC_EXAMPLES.TXT for information on the"          sample programs provided.N          *********************************************************************  E      %VMSINSTAL-I-INSMOTIF, Installing Motif definitions and examplesr;      %VMSINSTAL-I-RESTORE, Restoring product save set C ...h  N          *********************************************************************?          The Motif bindings for BASIC files, DECW$MOTIF.BAS andS>          DECW$MOTIF_DEFS.BAS, have been copied to SYS$LIBRARY.  D          The BASIC$HELLOMOTIF and BASIC$MOTIFBURGER example programs+          have been copied to DECW$EXAMPLES. N          *********************************************************************  H      %VMSINSTAL-I-INSSTARLET, Installing Compaq BASIC system definitions?      %VMSINSTAL-I-INSSTARLT1, Requires approximately 15 minutes S      %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...   G      %VMSINSTAL-I-RUNIVP, Executing installation verification proceduree  H      Executing the Compaq BASIC V3.9 Installation Verification Procedure  1        Copyright 2000 Compaq Computer Corporation   Q        Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office.u  J        All other product names mentioned herein may be trademarks of their        respective companies.  E                                              (continued on next page)l          A-4 Sample Installation o  ,            <         Example A-1 (Cont.) Sample Compaq BASIC Installation  Q           Confidential computer software.  Valid license from Compaq required forrM           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. Governments5           under vendor's standard commercial license.   S           Compaq shall not be liable for technical or editorial errors or omissionsEQ           contained herein.  The information in this document is provided "as is" O           without warranty of any kind and is subject to change without notice. Q           The warranties for Compaq products are set forth in the express limitedmS           warranty statements accompanying such products.  Nothing herein should be ;           construed as constituting an additional warranty.t  K         %VMSINSTAL-I-IVPSUCCESS, Compaq BASIC V3.9 Installation test PASSED   0         The Compaq BASIC V3.9 IVP has succeeded!  =                 Installation of BASIC V3.9 completed at hh:mmp  1                 VMSINSTAL procedure done at hh:mm   	         $n                                          H                                                  Sample Installation A-5                       H                                                                        BH         ________________________________________________________________  H                                           Files Installed on Your System               B.1 Installed Filesu  @               The Compaq BASIC installation procedure installs aE               number of files on your system and defines some logical D               names. The first list shows the files installed duringG               installation. The second list shows the files modified by                the installation.s  0               Files Provided by the Installation  .                  SYS$COMMON:[SYSEXE]BASIC.EXE;F                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]BASIC$GRAPHICS.OLB;F                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]BASIC$GRAPHICS.TLB;F                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]BASIC_EXAMPLES.COM;F                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]BASIC_EXAMPLES.TXT;=                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]CLOCK.BAS;a3                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]t)                     CREATE_SWAN_SWIM.BAS;uF                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]DRAW_HISTOGRAM.BAS;?                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]ELLIPSE.BAS; A                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]FONT_DEMO.BAS; =                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]PARTY.BAS; B                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]PIE_DRIVER.BAS;C                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]PLOT_DRIVER.BAS;tG                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]ROTATED_SQUARES.BAS;e<                  SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]SINE.BAS;G                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$HELLOMOTIF.BAS; G                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$HELLOMOTIF.UIL; H                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER.BAS;H                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER.UIL;2                  SYS$COMMON:[SYSHLP.EXAMPLES.DECW]/                     BASIC$MOTIFBURGER_DEFS.BAS;p;                  SYS$COMMON:[SYSHLP]BASIC039.RELEASE_NOTES; >                  SYS$COMMON:[SYSHLP]BASIC039_RELEASE_NOTES.PS;2                  SYS$COMMON:[SYSHLP]BASICHELP.HLB;  H                                       Files Installed on Your System B-1 o  e            3               SYS$COMMON:[SYSLIB]BASIC$STARLET.TLB;o0               SYS$COMMON:[SYSLIB]DECW$MOTIF.BAS;5               SYS$COMMON:[SYSLIB]DECW$MOTIF_DEFS.BAS;o/               SYS$COMMON:[SYSMSG]BASIC$MSG.EXE;n0               SYS$COMMON:[SYSTEST]BASIC$IVP.COM;?               SYS$COMMON:[SYSTEST.BASIC]BASIC$GRAPHICS_IVP.BAS; ?               SYS$COMMON:[SYSTEST.BASIC]BASIC$GRAPHICS_IVP.COM; 6               SYS$COMMON:[SYSTEST.BASIC]BASIC$IVP.BAS;  -            Files Modified by the Installation   -               SYS$COMMON:[SYSHLP]HELPLIB.HLB;r/               SYS$COMMON:[SYSLIB]DCLTABLES.EXE; 6               SYS$COMMON:[SYSMGR]VMS$IMAGES_MASTER.DAT                                                              '      B-2 Files Installed on Your Systemr                       H                                                                        CH         ________________________________________________________________  H                                                   Recovering from Errors      A               This appendix provides information to help you deal E               with failures or errors that might occur during productl*               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 torD               continue. To stop the installation process and correctG               the situation, enter N or press Return. Then, correct the 3               problem and restart the installation.2  D               If errors occur during the installation itself or whenG               the Installation Verification Procedure (IVP) is running,rF               VMSINSTAL displays failure messages. If the installation3               fails, you see the following message:   \               %VMSINSTAL-E-INSFAIL, The installation of Compaq BASIC Version 3.9 has failed!  7               If the IVP fails, you see these messages:t  :               The Compaq BASIC Version 3.9 IVP has failed!  V               %VMSINSTAL-E-IVPFAIL, Compaq BASIC Version 3.9 Installation test FAILED.  D               Errors can occur during the installation if any of the)               following conditions exist:t  ;               o  The operating system version is incorrect._  >               o  A prerequisite software version is incorrect.  A               o  Quotas necessary for successful installation areT                  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 c  a            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 actionm'            as described in the message.r  <            For information on installation requirements, see            Chapter 1.o  $      C.2 Failures During Product Use  C            If you encounter a problem while using Compaq BASIC, and>D            your software contract or warranty agreement entitles you-            to telephone support, call 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 instructionsI>            provided by Compaq for reporting SPD nonconformance            problems.  <            When you submit a problem report, kindly take the            following steps:   B            1. Describe as accurately as possible the circumstances@               and state of the system when the problem occurred.B               Include in the description the version number of theE               OpenVMS system and Compaq BASIC being used. Demonstrate 1               the problem with specific examples.X  @            2. Reduce the problem to as small a size as possible.  @            3. Remember to include listings of any command files,?               INCLUDE files, relevant data files, and so forth.   /            4. Provide a listing of the program.3  C            5. If the program is longer than 50 lines, submit a copy ?               of it electronically or on machine-readable media_D               (floppy diskette or magnetic tape). If necessary, alsoD               submit a copy of the program library used to build the               application.        C-2 Recovering from Errors 