HP OpenVMS Systems Documentation

You can use the LIBDECOMP.COM procedure to decompress libraries in three ways:

• Entering a command and responding to prompts from the procedure
• Entering an interactive command
• Entering a batch command

The following three sections describe each method.

If you want to decompress libraries by responding to prompts from the LIBDECOMP.COM procedure, do the following:

1. Enter the following command and then press the Return key:

   $ @SYS$UPDATE:LIBDECOMP.COM

   
   The following information is displayed:

   OpenVMS Library Decompression Utility 1 HELPLIB.HLB 14 NCPHELP.HLB 27 PHONEHELP.HLB 2 STARLET.OLB 15 SDA.HLB 28 LIB.MLB 3 ACLEDT.HLB 16 SHWCLHELP.HLB 29 STARLET.MLB 4 ANLRMSHLP.HLB 17 SYSGEN.HLB 30 STARLETSD.TLB 5 DBG$HELP.HLB 18 ANALAUDIT$HELP.HLB 31 SYS$STARLET_C.TLB 6 DBG$UIHELP.HLB 19 SYSMANHELP.HLB 32 ERFLIB.TLB 7 DISKQUOTA.HLB 20 TFF$TFUHELP.HLB 33 SYS$LIB_C.TLB 8 EDFHLP.HLB 21 EXCHNGHLP.HLB 34 VAXCCURSE.OLB 9 INSTALHLP.HLB 22 TPUHELP.HLB 35 VAXCRTL.OLB 10 LATCP$HELP.HLB 23 EVE$HELP.HLB 36 VAXCRTLD.OLB 11 MAILHELP.HLB 24 EVE$KEYHELP.HLB 37 VAXCRTLT.OLB 12 MNRHELP.HLB 25 UAFHELP.HLB 38 IMAGELIB.OLB 13 EDTHELP.HLB 26 TECO.HLB 39 VMS$VOLATILE_PRIVATE_INTERFACES.OLB 40 FMG_HELP_FILE__AMERICAN_ENGLISH.HLB A ALL libraries to be decompressed E EXIT this procedure * Enter letter or number(s) of libraries to be decompressed (Separate multiple entries with a comma):

2. Enter the appropriate letter or the numbers of the libraries you want to decompress. To decompress all libraries, the process takes approximately one-half hour.

You can execute LIBDECOMP.COM interactively to decompress up to eight libraries at a time by listing the names of the libraries you want to decompress as parameters on the command line.

Be sure to separate the library names with commas and do not include the file extensions. For example, to decompress VAXCRTL.OLB, DISKQUOTA.HLB, and LIB.MLB interactively, enter the following command:

$ @SYS$UPDATE:LIBDECOMP VAXCRTL, DISKQUOTA, LIB

You can also execute LIBDECOMP.COM in batch mode to decompress up to eight libraries at a time by listing the names of the libraries you want to decompress as parameters on a command line that includes the SUBMIT command.

Be sure to separate the library names with commas and do not include the file extension. For example, to decompress VAXCRTL.OLB, DISKQUOTA.HLB, and LIB.MLB as a batch job, enter the following command:

$ SUBMIT/NOTIFY/PARAMETERS=(VAXCRTL, DISKQUOTA, LIB)-
_$ SYS$UPDATE:LIBDECOMP

If you decide after the upgrade to change which Compaq OpenVMS Alpha operating system files you want installed on your system, you can use the menu system contained on the Compaq OpenVMS Alpha operating system CD-ROM to add or remove files.

Note that you can obtain information about individual system files by entering HELP SYSTEM_FILES at the dollar sign prompt ($).

The procedure is as follows:

1. Mount and boot the Compaq OpenVMS Alpha operating system CD-ROM.
2. Choose option 1 from the menu.
3. Choose the PRESERVE option.
4. Enter the name of the device that contains the system disk and answer the questions.
5. After you answer the question "Do you want detailed descriptions?," information regarding reconfiguring or reinstalling is displayed. Read the instructions, then choose the desired entry from the menu of reconfigure/reinstall options.

The following is a sample reconfigure operation:

    Please choose one of the following:

        1)  Upgrade, install or reconfigure OpenVMS Alpha Version 7.3
        2)  Display products and patches that this procedure can install
        3)  Install or upgrade layered products and patches
        4)  Show installed products
        5)  Reconfigure installed products
        6)  Remove installed products
        7)  Execute DCL commands and procedures
        8)  Shut down this system

Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?) 1

.
. {Information that is documented elsewhere omitted...}
.



    Version 7.3 of the OpenVMS operating system is already installed
    on DKB300:.

    Please choose one of the following:

        1)  Reconfigure the OpenVMS platform.
        2)  Reconfigure the OpenVMS operating system.
        3)  Reinstall the OpenVMS operating system.
        4)  Return to the Main Menu (abort the upgrade/installation).

        Enter a "?" for more information.


Enter choice or ? for help: (1/2/3/4/?) ?

      o Reconfigure the OpenVMS platform.

        This action will allow you to change your selections of which
        of the windowing and network products you included with your
        OpenVMS operating system installation.

      o Reconfigure the OpenVMS operating system.

        This action will allow you to change your choices about which
        options you included for the OpenVMS operating system.

      o Reinstall the OpenVMS operating system.

        This action will cause ALL operating system  files to be replaced.
        You can also change your choices about which options you included
        for the OpenVMS operating system.

        Reinstall will take longer than Reconfigure.  Reinstall may be
        appropriate if you suspect that files in the operating system,
        or in the windowing and network products have become corrupted.

Press Return to continue...

    If you want to reinstall any of the windowing and network products,
    choose "Install or upgrade layered products and patches" (option 3)
    from the main menu.

    If you want to change your choices about which options you included
    for any of the windowing and network products, choose "Reconfigure
    installed products" (option 5) from the main menu.

Press Return to continue...

    Please choose one of the following:

        1)  Reconfigure the OpenVMS platform.
        2)  Reconfigure the OpenVMS operating system.
        3)  Reinstall the OpenVMS operating system.
        4)  Return to the Main Menu (abort the upgrade/installation).

        Enter a "?" for more information.


Enter choice or ? for help: (1/2/3/4/?) 2

    The following product has been selected:
        DEC AXPVMS VMS V7.3               Operating System


    Configuration phase starting ...

    You will be asked to choose options, if any, for each selected product and
    for
    any products that may be installed to satisfy software dependency
    requirements.

    DEC AXPVMS VMS V7.3: OpenVMS Operating System

        COPYRIGHT (c) 12-SEP-2001 -- All rights reserved

        Compaq Computer Corporation

    Do you want the defaults for all options? [YES]

Answer NO to this question, and select the options you want as described in Section 3.5.2. A list of components is provided in Section 3.5.3. After you respond to the prompts, the display continues and the installation procedure completes as described in Section 3.5.4. The following is a continuation of the sample display:

    Do you want to review the options? [NO]

Execution phase starting ...

The following product will be reconfigured:
    DEC AXPVMS VMS V7.3
Portion done: 0%...10%...20%...30%...40%...50%...60%...80%...90%...100%

The following product has been reconfigured:
    DEC AXPVMS VMS V7.3
.
.
.

For detailed instructions on how to remove the Compaq OpenVMS Alpha operating system from your disk, see Appendix E.

8.9 Preparing to Use OpenVMS Management Station

If you installed the OpenVMS Management Station software on your system (either by accepting all default values or by selecting the component manually during the upgrade procedure), you must perform several tasks on your Compaq OpenVMS Alpha system and your PC before you can use OpenVMS Management Station. These tasks include the following:

• Editing system files
• Starting OpenVMS Management Station on other nodes
• Verifying that you have the proper memory, disk space, media, and the required software to install and run OpenVMS Management Station on your PC
• Installing the client software on your PC

For complete information about preparing your OpenVMS system and your PC to run the OpenVMS Management Station server and client software, see Appendix D.

Except in certain instances, you should not have to reinstall layered products that you had on your system prior to the upgrade. However, if you need to install layered products, you can use the menu system included on the operating system CD-ROM to install certain layered products with the POLYCENTER Software Installation utility. If you did not install those layered products previously during the installation procedure, you can do so using the following procedure. To install layered products that require VMSINSTAL, see Section 8.10.1.

1. Shut down the system (described in Appendix A).
2. Boot the operating system CD-ROM (locally or from the InfoServer).
3. Choose option 2 from the menu to view which layered products can be installed using the POLYCENTER Software Installation utility.
4. Choose option 3 from the menu to install the layered products.
5. Shut down the system by selecting option 8 from the menu.
6. Boot from the system disk.

If the layered product that you want to install is not listed in the display, see the documentation you received with that layered product for installation information.

For additional information about installing layered products, see the OpenVMS System Manager's Manual.

Be sure you back up the system disk after you install all your layered products.

The following is another method for installing layered products from the Compaq OpenVMS Alpha operating system CD-ROM:

1. From your running OpenVMS system (the target system disk), mount the Compaq OpenVMS Alpha operating system CD-ROM.
2. Locate the directories and files containing the available layered products by entering the following command (where, in the example, DKA400: is the device name of the CD-ROM):

   $ DIRECTORY /NOHEAD/NOTRAIL DKA400:[*.KIT]

   
   You can use the PRODUCT FIND command to locate kits that are installed using the POLYCENTER Software Installation utility. For example:

   $ PRODUCT FIND * /SOURCE=DKA400:[*.KIT]

3. To install layered products that require VMSINSTAL (indicated in the directories by save-set file names with file types of .A, .B, and so on), enter the @SYS$UPDATE:VMSINSTAL command and then specify the CD-ROM device and directory. For example:

   $ @SYS$UPDATE:VMSINSTAL * Where will the distribution volumes be mounted: DKB400:[LP.KIT]

4. To install layered products that require the POLYCENTER Software Installation utility (indicated in the directories by file names with file types of .PCSI or .PCSI$DESCRIPTION), use the PRODUCT INSTALL command to specify the CD-ROM device name and directory. The following is an example of the PRODUCT INSTALL command:

   $ PRODUCT INSTALL name /SOURCE=DKB400:[name.KIT]

When you install Compaq OpenVMS Alpha Version 7.3, the DIAGNOSE command is disabled. To enable the DIAGNOSE command, you must install the DECevent kit (provided on the System Tools CD-ROM) following the upgrade to Compaq OpenVMS Alpha Version 7.3.

If the DECevent kit provided on the System Tools CD-ROM is not installed after the operating system, users attempting to use the DIAGNOSE command will receive the following system message:

$ DIAGNOSE [params]
%DIA-E-NOINSTAL, DIAGNOSE has not been installed on this system

The OpenVMS Debugger Version 7.3 includes a client/server interface. The debug server runs on the OpenVMS operating system; there are debug clients that run on OpenVMS, Microsoft Windows 95, and Microsoft Windows NT. There is no separate installation procedure for the components that run on the OpenVMS operating system. They are installed when you install the operating system. This section describes the procedure for installing debug clients on a PC.

The following table shows which client kit to use for each PC configuration:

The client kits are self-extracting .EXE files. To make these clients available to PC users, copy these files from the distribution media to a suitable PATHWORKS share, FTP server, or other device available to the PC.

Once the appropriate executable file has been transferred to the PC, you can run the file to install the debug client on the PC. The InstallShield installation procedure guides you through the installation.

By default, the debug client is installed in the \Programs\OpenVMS Debugger directory. You can also click on the Browse button to select an alternate directory.

You can choose one of the following installation options:

The Typical installation option creates an OpenVMS Debugger program folder that contains shortcuts to the following items:

• Debug client
• Debug client Help file
• The OpenVMS Debugger Manual in HTML format
• A Readme file
• An Uninstall procedure

For information about using the OpenVMS Debugger, see the OpenVMS Debugger Manual.

8.12 Backing Up the Customized System Disk

After you have upgraded and customized the Compaq OpenVMS Alpha operating system to your satisfaction and installed layered products, protect your work by making a backup copy of the system disk.

To back up the system disk:

1. Shut down the system (described in Appendix A).
2. Boot the operating system CD-ROM (locally or from the InfoServer).
3. Use the menu system to enter the DCL environment (option 7).
4. Mount the system disk and the target device on which you will make the backup copy.
5. Enter backup commands to back up the system disk to the target device.
6. Log out from the DCL environment.
7. Shut down the system by selecting option 8 from the menu.
8. Boot from the system disk.

For complete information about backup operations, including a description of an alternate method that does not require booting from the operating system CD-ROM and that allows you to back up a shadowed disk without disabling the shadow set, see Appendix B.

8.13 Rebooting Cluster Members

If you are performing a rolling upgrade in an OpenVMS Cluster environment and have completed all the postupgrade tasks required for your upgraded system disk, reboot each system that boots from that system disk.

For more information about booting your system, see Appendix A.

8.14 Running AUTOGEN

Although AUTOGEN runs automatically at the end of the upgrade procedure, Compaq recommends that you run AUTOGEN periodically after you perform an upgrade.

After 24 hours of operation, run AUTOGEN in FEEDBACK mode and reboot the system. Run AUTOGEN in this way again two workdays later.

AUTOGEN sets the values of system parameters and the sizes of the page and swap files according to the system's work load. Compaq recommends that you run AUTOGEN from SAVPARAMS through TESTFILES on a weekly basis and examine AGEN$PARAMS.REPORT to determine the need for additional changes.

Hardcoded values in MODPARAMS.DAT should not hinder AUTOGEN's ability to calculate feedback parameters. AUTOGEN generally does not reduce the value of parameters that allocate resources; it considers current parameter values to be minimum values, which means you do not have to add MIN_* symbols to MODPARAMS.DAT. AUTOGEN does increase parameter values according to its calculations unless you have specified explicit or maximum values (by adding MAX_* symbols) in MODPARAMS.DAT.

For more information about the MODPARAMS.DAT file and about using AUTOGEN in general, see the OpenVMS System Manager's Manual.

8.15 Postupgrade Checklist

Use the following checklist to make sure you have performed all the necessary tasks:

• In a volume shadowing environment, reform the shadow set.
• Register new licenses.
• Examine AUTOGEN output stored in the file AGEN$PARAMS.REPORT.
• Examine MODPARAMS.DAT.
• Examine the command procedure templates supplied with the Compaq OpenVMS Alpha Version 7.3 operating system.
• Decompress the system libraries using LIBDECOMP.COM.
• Run the User Environment Test Package (UETP) to test the system (described in the OpenVMS System Manager's Manual).
• Add and remove files.
• Prepare your OpenVMS Alpha system and your PC to run OpenVMS Management Station by following the procedures described in Appendix D.
• Install layered products, including DECwindows (if necessary).
• Back up the customized system disk.
• Reboot each system that boots from the upgraded system disk (for a rolling upgrade in an OpenVMS Cluster environment).
• Run AUTOGEN.