HP BASIC for OpenVMS Alpha_Systems_________________________________ Installation Guide April 2005 This guide describes how to install HP BASIC on the HP OpenVMS Alpha Systems operating system. Revision/Update Information: This guide supersedes the Compaq BASIC for OpenVMS Alpha Systems Installation Guide, Version 1.5 Operating System: OpenVMS Alpha Version 6.2 to Version 8.2 Software Version: HP BASIC Version 1.6 Hewlett-Packard Company Palo Alto, California __________________________________________________________ © Copyright 2005 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Printed in the US ZK6398 This document was prepared using DECdocument, Version 3.3-1b. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing for HP BASIC Installation 1.1 Registering Your Software License ........... 1-1 1.2 Required Hardware............................ 1-2 1.3 Required Operating System Components and Software..................................... 1-2 1.4 Installation Procedure Requirements.......... 1-2 1.5 VMSINSTAL Checks............................. 1-3 1.6 Account Privileges........................... 1-3 1.7 Disk Space................................... 1-3 1.8 Backing Up Your System Disk.................. 1-4 1.9 Standard System Maintenance Procedures....... 1-4 1.9.1 Checking and Setting Process Account Quotas................................... 1-5 1.9.2 Checking System Parameter Values......... 1-5 1.9.3 Changing System Parameter Values with AUTOGEN.................................. 1-6 1.9.4 Setting Dynamic Parameter Values......... 1-7 2 Installing HP BASIC 2.1 Installation Procedure....................... 2-1 2.2 Installing the HP BASIC Translator Run-Time Library...................................... 2-11 2.3 Installing the HP BASIC Translator RMS Server....................................... 2-12 iii 3 After Installing HP BASIC 3.1 Running the Installation Verification Procedure Separately......................... 3-1 3.2 Making HP BASIC Usable in an Open VMScluster Environment.................................. 3-2 3.3 Making the HP BASIC Translator Usable in an OpenVMS Cluster Environment.................. 3-3 3.4 Setting User Account Requirements............ 3-4 3.4.1 User Account Privileges.................. 3-5 A Sample Installation B Files Installed on Your System B.1 Installed Files.............................. B-1 C Recovering from Errors C.1 Failures During Product Installation......... C-1 C.2 Failures During Product Use.................. C-2 Examples A-1 Sample HP BASIC Installation............. A-1 Tables 1-1 Disk Space Requirements.................. 1-3 iv ________________________________________________________________ Preface This guide describes how to install HP BASIC on the OpenVMS Alpha operating system. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall HP BASIC for any other reason. Intended Audience This guide is intended for system managers who install HP BASIC. Document Structure This guide contains the following chapters and appendixes: o Chapter 1 describes the preparations necessary for installing HP BASIC. o Chapter 2 describes how to install HP BASIC. o Chapter 3 describes postinstallation tasks. o Appendix A shows a sample HP BASIC installation. o Appendix B lists the files installed on your system during the HP BASIC installation. o Appendix C describes how to recover from failures and errors that may occur during installation and product use. v Related Documents In addition to this guide, the HP BASIC documentation set includes the following: o The HP BASIC for OpenVMS Systems User Manual o The HP BASIC for OpenVMS Systems Reference Manual o A letter titled Read Before Installing or Using HP BASIC Version 1.6 for OpenVMS Alpha Systems o The HP BASIC online release notes, which provide more information about HP BASIC. The release notes are located in (n is the minor point release): SYS$HELP:BASIC01n.RELEASE_NOTES Reader's Comments HP welcomes your comments on this manual. Please send comments to either of the following addresses: Internet openvmsdoc@hp.com Postal Hewlett-Packard Company Mail OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 You can also send email to: basic_docs@hp.com Conventions The following typographic conventions might be used in this manual: Ctrl/x A sequence such as Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. PF1 x A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button. vi In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets, rather than a box. . . . A horizontal ellipsis in examples indi- cates one of the following possibilities: o Additional optional arguments in a statement have been omitted. o The preceding item or items can be repeated one or more times. o Additional parameters, values, or other information can be entered. . A vertical ellipsis indicates the . omission of items from a code example . or command format; the items are omitted because they are not important to the topic being discussed. ( ) In command format descriptions, parentheses indicate that you must enclose choices in parentheses if you specify more than one. [ ] In command format descriptions, brackets indicate optional choices. You can choose one or more items or no items. Do not type the brackets on the command line. However, you must include the brackets in the syntax for OpenVMS directory specifications and for a substring specification in an assignment statement. vii | In command format descriptions, vertical bars separate choices within brackets or braces. Within brackets, the choices are optional; within braces, at least one choice is required. Do not type the vertical bars on the command line. { } In command format descriptions, braces indicate required choices; you must choose at least one of the items listed. Do not type the braces on the command line. bold type Bold type represents the introduction of a new term. It also represents the name of an argument, an attribute, or a reason. italic type Italic type indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER=name), and in command parameters in text (where dd represents the predefined code for the device type). UPPERCASE TYPE Uppercase type indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege. - A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line. numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes-binary, octal, or hexadecimal-are explicitly indicated. viii 1 ________________________________________________________________ Preparing for HP BASIC Installation Your distribution kit includes a letter titled Read Before Installing or Using HP BASIC Version 1.6 for OpenVMS Alpha Systems. This letter discusses important information that might not be included in this guide. You should read this letter now. You should also read the HP BASIC Release Notes before continuing with the installation. For information about accessing the Release Notes, see Chapter 2. 1.1 Registering Your Software License Before you install and run HP BASIC Version 1.6 on a newly licensed node or an Open VMScluster environment, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. If you are installing HP BASIC as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. If you are installing prerequisite or optional software along with HP BASIC, review the PAK status and install the PAKs for any prerequisite or optional software before you install HP BASIC. You must register and load your license for HP BASIC before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software. Preparing for HP BASIC Installation 1-1 To register a license under the OpenVMS operating system, first log in to a privileged account. You then have a choice of two ways to perform the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. If you plan to use HP BASIC on more than one node in an Open VMScluster environment, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.2 for more information. For complete information about using the LMF, see the HP OpenVMS License Management Utility Manual. 1.2 Required Hardware For a complete list of required hardware and supported processors, see the HP BASIC Version 1.6 Software Product Description (SPD). 1.3 Required Operating System Components and Software HP BASIC Version 1.6 for OpenVMS Alpha systems requires OpenVMS for Alpha Systems Version 6.2 to Version 8.2 (Version 7.1 to Version 8.2 with IEEE floating-point support). The following optional software can be used with HP BASIC: o Oracle CDD/Repository o Language-Sensitive Editor o Source Code Analyzer 1.4 Installation Procedure Requirements This section describes the requirements for installing HP BASIC (process account quotas, system parameters, disk space, and so on). 1-2 Preparing for HP BASIC Installation 1.5 VMSINSTAL Checks VMSINSTAL checks: o If the user is logged in to a privileged account o If any other processes are running on the system o If minimum account quotas are met 1.6 Account Privileges To install HP BASIC, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV Note that VMSINSTAL turns off BYPASS privilege at the start of the installation. Privileges required for product use are defined in Section 3.4.1. 1.7 Disk Space HP BASIC requirements for free disk storage space are different during installation and after installation. The total blocks needed include Help, Starlet, and Motif files. Table 1-1 summarizes the storage requirements. Table_1-1_Disk_Space_Requirements_________________________ Blocks During Blocks After Kit______________Installation__________Installation_______ HP BASIC 53500 44900 Version 1.6 HP BASIC 4400 4400 Translator Version 1.3 (continued on next page) Preparing for HP BASIC Installation 1-3 Table_1-1_(Cont.)__Disk_Space_Requirements________________ Blocks During Blocks After Kit______________Installation__________Installation_______ HP BASIC 20000 20000 Translator RTL_Version_1.3___________________________________________ To determine the number of free disk blocks on the target disk, enter the following command at the DCL prompt: $ SHOW DEVICE device_name 1.8 Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. It is recommended that you do a system disk backup before installing any software. Use the backup procedures that are established at your site. For details about performing a system disk backup, see the section on the Backup utility in the HP OpenVMS System Manager's Manual. 1.9 Standard System Maintenance Procedures This section explains how to do various standard procedures: o Check and set process account quotas o Check system parameter values o Change parameter values with the OpenVMS AUTOGEN command procedure o Set dynamic parameter values with the OpenVMS System Generation utility (SYSGEN) 1-4 Preparing for HP BASIC Installation 1.9.1 Checking and Setting Process Account Quotas User account quotas are stored in the file SYSUAF.DAT. Use the OpenVMS Authorize utility (AUTHORIZE) to verify and change user account quotas. First set your directory to SYS$SYSTEM and then run AUTHORIZE: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> At the UAF> prompt, enter the SHOW command with an account name to check a particular account. For example: UAF> SHOW SMITH To change a quota, enter the MODIFY command. The following example changes the FILLM quota for the SMITH account and then exits from the utility: UAF> MODIFY SMITH /FILLM=50 UAF> EXIT After you exit from the utility, the system displays messages indicating whether changes were made. Once the changes have been made, you must log out and log in again for the new quotas to take effect. For more information about modifying account quotas, see the description of the Authorize utility in the OpenVMS System Management Subkit. 1.9.2 Checking System Parameter Values To check the values of your system parameters, enter the following command at the DCL prompt to invoke the System Generation utility (SYSGEN): $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The following example displays the value for the WSMAX system parameter: SYSGEN> SHOW WSMAX After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level. Preparing for HP BASIC Installation 1-5 1.9.3 Changing System Parameter Values with AUTOGEN Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file: SYS$SYSTEM:MODPARAMS.DAT To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value. To add a new parameter, add a line to the file that includes both the name of the parameter and its value. For example: WSMAX = 8096 To modify incremental parameters such as free global pagelets and global sections, use ADD_. The following example increases the global page setting by 2000: ADD_GBLPAGES = 2000 Note that when you set the page file quota, do not use a value that exceeds the amount of page file space available on the system. After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. The following command recalculates your system parameters and reboots the system: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect. The AUTOGEN utility automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK qualifier on the AUTOGEN command line. 1-6 Preparing for HP BASIC Installation For more information about using AUTOGEN, see the OpenVMS System Management Subkit. 1.9.4 Setting Dynamic Parameter Values Use the System Generation utility (SYSGEN) to set dynamic parameter values. Dynamic parameters changed with the SYSGEN WRITE ACTIVE command become active immediately without any need to reboot your system. Rebooting returns the dynamic parameter values to their previous settings. After you change the dynamic parameter values, complete the installation before rebooting the system. After you finish with the installation, you can reset the dynamic parameters to their previous values or let them be reset automatically when you next reboot your system. Preparing for HP BASIC Installation 1-7 2 ________________________________________________________________ Installing HP BASIC After you register and load the license PAK, the installation takes approximately 5 minutes, depending on your system configuration and the kit components chosen. If you encounter any failures during installation, see Appendix C. 2.1 Installation Procedure Mount the media. To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all the files it has created up to that point and exits. You can then start the installation again. When the system prompts you with a question during the installation procedure, the default answer is often listed in brackets ([]). To install HP BASIC, perform the following steps: 1. Log in to a privileged account and set your default device and directory to SYS$UPDATE. Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE 2. Invoke VMSINSTAL. $ @VMSINSTAL saveset-name device-name option-list VMSINSTAL is in the SYS$UPDATE directory. The elements that you specify when you invoke the VMSINSTAL command procedure are as follows: Installing HP BASIC 2-1 saveset-name The installation name for the component. For HP BASIC, enter the following installation name (n is the minor point release number): BASIC01n device-name The name of the device on which you have mounted the media and the directory containing the HP BASIC save set. For example, DKA300: is the device name used in examples in this guide. The directory is [BASIC01n.KIT]. To specify the device name on the @VMSINSTAL command line, enter: DKA300:[BASIC01n.KIT] option-list The word OPTIONS followed by one or more of the following option designators-A, G, L, N, R: o Auto_answer option (A) Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system). o Get save-set option (G) Lets you store product save sets temporarily on a magnetic tape or in a disk directory. o File log option (L) Logs all activity to the terminal during installa- tion. o Display or print the release notes (N) Indicates that you want to see the installation question on release notes. If you do not include the N option, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in 2-2 Installing HP BASIC case they contain additional information about the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify the N option. (Even if you omit the N option when you invoke VMSINSTAL, the HP BASIC release notes are copied automatically to the SYS$HELP directory.) o Alternate root option (R) Lets you install the product to a system root other than that of the running system. For detailed information on these software installation options, see the OpenVMS operating system documenta- tion. If you specify more than one option, separate each option with a comma, such as: OPTIONS A,N The following example invokes VMSINSTAL to install HP BASIC and shows the system response. This example uses the OPTIONS N release note option. $ @VMSINSTAL BASIC01n DKA300:[BASIC01n.KIT] OPTIONS N OpenVMS Software Product Installation Procedure V8.2 It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. If you do not supply the product name, or the device name, VMSINSTAL prompts you for this information later in the installation procedure. When you invoke VMSINSTAL, it checks whether you are logged in to a privileged account. It is recommended that you install software from the system manager's account with your default device and directory set to SYS$UPDATE. VMSINSTAL then checks to determine whether any users are logged in to the system. If users are logged in, VMSINSTAL asks whether you want to continue the installation: Installing HP BASIC 2-3 * Do you want to continue anyway [NO]? If you want to continue, enter Y. If you want to stop the installation, press Return. 3. Confirm system backup. * Are you satisfied with the backup of your system disk [YES]? If you are satisfied with the backup of your system disk, press Return. Otherwise, enter N to discontinue the installation. After you back up your system disk, you can restart the installation. If you omitted the device name on the VMSINSTAL command line, the following prompt appears: * Where will the distribution volumes be mounted: If this prompt appears, enter the name of the distribution (media) device and directory that contains the HP BASIC kit (save set). For example, if the media is contained on a CD-ROM located on unit DKA300:, enter DKA300:[BASIC01n.KIT] in reply to this question (where n is the minor version number). If you omitted the product name on the VMSINSTAL command line, the following prompt appears: Products: Enter the kit name, BASIC01n. If you did not choose an installation option at the options prompt on the VMSINSTAL command line, the following prompt appears and you can enter one of the installation options: Enter installation options you wish to use (none): N Depending on the type of device and whether the device is already mounted, the following prompt may appear: Please mount the first volume of the set on DKA300:. * Are you ready? YES %MOUNT-I-MOUNTED, DKA300: mounted If you have not already done so, you should now insert the distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in 2-4 Installing HP BASIC the line preceding the question. VMSINSTAL then asks if you are ready to continue with the installation. If you respond Y to indicate that you are ready, VMSINSTAL displays a message that the media containing HP BASIC has been mounted on the specified device and that the installation has begun. If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter N in response to the "Are you ready?" question. To stop the installation for other reasons, press Ctrl/Y. 4. Verify the product being installed. The following products will be processed: BASIC V1.n Beginning installation of BASIC V1.n at hh:mm %VMSINSTAL-I-RESTORE, Restoring product saveset A... The product name and version are displayed. The first save set (A) is restored to a subdirectory of SYS$UPDATE. 5. Select a release notes option. Release notes included with this kit are always copied to SYS$HELP. Aditional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: If you specified OPTIONS N when you invoked VMSINSTAL or at the options prompt, you are now asked to choose one of the options for reviewing the release notes. All options copy the release notes to SYS$HELP. If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C. Installing HP BASIC 2-5 If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use. Either supply the name of the print queue that you want to use or press Return to send the file to the default output print device. For example: * Queue name [SYS$PRINT]: CLUSTER_PRINT If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. If you select option 4, the installation procedure will only copy the release notes to the SYS$HELP directory. Next, VMSINSTAL asks if you wish to continue the installation process. * Do you want to continue the installation [NO]? If you want to continue, enter Y. If you want to stop the installation, press Return. If you are continuing the installation, VMSINSTAL displays the following message: %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. %VMSINSTAL-I-RELNOTMOV, A PostScript version of the release notes has been moved to SYS$HELP. HP BASIC V1.n Installation Procedure © Copyright 2002-2005 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The release notes are copied to the following files in the SYS$HELP directory: BASIC01n.RELEASE_NOTES BASIC01n_RELEASE_NOTES.PS 2-6 Installing HP BASIC After the installation, you can enter the following command to view the location of the release notes through the Help facility: $ HELP BASIC RELEASE_NOTES 6. Select an installation option. The installation procedure lets you select the components of the kit that you want to install. The choices are as follows: There are six possible installation options. They are as follows: 1) Perform a complete installation of HP BASIC. 2) Install only OpenVMS Alpha system definitions text library (5-15 minutes). 3) Install only the Motif bindings and examples for BASIC. 4) Install only the HP BASIC language help library. 5) Obtain a copy of the HP BASIC message text for modification. 6) Install only the HP BASIC Translator. * Which option do you want to use [1]: If you specify option 1, which is the default, the installation continues. Select the components you want to install by answering Y or N to the questions. If you want a more detailed description of any component, enter a question mark (?). After the explanation is displayed, you are prompted again for a response. If you enter Y, the installation procedure installs the component. 7. Install OpenVMS Alpha system definitions. * Do you want to install the OpenVMS Alpha system definitions [NO]? This option generates a text library (SYS$LIBRARY:BASIC$STARLET.TLB) that contains OpenVMS Alpha system definitions. Depending on your processor and system load, creating this library takes approximately 5 to 15 minutes. The OpenVMS Alpha system definitions require 5000 blocks of disk space. Installing HP BASIC 2-7 Note: Beginning with OpenVMS Version 8.2, the BASIC$STARLET.TLB text library is included with OpenVMS and does not need to be installed separately. 8. Install Motif definitions. * Do you want to install the Motif definitions [YES]? Answering YES to this option puts the HP BASIC version of the Motif definitions, DECW$MOTIF.BAS, into the SYS$LIBRARY directory. These definitions require 1500 blocks of disk space and contain the Constant, Record, and External declarations needed to do Motif programming. Examples are also put into the DECW$EXAMPLES area provided it exists. Note that if the DECW$EXAMPLES area does not exist, the default for this question is NO, and the examples are not provided. 9. Install BASIC Help files. * Do you want to install the HP BASIC language HELP library [YES]? The Help files describe how to invoke HP BASIC from the DCL command line and the BASIC language features. The Help files require 400 blocks of disk space. It is recommended that you install these files. 10. Obtain the BASIC message file. * Do you want to copy the HP BASIC message file [NO]? The BASIC message source file contains the text of the HP BASIC messages that may be copied for customization purposes. It is placed in SYS$UPDATE:BASIC$MSG.MSG. The message file requires 100 blocks of disk space. Normally you do not need to copy this file. 11. Install the HP BASIC Translator. * Do you want to install the HP BASIC Translator [NO]? The HP BASIC Translator assists in translating HP BASIC source programs into Visual BASIC programs. Information about the Translator is provided in separate HP BASIC Translator Release Notes. The Translator requires 4400 blocks of disk space. 2-8 Installing HP BASIC If you elect to install the HP BASIC Translator, the following question is asked. * Do you want a copy of the HP BASIC Translator RTL [NO]? Answering YES to this option puts a copy of the HP BASIC Translator RTL file, DB2VB$DBTRTL_I.ZIP, into the SYS$LIBRARY directory. This file must be copied to and installed on the target Windows system (see Section 2.2 for information). The file is also available from the Internet, which is the recommended source for this file. Because DB2VB$DBTRTL_I.ZIP is large (20000 blocks) and is not used on the OpenVMS system, direct downloading from the Internet to the Windows system is simpler. See Section 2.2 for the Internet location of this file. 12. Purge files. * Do you want to purge files replaced by this installation [YES]? The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, SYS$SYSTEM, SYS$TEST, and SYS$EXAMPLES may contain previous versions of HP BASIC files. These files are replaced with new files during the installation, but the previous files are not automatically purged. Purging is recommended. In response to the purging prompt, press Return or enter Y to purge the files, or enter N to keep them. 13. Respond to license registration queries. HP BASIC supports the OpenVMS License Management Facility (LMF). The installation procedure displays license information about HP BASIC. It asks whether you have registered and loaded your Product Authorization Key (PAK) for each product. The following is an example of the information and the queries presented by the installation procedure: Product: BASIC Producer: DEC Version: 1.n Release Date: dd-mmm-yyyy * Does this product have an authorization key registered and loaded? Installing HP BASIC 2-9 If you have not registered and loaded your PAK, you must answer NO to this question. You have to register and load a PAK to successfully complete the installation (see Section 1.1). If you have not done so, you should stop the installation, register and load your PAK, and then restart the installation. 14. Read informational messages. At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new versions of the HP BASIC help text and the BASIC command-line definition. Also, if you answered Y in response to the prompt that requests a file purge, previous versions of the HP BASIC files are now purged. 15. Observe the IVP. VMSINSTAL now places the IVP files into the directory SYS$TEST and invokes the IVP to verify that HP BASIC and/or the HP BASIC Translator were installed successfully. You can also run the IVPs independently, after HP BASIC and/or the HP BASIC Translator are installed, to verify that the software is available on your system. You might need to run the IVPs after a system failure to make sure that users can access HP BASIC and/or the HP BASIC Translator. You can do this by invoking either of the following command procedures: $ @SYS$TEST:BASIC$IVP.COM or $ @SYS$TEST:DB2VB$IVP.COM 2-10 Installing HP BASIC If HP BASIC was installed successfully, the IVP displays the following: %VMSINSTAL-I-IVPSUCCESS, HP BASIC V1.n Installation test PASSED The HP BASIC V1.n IVP has succeeded! If the HP BASIC Translator was installed successfully, the IVP displays the following: %VMSINSTAL-I-IVPSUCCESS, HP BASIC Translator V1.n Installation test PASSED The HP BASIC Translator V1.n IVP has succeeded! 16. End the installation procedure. The end of the installation is indicated by the following message: Installation of BASIC V1.n completed at hh:mm Adding history entry in VMI$ROOT:{SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]BASIC01n.VMI_DATA VMSINSTAL procedure done at hh:mm Depending on whether you specified parameters on the VMSINSTAL command line, the * Products: prompt or the DCL prompt ($) may appear. If the * Products: prompt appears, you can return to the DCL prompt ($) by pressing Ctrl/Z. VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the installation account (such as SYSTEM) and you want to restore these symbols, you should log out and log in again. 2.2 Installing the HP BASIC Translator Run-Time Library The home page for the HP BASIC Translator for OpenVMS Systems is at: http://h71000.www7.hp.com/commercial/basic/db2vb_index.html Installing HP BASIC 2-11 The Run-Time Library for the HP BASIC Translator is available as a .ZIP file named DBTRTL_I.ZIP. See this location: http://h71000.www7.hp.com/commercial/basic/db2promo_readme.html It is also available in the compiler kit at SYS$LIBRARY:DB2VB$DBTRTL_I.ZIP. You must install the Run-Time Library on every Windows system that runs translated applications. Follow these steps to install the Run-Time Library: 1. Create an empty folder. The installation requires approximately six megabytes of disk space (four megabytes on the device where it is unpacked and two megabytes on the system device). 2. Make a copy of the Run-Time Library .ZIP file available either on some removable media or via a network connection. 3. Copy DBTRTL_I.ZIP or DB2VB$DBTRTL_I.ZIP as applicable to the empty folder (rename DB2VB$DBTRTL_I.ZIP to DBTRTL_I.ZIP). 4. Unpack the .ZIP file using an Unzip utility. 5. Run SETUP.EXE and follow the instructions. 2.3 Installing the HP BASIC Translator RMS Server Two images are required to provide the server side of the RMS support provided by the HP BASIC Translator RTL. These are: o DB2VB$SPAWNER.EXE o DB2VB$RMS_SERVER.EXE They have been placed in SYS$SYSTEM by the installation procedure. Also placed in SYS$SYSTEM during installation of the HP BASIC Translator are two sets of corresponding images, one for the VAX platform and one for the Alpha platform. They are named as follows: 2-12 Installing HP BASIC __________________________________________________________ VAX________________________ALPHA__________________________ DB2VB$SPAWNER.EXE_VAX DB2VB$SPAWNER.EXE_ALPHA DB2VB$RMS_SERVER.EXE_VAX___DB2VB$RMS_SERVER.EXE_ALPHA_____ To access RMS files from a translated application, the appropriate pair of server images must be copied and renamed to the server platform. For example, if the server platform is an Alpha machine, then the files DB2VB$SPAWNER.EXE_ALPHA and DB2VB$RMS_SERVER.EXE_ALPHA must be copied to the Alpha platform and renamed to have the .EXE file type, as follows: $ COPY SYS$SYSTEM:DB2VB$SPAWNER.EXE_ALPHA alpha_node::SYS$SYSTEM:DB2VB$SPAWNER.EXE $ COPY SYS$SYSTEM:DB2VB$RMS_SERVER.EXE_ALPHA alpha_node::SYS$SYSTEM:DB2VB$RMS_SERVER.EXE Installing HP BASIC 2-13 3 ________________________________________________________________ After Installing HP BASIC After HP BASIC is installed, it can be invoked by all users with the BASIC command. The installation procedure modifies the DCL command table so that the BASIC command is recognized and processed. However, the previous command table is still in effect for those users who are currently logged in. All logged-in users who want to use the BASIC command must log out and log in again, or use the following DCL command: $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES You can perform the following tasks after HP BASIC is installed: o Running the Installation Verification Procedure (IVP) separately o Making the product usable in an Open VMScluster environment 3.1 Running the Installation Verification Procedure Separately You usually run the Installation Verification Procedure (IVP) during installation. If you have system problems and want to run the IVP separately to ensure the integrity of installed files, use the following command: $ @SYS$TEST:BASIC$IVP.COM or $ @SYS$TEST:DB2VB$IVP.COM as appropriate. After Installing HP BASIC 3-1 3.2 Making HP BASIC Usable in an Open VMScluster Environment If you want to run HP BASIC on multiple nodes of an Open VMScluster environment, first check to see that you have the appropriate software license (see Section 1.1). Then, perform the following steps after you install HP BASIC: 1. Enter the LICENSE LOAD command to activate the license on each node on which HP BASIC is to be executed. 2. Use the OpenVMS System Management (SYSMAN) utility to execute a set of commands on all cluster nodes, whether or not the nodes are licensed to use HP BASIC; failure to do so may cause unexpected errors for users. ________________________Note ________________________ If you are using a dual-architecture heterogeneous cluster, before executing these commands, make sure the appropriate logical names have been set to define the scope of the SYSMAN DO commands. For more information, see the OpenVMS system management documentation. _____________________________________________________ While logged in as SYSTEM or as another user name that has the SETPRV privilege or the CMKRNL and SYSPRV privileges, use SYSMAN to update the version of DCLTABLES.EXE available, as follows: $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER %SYSMAN-I-ENV, current command environment: Clusterwide on local cluster Username SYSTEM will be used on nonlocal nodes SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 SYSMAN will cause each DO command to be executed on all nodes of the local cluster. 3-2 After Installing HP BASIC 3. If HP BASIC is installed as a known image, then do the following: SYSMAN> DO INSTALL REPLACE SYS$SYSTEM:BASIC.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 4. If the HP BASIC message file is installed as a known image, then do the following: SYSMAN> DO INSTALL REPLACE SYS$MESSAGE:BASIC$MSG.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 5. Finally, exit from SYSMAN: SYSMAN> EXIT $ 3.3 Making the HP BASIC Translator Usable in an OpenVMS Cluster Environment If you want to run the HP BASIC Translator on multiple nodes of an OpenVMS Cluster environment, first check to see that you have the appropriate software license (see Section 1.1). The HP BASIC Translator uses the same license as HP BASIC. Then, perform the following steps after you install the HP BASIC Translator: 1. Enter the LICENSE LOAD command to activate the license on each node on which the HP BASIC Translator is to be executed. 2. Use the OpenVMS System Management utility (SYSMAN) to execute a set of commands on all cluster nodes, whether or not the nodes are licensed to use the HP BASIC Translator. Failure to do so may cause unexpected errors for users. ________________________Note ________________________ If you are using a mixed-architecture (VAX and Alpha systems), heterogeneous cluster, before executing these commands, make sure the appropriate logical names have been set to define the scope of the After Installing HP BASIC 3-3 SYSMAN DO commands. For more information, see the OpenVMS system management documentation. _____________________________________________________ While logged in as SYSTEM or as another user name that has the SETPRV privilege or the CMKRNL and SYSPRV privileges, use SYSMAN to update the version of DCLTABLES.EXE available as follows: $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER %SYSMAN-I-ENV, current command environment: Clusterwide on local cluster Username SYSTEM will be used on nonlocal nodes SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 SYSMAN will cause each DO command to be executed on all nodes of the local cluster. 3. If the HP 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 HP BASIC Translator message file is installed as a known image, then enter the following: SYSMAN> DO INSTALL REPLACE SYS$MESSAGE:DB2VB$MSG.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 5. Finally, exit from SYSMAN: SYSMAN> EXIT $ 3.4 Setting User Account Requirements To work with HP BASIC, user accounts on your system must have certain privileges. 3-4 After Installing HP BASIC 3.4.1 User Account Privileges To use HP BASIC, each account must have at least the TMPMBX and NETMBX privileges. Use the OpenVMS Authorize utility to determine whether users have the privileges they require. After Installing HP BASIC 3-5 A ________________________________________________________________ Sample Installation This appendix provides a sample listing for the HP BASIC full development kit. Example A-1 Sample HP BASIC Installation $ @sys$update:vmsinstal basic016 DKA200:[BASIC.KIT] options n OpenVMS AXP Software Product Installation Procedure V7.3-1 It is 1-APR-2005 at 10:40. Enter a question mark (?) at any time for help. %VMSINSTAL-W-ACTIVE, The following processes are still active: TCPIP$FTP_1 _RTA2: * Do you want to continue anyway [NO]? y * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: BASIC V1.6 Beginning installation of BASIC V1.6 at 10:40 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: (continued on next page) Sample Installation A-1 Example A-1 (Cont.) Sample HP BASIC Installation 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 4 * Do you want to continue the installation [NO]? y %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. %VMSINSTAL-I-RELNOTMOV, A PostScript version of the release notes has been moved to SYS$HELP. HP BASIC V1.6 Installation Procedure © Copyright 2002-2005 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. There are six possible installation options. They are as follows: 1) Perform a complete installation of HP BASIC. 2) Install only OpenVMS Alpha system definitions text library (5-15 minutes). 3) Install only the Motif bindings and examples for BASIC. 4) Install only the HP BASIC language help library. 5) Obtain a copy of the HP BASIC message text for modification. 6) Install only the HP BASIC Translator. * Which option do you want to use [1]: * Do you want to install the OpenVMS Alpha system definitions [NO]? y * Do you want to install the Motif definitions [YES]? * Do you want to install the HP BASIC language HELP library [YES]? * Do you want to copy the HP BASIC message file [NO]? y * Do you want to install the HP BASIC Translator [NO]? y * Do you want a copy of the HP BASIC Translator RTL [NO]? y (continued on next page) A-2 Sample Installation Example A-1 (Cont.) Sample HP BASIC Installation * Do you want to purge files replaced by this installation [YES]? Product: BASIC Producer: DEC Version: 1.6 Release Date: 11-NOV-2004 * Does this product have an authorization key registered and loaded? y No further questions will be asked. The installation will take 5 - 15 more minutes depending upon options chosen, configuration, and system activity. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.BASIC]. %VMSINSTAL-I-INSHELP, Installing HP BASIC environment emulator %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSHLP.EXAMPLES.BASIC]. %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-INSSTARLET, Installing HP BASIC system definitions %VMSINSTAL-I-INSSTARLET, may require up to approximately 15 minutes %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-INSMOTIG, Installing Motif definitions and examples %VMSINSTAL-I-RESTORE, Restoring product save set F ... %VMSINSTAL-I-INSHELP, Installing HP BASIC language Help file %VMSINSTAL-I-RESTORE, Restoring product save set G ... %VMSINSTAL-I-MSGLOC, BASIC$MSG.MSG will be placed in [SYSUPD] %VMSINSTAL-I-RELNOTMOV, Text and PostScript versions of the HP BASIC Translator release notes have been moved to SYS$HELP. %VMSINSTAL-I-RESTORE, Restoring product save set H ... %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DB2VB]. %VMSINSTAL-I-RESTORE, Restoring product save set I ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... © Copyright 2002 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. (continued on next page) Sample Installation A-3 Example A-1 (Cont.) Sample HP BASIC Installation %VMSINSTAL-I-DOIVP, Executing the HP BASIC V1.6 Installation Verification Procedure %VMSINSTAL-I-IVPSUCCESS, HP BASIC V1.6 Installation test PASSED The HP BASIC V1.6 IVP has succeeded! © Copyright 2002-2005 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. %VMSINSTAL-I-DOIVP, Executing the HP BASIC Translator V1.3 Installation Verification Procedure %VMSINSTAL-I-IVPSUCCESS, HP BASIC Translator V1.3 Installation test PASSED The HP BASIC Translator V1.3 IVP has succeeded! Installation of BASIC V1.6 completed at 10:50 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]BASIC016.VMI_DATA VMSINSTAL procedure done at 10:50 $ A-4 Sample Installation B ________________________________________________________________ Files Installed on Your System B.1 Installed Files The HP BASIC installation procedure installs a number of files on your system. The first list shows the files installed during installation. The second list shows the files modified by the installation. Note that this list assumes that all options were selected. Files Provided by the Installation SYS$COMMON:[SYSEXE]BASIC.EXE SYS$COMMON:[SYSEXE]DB2VB.EXE SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE_ALPHA SYS$COMMON:[SYSEXE]DB2VB$RMS_SERVER.EXE_VAX SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXE SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXE_ALPHA SYS$COMMON:[SYSEXE]DB2VB$SPAWNER.EXE_VAX SYS$COMMON:[SYSHLP.EXAMPLES.BASIC]BASIC$ENV.TPU SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$HELLOMOTIF.BAS SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$HELLOMOTIF.UIL SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER.BAS SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER.UIL SYS$COMMON:[SYSHLP.EXAMPLES.DECW]BASIC$MOTIFBURGER_ Files Installed on Your System B-1 DEFS.BAS SYS$COMMON:[SYSHLP]BASIC016.RELEASE_NOTES SYS$COMMON:[SYSHLP]BASIC016_RELEASE_NOTES.PS SYS$COMMON:[SYSHLP]DB2VB013.RELEASE_NOTES SYS$COMMON:[SYSHLP]DB2VB013_RELEASE_NOTES.PS SYS$COMMON:[SYSHLP]BASICHELP.HLB SYS$COMMON:[SYSLIB]DEC$BASRTL.EXE SYS$COMMON:[SYSLIB]BASIC$STARLET.TLB SYS$COMMON:[SYSLIB]DECW$MOTIF.BAS SYS$COMMON:[SYSLIB]DECW$MOTIF_DEFS.BAS SYS$COMMON:[SYSLIB]DB2VB$LIBRARY.TLB SYS$COMMON:[SYSLIB]DB2VB$DBTRTL_I.ZIP SYS$COMMON:[SYSMSG]BASIC$MSG.EXE SYS$COMMON:[SYSMSG]DB2VB$MSG.EXE SYS$COMMON:[SYSTEST]BASIC$IVP.COM SYS$COMMON:[SYSTEST.BASIC]BASIC$IVP.BAS SYS$COMMON:[SYSTEST]DB2VB$IVP.COM SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.BAS SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.BMK SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.EXE SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.VBP_BMK SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP.VPD_BMK SYS$COMMON:[SYSTEST.DB2VB]DB2VB$IVP_GBLS.BMK SYS$COMMON:[SYSUPD]BASIC$MSG.MSG Files Modified by the Installation SYS$COMMON:[SYSHLP]HELPLIB.HLB SYS$COMMON:[SYSLIB]DCLTABLES.EXE SYS$COMMON:[SYSLIB]IMAGELIB.OLB Files Provisionally Provided by the Installation SYS$COMMON:[SYSLIB]BASIC$STARLET.TLB SYS$COMMON:[SYSLIB]DEC$BASRTL.EXE B-2 Files Installed on Your System C ________________________________________________________________ Recovering from Errors This appendix provides information to help you deal with failures or errors that might occur during product installation or product use. C.1 Failures During Product Installation If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter Y to continue. To stop the installation process and correct the situation, enter N or press Return. Then correct the problem and restart the installation. If errors occur during the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of HP BASIC V1.6 has failed. If the IVP fails, you see these messages: %VMSINSTAL-E-IVPFAIL, HP BASIC Installation test FAILED. The HP BASIC V1.6 IVP has failed! Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o A prerequisite software version is incorrect. o Quotas necessary for successful installation are insufficient. o System parameter values for successful installation are insufficient. o The OpenVMS help library is currently in use. Recovering from Errors C-1 o The product license has not been registered and loaded. For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. For information about installation requirements, see Chapter 1. C.2 Failures During Product Use If you encounter a problem while using HP BASIC, and your software contract or warranty agreement entitles you to telephone support, call HP. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of warranty. If you encounter a problem during the warranty period, report the problem as previously indicated or follow alternate instructions provided by HP for reporting SPD nonconformance problems. C-2 Recovering from Errors