|
HP OpenVMS Systems Documentation |
|
HP BASIC
|
| Contents |
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.
This guide is intended for system managers who install HP BASIC.
This guide contains the following chapters and appendixes:
In addition to this guide, the HP BASIC documentation set includes the following:
SYS$HELP:BASIC01n.RELEASE_NOTES |
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:
basic_docs@hp.com |
The following product names may appear in this manual:
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:
|
|
.
. . |
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. |
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:
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:
This section describes the requirements for installing HP BASIC
(process account quotas, system parameters, disk space, and so on).
1.5 VMSINSTAL Checks
VMSINSTAL checks:
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.
| System Parameter | Minimum Value |
|---|---|
| Contiguous free global pagelets 1 | 7000 |
| Global sections 1 | 3 |
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.
| 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 |
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:
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.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):
$ 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.
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:
$ DIR/SIZE 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):
$ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")
15848
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")
24
|
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:
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.
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:
$ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE ACTIVE SYSGEN> SET CLISYMTBL new_value SYSGEN> WRITE ACTIVE SYSGEN> EXIT |
| Next | Contents |