# DECram for OpenVMS Installation Guide

Previous | Contents

# 2.2 DECram Installation Messages

The following messages may be generated by the DECram for OpenVMS installation procedure.

Missing License Message

The installation procedure checks for the presence of the license to use DECram for OpenVMS. If the license is not found, the following message is sent:

    A license for DECRAM has not been registered
    and loaded. DECRAM will not be installed.

Section 1.1 describes how to register the DECram for OpenVMS license.

DECram for OpenVMS Driver Already Installed Message

If the installation procedure determines that the DECram for OpenVMS driver is already installed on the system, the following message is sent:

    A DECRAM Driver is already installed on the system.

Compaq recommends that you reboot your system, rather than perform a SYSGEN RELOAD, to invoke DECram for OpenVMS.

# Chapter 3
After Installing DECram for OpenVMS

This section describes how to perform the following postinstallation optional tasks:

- Run the IVP after installation (see Section 3.1).
- Determine and report problems (see Section 3.2).
- Print out DECram for OpenVMS documentation (see Section 3.3).

# 3.1 Running the Installation Verification Procedure Separately

You usually run the Installation Verification Procedure (IVP) during installation. If you want to run the IVP separately to ensure the integrity of installed files should system problems occur, execute the following command procedure:

    $ @SYS$UPDATE:DECRAM$IVP

Note The IVP creates a DECram disk MDA0 that remains after the IVP completes. If you do not want this disk, do not run the IVP.

# 3.2 Determining and Reporting Problems

If you encounter a problem while using DECram for OpenVMS, report it to Compaq. Depending on the nature of the problem and the type of support you have, you can take one of the following actions:

- Call your Compaq support center if your software contract or warranty agreement entitles you to telephone support.
- Submit a Software Performance Report (SPR).

Review the Software Product Description (SPD) and Warranty Addendum for an explanation of your warranty. If you encounter a problem during the warranty period, report the problem as indicated above or follow alternate instructions provided by Compaq for reporting SPD nonconformance problems.

# 3.3 DECram Documentation

Print the DECram for OpenVMS User's Manual, which is contained in the following files:

- SYS$HELP:DECRAM_DRIVER_MANUAL.PS
- SYS$HELP:DECRAM_DRIVER_MANUAL.TXT

Print the release notes, if you have not already done so. The release notes are contained in the following file:

- SYS$HELP:DECRAM.RELEASE_NOTES

# Appendix A
Supplementary Information

This appendix contains the following information:

- Error recovery and failure messages (see Section A.1)
- Listing of installed files (see Section A.2)
- Sample installation of DECram for OpenVMS (see Section A.3)

# A.1 Error Recovery

If errors occur during the installation 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 DECRAM V2.3 has failed.

If the IVP fails, you will see two messages: either of the first two messages that follow, and the third message:

    Problem encountered attempting to create a DECram disk.
    Problem encountered initializing a DECram disk.
    Unsuccessful termination of DECram V1.1 IVP.

Errors can occur during the installation if any of the following conditions exist:

- The operating system is a version prior to OpenVMS VAX Version 5.5-2.
- Installation account quotas necessary for successful installation are insufficient.
- System parameter values for successful installation are insufficient.
- The VMS help library is currently in use.
- The product license has not been registered and loaded.

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

# A.2 Installed Files

The DECram for OpenVMS installation procedure installs a number of files on your system. The following list contains the names of all files changed or created on your system during installation:

- SYS$LIBRARY:DCLTABLES.EXE
  This file is changed when you install DECram Version 2.2 on OpenVMS VAX Versions 5.2 and 5.3.
- SYS$SPECIFIC:[SYS$LDR]MDDRIVER.EXE (used on OpenVMS VAX systems)
  SYS$SPECIFIC:[SYS$LDR]SYS$MDDRIVER.EXE (used on OpenVMS Alpha systems)
  These files are the DECram for OpenVMS device driver (MDDRIVER).
- SYS$SPECIFIC:[SYS$LDR]EXECLET.EXE (used on OpenVMS VAX systems)
- SYS$SPECIFIC:[SYSMGR]DECRAM$RECOVER.DAT
- SYS$SPECIFIC:[SYSMGR]DECRAM$SETRAM.COM
- SYS$SPECIFIC:[SYSMGR]DECRAM$SETSHAD.COM
- SYS$SPECIFIC:[SYSMGR]DECRAM$REC_INIT.EXE
- SYS$SPECIFIC:[SYSEXE]DECRAM$RECOVER.EXE
- SYS$SPECIFIC:[SYSEXE]DECRAM$SETRAM.EXE
- SYS$SPECIFIC:[SYSEXE]DECRAM$SETSHAD.EXE
  These files are applicable to OpenVMS VAX Versions 5.5 or higher, and OpenVMS Alpha Version 6.1.
- SYS$SPECIFIC:[SYSEXE]DECRAM$SIZE.EXE
  This file is applicable to OpenVMS VAX Versions 5.2 and 5.3 only.
- SYS$HELP:DECRAM.RELEASE_NOTES
  This file contains the release notes for DECram for OpenVMS Version 2.3.
- SYS$HELP:DECRAM_DRIVER_MANUAL.PS
  SYS$HELP:DECRAM_DRIVER_MANUAL.TXT
  These files contain the DECram for OpenVMS User's Manual. This manual describes the features of the DECram for OpenVMS driver and includes information on how to configure the device and use the device driver.
- SYS$HELP:DECRAM_INSTAL_GUIDE.PS
  SYS$HELP:DECRAM_INSTAL_GUIDE.TXT
  These files contain the instructions for installing DECram for OpenVMS. (This is the document you are now reading.)
- SYS$TEST:DECRAM$IVP.COM
  This file is the Installation Verification Procedure (IVP).
- SYS$EXAMPLES:DECRAM$CONFIG.COM
  This command procedure is used to automatically create and initialize a DECram disk. The DECram for OpenVMS User's Manual shows an example of using this procedure.

- SYS$EXAMPLES:RAMDISK$STARTUP.COM
  This procedure is used to build a read-only DECram disk.
- SYS$EXAMPLES:RAMDISK$NODE.DAT
  This data file is used by RAMDISK$STARTUP.COM.
- SYS$EXAMPLES:SCRATCHRAM$STARTUP.COM
  This procedure is used to build a read/write DECram disk.
- SYS$EXAMPLES:SCRATCHRAM$NODE.DAT
  This data file is used by SCRATCHRAM$STARTUP.COM.

# A.3 Sample Installation

This section contains a sample installation of DECram for OpenVMS. This sample was run on a system that had no previous version of DECram for OpenVMS installed. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation. The sample installation assumes that no users are logged in to your system, and that OPTIONS N is specified not to print or display the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation.

    $ @SYS$UPDATE:VMSINSTAL

            VAX/VMS Software Product Installation Procedure V7.2

    It is 15-Jul-1998 at 08:01.

    Enter a question mark (?) at any time for help.
    * Are you satisfied with the backup of your system disk [YES]? y
    * Where will the distribution volumes be mounted: MUA0:

    Enter the products to be processed from the first distribution volume set.
    * Products: decram
    * Enter installation options you wish to use (none): N
    The following products will be processed:
      DECRAM

     Beginning installation of DECRAM V2.3 at 08:02

    %VMSINSTAL-I-RESTORE, Restoring product save set A ...

        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]: 4
    * Do you want to continue the installation [NO]? Y

    $!  Copyright (c) 1998 Digital Equipment Corporation.  All rights reserved.

    %DECRAM-I-VMSOK, Installing DECRam V2.3 on VMS Version V7.2
    * Do you want to purge files replaced by this installation [YES]?
    * Do you want to run the IVP after the installation [YES]?

    %VMSINSTAL-I-RESTORE, Restoring product save set B ...
    %VMSINSTAL-I-RESTORE, Restoring product save set C ...
    %VMSINSTAL-I-RESTORE, Restoring product save set G ...
    %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
    %SYSTEM-W-NOSUCHDEV, no such device available

    Device              Device           Error    Volume         Free  Trans Mnt
     Name               Status           Count     Label        Blocks Count Cnt
    MDA0:               Online               0

    Device              Device           Error    Volume         Free  Trans Mnt
     Name               Status           Count     Label        Blocks Count Cnt
    MDA0:               Online               0
    %MOUNT-I-MOUNTED, MDTST        mounted on _JONAS$MDA0:
    Successful Termination of DECram V2.3 IVP.
     Installation of DECRAM V2.3 completed at 08:04

    Enter the products to be processed from the next distribution volume set.
    * Products: exit
     VMSINSTAL procedure done at 08:04

    $

Previous | Contents