HP Pascal for OpenVMS
1.4.3 Backing Up Your System Disk
At the beginning of the installation, VMSINSTAL asks if you have backed
up your system disk. HP recommends that you do a system disk backup
before installing HP Pascal or any other software.
Use the backup procedures that are established at your site. For
details on performing a system disk backup, see the section on the
Backup Utility in the OpenVMS system management documentation.
1.5 Stopping the Installation
To stop the installation procedure at any time, use Ctrl/C. However,
files created up to that point are not deleted. You must then delete
these files interactively. Chapter 2 lists the directories and files
created during the
HP Pascal installation.
Installing HP Pascal
This chapter explains how to install HP Pascal:
- Section 2.1 contains a step-by-step description of the
- Section 2.2 describes error recovery considerations.
2.1 Installation Procedure
The HP Pascal installation procedure consists of a series of
questions and informational messages.
If you have not already done so, insert the Compact Disc (CD) or tape
media into the CD drive or tape drive.
To abort the installation procedure at any time, press Ctrl/Y. When you
press Ctrl/Y, the installation procedure deletes all files it has
created up to that point and exits. You can then start the installation
When the system prompts you with a question during the installation
procedure, the default answer, if any, is enclosed in brackets ().
To start the installation:
- Invoke the VMSINSTAL command procedure.
should invoke the VMSINSTAL command procedure from a privileged
account, such as the SYSTEM account. The VMSINSTAL procedure is in the
SYS$UPDATE directory. For example:
The following list defines the elements of the VMSINSTAL procedure:
$ SET DEFAULT SYS$UPDATE
$ @SYS$UPDATE:VMSINSTAL (saveset-name) (device-name) [option-list]
The installation name for the component. For HP Pascal, use the
following installation name:
To obtain the directory location of the HP Pascal save set on the
distribution media, see the documentation that accompanies the media.
Or, you can do the following before starting the installation:
- To determine whether the CD drive is already mounted, enter the
If it is not mounted, enter the appropriate MOUNT command to mount the
CD (omit the /FOREIGN qualifier).
- To obtain the directory name, enter the following command:
$ DIRECTORY DKA400:*pascal*.dir
- To obtain the save set name, use the DIRECTORY command specifying
the directory file from the previous command:
$ DIRECTORY DKA400:[PASCAL05n.KIT]*.A
The name of the device on which you plan to mount the media and the
directory containing the HP Pascal save set. In the following
example, the device name is DKA400: and the directory is
[PASCAL05n.KIT]. For tape installations, just enter the name of the
To specify the device name on the @VMSINSTAL command
DKA400: is the name of the CD drive used in the rest of the
examples in this guide.
The word OPTIONS followed by one or more of the following option
designators: A, L, N, R. Their meanings are as follows:
For detailed information on these VMSINSTAL options, see the
OpenVMS documentation on software installation in the
OpenVMS System Management Subkit.
- 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).
- File log option (L)
Logs all activity to the terminal during
- 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 OPTIONS N parameter, 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 OPTIONS
Even if you omit the N option when you invoke VMSINSTAL, the
HP Pascal release notes are copied automatically to the SYS$HELP
- Alternate root option (R)
Allows you to install the product to
a system root other than that of the running system.
If you specify multiple
options, use commas to separate the options, for example:
When you invoke VMSINSTAL, it checks the following:
The following example invokes VMSINSTAL to install HP Pascal and
shows the system response. This example uses the OPTIONS N release note
- Whether you are logged in to a privileged account
that you install software from the system manager's account with your
default device and directory set to SYS$UPDATE.
- Whether you have sufficient quotas for installation
$ @SYS$UPDATE:VMSINSTAL PASCAL05n DKA400:[PASCAL05n.kit] OPTIONS N
OpenVMS Software Product Installation Procedure Vn.n
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.
VMSINSTAL does not prompt you for any options, so be sure to include
whatever option you want on the VMSINSTAL command line.
- Confirm system backup.
VMSINSTAL asks if you are satisfied with your system backup. You should
always back up your system disk before performing an installation. If
you are satisfied with the backup of your system disk, press the Return
key. Otherwise, enter NO to discontinue the installation. After you
back up your system disk, you can restart the installation.
* Are you satisfied with the backup of your system disk [YES]?
fail to include the device name of the VMSINSTAL command line, the
following prompt is displayed:
If this prompt is displayed, type the name of the distribution (media)
device and directory that contains the HP Pascal kit (save set).
For example, if the media is contained on a CD located on unit DKA400:,
type DKA400:[PASCAL05n.KIT] in reply to this question, as shown in the
* Where will the distribution volumes be mounted:
* Where will the distribution volumes be mounted:DKA400:[PASCAL05n.KIT]
- Verify the product being installed.
following products will be processed:
The product name and version are displayed. The first save set (A) is
restored to a subdirectory of SYS$UPDATE.
Beginning installation of PASCAL V5.n at hh:mm
%VMSINSTAL-I-RESTORE, Restoring product saveset A...
- Select a release notes option.
Release notes included with this kit are always copied to SYS$HELP.
Additional Release Notes Options:
1. Display release notes
2. Print release notes
3. Both 1 and 2
4. None of the above
* Select option :
If you specified OPTIONS N when you invoked VMSINSTAL, you are now
asked to choose one of the four options for reviewing the release notes:
- 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:
You can then enter a queue name or press Return to send the file to the
default output print device.
* Queue name [SYS$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 of the release notes.
- If you choose option 4, the release notes are not displayed or
printed but are still copied to the following file in the SYS$HELP
You can later use the HELP command to find the location of the
release notes in the Help facility:
Whichever option you choose, VMSINSTAL next asks the following question:
$ HELP PASCAL RELEASE_NOTES
* Do you want to continue the installation [NO]?: YES
%VMSINSTAL-I-RELMOVED, The product's release notes have been
successfully moved to SYS$HELP.
To continue the installation, enter YES. Otherwise, press Return.
In either case, the release notes are copied to a file in the SYS$HELP
The name of the release notes file installed by VMSINSTAL consists of
the current product name (in this case, PASCAL) and version
number (in this case, 059 for Version 5.9). Do not delete release notes
for previous versions of HP Pascal.
- Install the compiler.
The HP Pascal kit contains the compiler, message files, command
line definition, and help files.
* Do you want to install the HP Pascal compiler [YES]?
- Install STARLET.
The HP Pascal kit contains definition files for OpenVMS
System Services and several run-time library facility codes. These
system definition files are built using information shipped with the
OpenVMS operating system.
* Do you want to install the HP Pascal definition files [YES]?
The installation procedure
determines whether HP Pascal definition files already exist. If the
files do not exist, the installation procedure notifies you of this and
advises you to create the definition files.
If the HP Pascal
definition files exist, but the system definitions supplied by
OpenVMS (which are the basis for the HP Pascal definition
files) have been modified since the last time the HP Pascal
definition files were created, the installation procedure advises you
to recreate the files.
If the HP Pascal definition files exist
and if the system definitions supplied by OpenVMS have not been
modified since the last time the
HP Pascal definition files were created, the procedure tells you
that it is not necessary to recreate the definition files.
- Install the examples.
The HP Pascal kit contains a set of example programs using many
features of HP Pascal and OpenVMS. The examples are installed
in the directory SYS$COMMON:[SYSHLP.EXAMPLES.PASCAL]. You can access
them using the logical PASCAL$EXAMPLES, if you run the optional startup
file SYS$STARTUP:PASCAL$STARTUP.COM (see Section 3.3).
* Do you want to install the HP Pascal example programs [YES]?
- Save previous compiler.
The HP Pascal kit contains support to save your existing
HP Pascal compiler for access later. The installation provides
various command files to display and select the saved HP Pascal
compilers. See Section 1.3 for more information.
* Do you want to save your existing HP Pascal compiler [NO]?
- Purge files.
You have the option to purge files from previous versions of
HP Pascal that are superseded by this installation. Purging is
recommended. If you answered YES to question 8, you can answer YES to
this question with no danger of deleting any saved compilers.
* Do you want to purge files replaced by this installation [YES]?
- Choose the Installation Verification Procedure (IVP)
The installation procedure now asks if you want to
run the IVP. The IVP for HP Pascal checks that the installation is
successful. HP recommends that you run the IVP.
This kit contains an IVP that is used to verify the correct
installation of the HP Pascal compiler. The IVP is located in:
* Do you want to run the IVP after the installation [YES]?
After HP Pascal is installed, you can run the IVP independently 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
- Respond to license registration queries.
Release Date: dd-mmm-yyyy
* Does this product have an authorization key registered and loaded?
The installation procedure displays license information about your
product and then asks if you have registered and loaded your Product
Authorization Key (PAK).
If you have not registered and loaded your
PAK, you must answer NO to this question. You must register and load
your PAK to successfully complete the installation. If you have not
done so, you should stop the installation, register and load your PAK,
and then start the installation procedure again.
- 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.
If you chose to have files purged, that work is done now. The following
message is displayed:
%VMSINSTAL-I-MOVEFILES, files will now be moved to their
- Observe the Installation Verification Procedure
(IVP). If you chose to run the IVP, VMSINSTAL runs it now.
When the IVP runs successfully, you see the following messages
** Successful Installation of HP Pascal V5.9 on 16-JUN-2004 at 13:35 **
Compiler Version = HP Pascal V5.9
* Installation Verification Procedure for *
* HP Pascal STARLET libraries *
- End the installation procedure.
These messages indicate that the entire installation procedure is
Installation of HP Pascal V(n.n) completed at hh:mm
VMSINSTAL procedure done at hh:mm
You can now log out of the privileged account:
SYSTEM logged out at dd-mmm-yyyy 20:20:02
VMSINSTAL deletes or changes entries in the process symbol tables
during the installation. Therefore, if you are going to continue using
the system manager's account and you want to restore these symbols, you
should log out and log in again.
2.2 Error Recovery
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:
If the IVP fails, you see these messages:
%VMSINSTAL-E-INSFAIL, The installation of HP Pascal V(n.n) has failed.
Errors can occur during the installation if any of the following
The HP Pascal V(n.n) Installation Verification Procedure failed.
%VMSINSTAL-E-IVPFAIL, The IVP for HP Pascal V(n.n) has failed.
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 on
installation requirements, see Section 1.4.
- The operating system version is incorrect.
- Quotas necessary for successful installation are insufficient.
- System parameter values for successful installation are
- The OpenVMS help library is currently in use.
- The product license has not been registered and loaded.