HP OpenVMS Systems Documentation

HP Pascal for OpenVMS
Installation Guide

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.

This chapter explains how to install HP Pascal:

• Section 2.1 contains a step-by-step description of the installation procedure.
• Section 2.2 describes error recovery considerations.

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

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:

1. Invoke the VMSINSTAL command procedure.
   You 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:

   Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE $ @SYS$UPDATE:VMSINSTAL (saveset-name) (device-name) [option-list]

   The following list defines the elements of the VMSINSTAL procedure:

   saveset-name

   The installation name for the component. For HP Pascal, use the following installation name:

   PASCAL05n

   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 following command:

     $ SHOW DEVICE DKA400:

     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:[000000]*pascal*.dir Directory DKA400:[000000] PASCAL05n.DIR;1

   • To obtain the save set name, use the DIRECTORY command specifying the directory file from the previous command:

     $ DIRECTORY DKA400:[PASCAL05n.KIT]*.A

   device-name

   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 tape device.
   To specify the device name on the @VMSINSTAL command line, enter:

   DKA400:[PASCAL05n.KIT]

   
   DKA400: is the name of the CD drive used in the rest of the examples in this guide.

   option-list

   The word OPTIONS followed by one or more of the following option designators: A, L, N, R. Their meanings are as follows:

   • 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 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 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 N.

     Note Even if you omit the N option when you invoke VMSINSTAL, the HP Pascal release notes are copied automatically to the SYS$HELP directory.

   • Alternate root option (R)
     Allows you to install the product to a system root other than that of the running system.

   For detailed information on these VMSINSTAL options, see the OpenVMS documentation on software installation in the OpenVMS System Management Subkit.
   If you specify multiple options, use commas to separate the options, for example:

   OPTIONS A,N

   
   When you invoke VMSINSTAL, it checks the following:
   • Whether you are logged in to a privileged account
     HP recommends 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
   The following example invokes VMSINSTAL to install HP Pascal and shows the system response. This example uses the OPTIONS N release note option.

   $ @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.
2. Confirm system backup.

   * Are you satisfied with the backup of your system disk [YES]?

   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.
   If you fail to include the device name of the VMSINSTAL command line, the following prompt is displayed:

   * Where will the distribution volumes be mounted:

   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 following example:

   * Where will the distribution volumes be mounted:DKA400:[PASCAL05n.KIT]

3. Verify the product being installed.
   The following products will be processed:

   PASCAL V5.n Beginning installation of PASCAL V5.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.
4. 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 [2]:

   
   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:

     * Queue name [SYS$PRINT]:

     You can then enter a queue name or press Return to send the file to the default output print device.
   • 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 directory:

     SYS$HELP:PASCAL05n.RELEASE_NOTES

   
   You can later use the HELP command to find the location of the release notes in the Help facility:

   $ HELP PASCAL RELEASE_NOTES

   Whichever option you choose, VMSINSTAL next asks the following question:

   * 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 directory:

   SYS$HELP:PASCAL059.RELEASE_NOTES

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

5. Install the compiler.

   * Do you want to install the HP Pascal compiler [YES]?

   The HP Pascal kit contains the compiler, message files, command line definition, and help files.
6. Install STARLET.

   * Do you want to install the HP Pascal definition files [YES]?

   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.
   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.
7. Install the examples.

   * Do you want to install the HP Pascal example programs [YES]?

   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).
8. Save previous compiler.

   * Do you want to save your existing HP Pascal compiler [NO]?

   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.
9. Purge files.

   * Do you want to purge files replaced by this installation [YES]?

   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.
10. Choose the Installation Verification Procedure (IVP) option.
    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.

    * Do you want to run the IVP after the installation [YES]?

    This kit contains an IVP that is used to verify the correct installation of the HP Pascal compiler. The IVP is located in:

    SYS$TEST:PASCAL$IVP.COM

    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 HP Pascal.
11. Respond to license registration queries.

    Product: PASCAL Producer: DEC Version: V5.9 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.
12. 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 target directories...

13. 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 displayed:

    ** 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 * *-----------------------------------------------*

14. End the installation procedure.

    Installation of HP Pascal V(n.n) completed at hh:mm VMSINSTAL procedure done at hh:mm

    These messages indicate that the entire installation procedure is complete.
    You can now log out of the privileged account:

    $ LOGOUT SYSTEM logged out at dd-mmm-yyyy 20:20:02

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

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 Pascal V(n.n) has failed.

The HP Pascal V(n.n) Installation Verification Procedure failed.

%VMSINSTAL-E-IVPFAIL, The IVP for HP Pascal V(n.n) has failed.

• The operating system version is incorrect.
• Quotas necessary for successful installation are insufficient.
• System parameter values for successful installation are insufficient.
• The OpenVMS help library is currently in use.
• The product license has not been registered and loaded.