 |
HP BASIC
for OpenVMS I64
Systems
Installation Guide
Chapter 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:
- Log in to a privileged account and set your default device
and directory to SYS$UPDATE.
Username: SYSTEM
Password:
$ SET DEFAULT SYS$UPDATE
|
- 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:
saveset-name
The installation name for the component. For HP BASIC, enter the
following installation name (n is the minor point release
number):
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:
option-list
The word OPTIONS followed by one or more of the following option
designators---A, G, L, N, R:
- 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).
- Get save-set option (G)
Lets you store product save sets
temporarily on a magnetic tape or in a disk directory.
- File log option (L)
Logs all activity to the terminal during
installation.
- 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 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.)
- 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 documentation. If you specify more
than one option, separate each option with a comma, such as:
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 E8.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:
* Do you want to continue anyway [NO]?
|
If you want to continue, enter Y. If you want to stop the
installation, press Return.
- 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:
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 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.
- 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.
- 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.
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 1993-2004 HP Information Technologies Group, 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
|
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
|
- 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 four possible installation options. They are as follows:
1) Perform a complete installation of HP BASIC.
2) Install only the Motif bindings and examples for BASIC.
3) Install only the HP BASIC language help library.
4) Obtain a copy of the HP BASIC message text for modification.
* 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.
- 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.
- 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.
- 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.
- 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.
- 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?
|
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.
- 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.
- Observe the IVP.
VMSINSTAL now places the IVP
files into the directory SYS$TEST and invokes the IVP to verify that
HP BASIC was installed successfully. You can also run the IVP
independently, after HP BASIC is installed, to verify that the
software is available on your system. You might need to run the IVP
after a system failure to make sure that users can access
HP BASIC. You can do this by invoking the following command
procedure:
$ @SYS$TEST:BASIC$IVP.COM.
|
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!
|
- 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.
Chapter 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:
- Running the Installation Verification Procedure (IVP) separately
- 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
|
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:
- Enter the LICENSE LOAD command to activate the license on each node
on which HP BASIC is to be executed.
- 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.
- 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
|
- 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
|
- Finally, exit from SYSMAN:
3.3 Setting User Account Requirements
To work with HP BASIC, user accounts on your system must have
certain privileges.
3.3.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.
|
