Dear DSM for OpenVMS Customer :

Enclosed is your DSM for OpenVMS kit. Version 7.3 of DSM for OpenVMS is compatible with DSM applications written under previous versions of DSM for OpenVMS.

Information regarding current DSM releases is available on the InterSystems Web site. We strongly recommend that you visit the Web site (http://mtechnology.intersys.com/mproducts/dsm7) for additional information, including release notes & cover letters.

_____________________________________________________________________________________

You need to be using... To install and run…

_____________________________________________________________________________________

OpenVMS VAX Versions 6.2, 7.0, 7.1, 7.2 or 7.3 V7.3 of DSM for OpenVMS VAX

OpenVMS Alpha Versions 6.2, 7.0, 7.1, 7.2, 7.2-1 V7.3 of DSM for OpenVMS Alpha

or 7.3

_____________________________________________________________________________________

For additional information regarding the coexistence of different versions of DSM/OpenVMS, a compatibility chart is available at:

http://mtechnology.intersys.com/support/faqs/vmstable.html

You should keep the following points in mind:

• Because of certain internal changes, you will need to recompile all of your DSM routines after you upgrade to DSM V7.3 from any previous release of DSM.

• No additional new documentation has been produced for DSM V7.3 other than this cover letter and the DSM for OpenVMS Release Notes V7.3.

• You will need to have a valid license from InterSystems Corporation in order to run DSM 7.3 in a production environment. Additional information on licensing can be obtained from the main InterSystem’s order processing dept at the following address or via your local InterSystems office.

InterSystems Corporation

Order Processing Group

One Memorial Drive

Cambridge MA 02142

United States

Tel. (617)577-3600 Fax:(617)494-1631

E-mail orderproc@intersys.com

This document describes the distribution kits for the following software:

• Version 7.3 of DSM for OpenVMS VAX[TM]

• Version 7.3 of DSM for OpenVMS Alpha[TM]

DSM is currently available from InterSystems Corporation on the following media:

• TLZ06 [TM]
• TK50 [TM]
• CD-ROM

If you are installing DSM software for the first time, read Chapter 1 of the DSM for OpenVMS Installation and Management Guide . This chapter describes the installation procedure in detail.

If you are upgrading from a previous release of DSM, you must upgrade your existing configurations and volume sets. After you complete your software installation, the upgrade procedure loads Version 7.3 manager utilities and globals.

A copy of the DSM for OpenVMS Release Notes is distributed in printed form and on line as a file with the DSM distribution kit. Release notes are also available from the InterSystems web site as previously mentioned.

You can obtain a copy of these release notes when you install DSM by using the "OPTIONS N" parameter with the VMSINSTAL procedure.

For example:

$ @SYS$UPDATE:VMSINSTAL DSMVAX073 kit_path: OPTIONS N

or

$ @SYS$UPDATE:VMSINSTAL DSMAXP073 kit_path: OPTIONS N

The release notes can be obtained in SYS$HELP during the DSM installation or extracted directly from the .B DSM saveset.

Thank you for purchasing DSM for OpenVMS.

The DSM Product Group

The following sections contain information about installing the DSM kit.

Take the following steps to install the DSM Version 7.3 kit:

1. Back up your system.
2. Install the kit. Run the SYS$UPDATE:VMSINSTAL procedure. On an OpenVMS VAX system, specify DSMVAX073 as the product name. On an OpenVMS Alpha system, specify DSMAXP073 as the product name.
3. If you do not run the IVP during VMSINSTAL, install the DSM for OpenVMS images as shared using the SYS$STARTUP:DSM$INSTALL.COM procedure.

After Installing, take the following steps:

1. Use the SYS$MANAGER:DSM$INIT.COM procedure to create a DSM for OpenVMS environment manager's account.
2. Edit the OpenVMS system files to provide for automatic startup and shutdown of DSM for OpenVMS configurations when your system is rebooted.
3. Log into the DSM for OpenVMS environment manager's account and run the SYS$MANAGER:DSM$CONFIGURE.COM procedure to initialize DSM for OpenVMS database volume sets and configurations.

If you are upgrading from a previous release of DSM you must upgrade your existing configurations and volume sets. Read the DSM for OpenVMS V7.3 Release Notes, in addition to the following information.

Take the following steps to upgrade from a previous version of DSM to DSM for OpenVMS Version 7.3:

1. Shut down all running DSM for OpenVMS configurations.
2. Back up your system.
3. Install the kit. Run the SYS$UPDATE:VMSINSTAL procedure. On an OpenVMS VAX system, specify DSMVAX073 as the product name. On an OpenVMS Alpha system, specify DSMAXP073 as the product name.
4. If you did not run the IVP (Installation Verification Procedure) during the VMSINSTAL and have not already successfully reinstalled your DSM images, then install the new DSM images using the SYS$STARTUP:DSM$INSTALL.COM procedure.

1. You should reboot your OpenVMS system if any of the following conditions apply:

• Your DSM configurations use DDP, the reboot will reload the required DDP driver.
• Your DSM images (DSM$SHARE.EXE & DSM$SHRLIB.EXE) were previously installed as Resident, the reboot will allow your new DSM images to be installed.

1. Use the SYS$MANAGER:DSM$INIT.COM procedure from a privileged OpenVMS system account to upgrade DSM for OpenVMS manager accounts to DSM for OpenVMS Version 7.3 environment manager accounts.
2. If you have user-written external routine packages, upgrade the external call package table image to include those packages.
3. Log in to the DSM for OpenVMS environment manager's account and run the SYS$MANAGER:DSM$UPGRADE.COM procedure. You must recompile your application routines.

DSM$UPGRADE optionally reinitializes before-image and after-image journal files and optionally upgrades mapped routine sets. You can also use ^BIJINIT, ^JRNINIT, and ^RMBLD to reinitialize your journal files and rebuild your mapped routines at a later time.

4. If you have not already previously done so, edit the OpenVMS system files to provide for automatic startup and shutdown of DSM for OpenVMS configurations when your system is rebooted.
5. Start up the upgraded configurations.

If you are installing DSM in an alternate root, read Appendix A of the DSM Installation and Management Guide . It describes the alternate root installation in detail.

Do the following to install the DSM Version 7.3 kit: