HP OpenVMS Systems Documentation

Content starts here

for OpenVMS I64 Systems

Installation Guide

January 2005

This guide describes how to install HP BASIC on the HP OpenVMS Industry Standard 64 for Integrity Servers operating system.

Revision/Update Information: This is a new manual.

Operating System: OpenVMS I64 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




This guide describes how to install HP BASIC on the OpenVMS I64 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:

  • Chapter 1 describes the preparations necessary for installing HP BASIC.
  • Chapter 2 describes how to install HP BASIC.
  • Chapter 3 describes postinstallation tasks.
  • Appendix A shows a sample HP BASIC installation.
  • Appendix B lists the files installed on your system during the HP BASIC installation.
  • Appendix C describes how to recover from failures and errors that may occur during installation and product use.

Related Documents

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

  • The HP BASIC for OpenVMS I64 Systems User Manual
  • The HP BASIC for OpenVMS I64 Systems Reference Manual
  • A letter titled Read Before Installing or Using HP BASIC Version 1.6 for OpenVMS I64 Systems
  • 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):


Reader's Comments

HP welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet openvmsdoc@hp.com
Postal Mail Hewlett-Packard Company
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

You can also send email to:



The following product names may appear in this manual:

  • HP OpenVMS Industry Standard 64 for Integrity Servers
  • OpenVMS I64
  • I64

All three names---the longer form and the two abbreviated forms---refer to the version of the OpenVMS operating system that runs on the Intel® Itanium® architecture.

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.
[Return] 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 indicates one of the following possibilities:
  • Additional optional arguments in a statement have been omitted.
  • The preceding item or items can be repeated one or more times.
  • 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.
| 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.

Chapter 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 I64 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.

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:

  • Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK.
  • 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 I64 systems requires OpenVMS for I64 Systems Version 8.2.

The following optional software can be used with HP BASIC:

  • Oracle CDD/Repository
  • Language-Sensitive Editor
  • 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.5 VMSINSTAL Checks


  • If the user is logged in to a privileged account
  • If any other processes are running on the system
  • 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:


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.7 System Parameters

Table 1-1 lists the minimum required system parameter values for the installation.

Table 1-1 Minimum Required System Parameter Values
System Parameter Minimum Value
Contiguous free global pagelets 1 7000
Global sections 1 3

1These values represent the number of free global pagelets and global sections required for the installation, not the total number you need to run your system and other software.

1.7.1 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-2 summarizes the storage requirements.

Table 1-2 Disk Space Requirements
Kit Blocks During Installation Blocks After Installation
HP BASIC Version 1.6 53500 44900

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:

  • Check and set process account quotas
  • Check system parameter values
  • Calculate values for global pagelets and global sections
  • Change parameter values with the OpenVMS AUTOGEN command procedure
  • Set dynamic parameter values with the OpenVMS System Generation utility (SYSGEN)

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:


At the UAF> prompt, enter the SHOW command with an account name to check a particular account. For example:


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:


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.10 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):


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:


After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level.

1.11 Calculating the Values for Global Pagelets and Global Sections

To install and run HP BASIC, you must have sufficient free global pagelets and global sections. You must first find out how many free global pagelets and sections you have on your system. Then use AUTOGEN if you need to increase the global pagelets and global sections system parameters.

Enter the following DCL command to determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE:


This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pagelets for the file.

You can use the WRITE command with the F$GETSYI lexical function to find the number of free global pagelets and global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT):


If the values displayed by the system are greater than the values in Table 1-1, you do not need to increase the values for these parameters. If the value of free global pagelets or global sections is less than the value in Table 1-1, you must increase the system parameter setting.

Section 1.12 describes the procedures for increasing these values using AUTOGEN.

1.12 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:


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:


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:


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.

For more information about using AUTOGEN, see the OpenVMS System Management Subkit.

1.13 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.

The dynamic parameter values for HP BASIC are listed in Table 1-1.

If the dynamic parameter values on your system are less than the values in Table 1-1, use the following series of commands to change the values. This example changes the value of CLISYMTBL:


Next Contents