DSM for OpenVMS Version 7.0 December, 1997 Dear DSM for OpenVMS Customer : Enclosed is your DSM for OpenVMS kit. Version 7.0 of DSM for Open- VMS is compatible with DSM applications written under previous versions of DSM for OpenVMS. You must be running OpenVMS VAX Ver- sions 6.1, 6.2, 7.0, or 7.1 to run DSM Version 7.0 for OpenVMS VAX. You must be running OpenVMS Alpha Versions 6.1, 6.2, 7.0, 7.1 to run DSM Version 7.0 for OpenVMS Alpha. You should keep the following points in mind: o Because of certain internal changes, you will need to recompile all of your DSM routines after you upgrade to Version 7.0 of DSM for OpenVMS. o Be aware that InterSystems has changed the licensing procedure for DSM to bring it into conformance with other InterSystems products. Read the sections about licensing in Chapter 1 of the DSM for OpenVMS Release Notes for an overview of licensing. Read the sections about licensing in Chapter 2 of the DSM for OpenVMS Release Notes for more information about how to install or edit your license(s). You will need to obtain a license from InterSystems Corpo- ration in order to run DSM 7.0 in a production environment. InterSystems may be contacted at Intersystems Corporation Order Processing Group One Memorial Drive Cambridge MA 02142 United States Tel. (617)577-3600 Fax:(617)494-1631 This document describes the distribution kits for the following software: o Version 7.0 of DSM for OpenVMS VAX[TM] o Version 7.0 of DSM for OpenVMS Alpha[TM] It also provides product information that supplements the DSM for OpenVMS Release Notes. This document has two attachments: o Attachment A, "Installing the DSM 7.0 kit," describes how to install this kit. o Attachment B, "Additional Product Information," provides prod- uct information you need to know to use DSM. Distribution DSM is distributed by both InterSystems Corporation and Digi- tal Equipment Corporation. InterSystems distributes DSM software on the following media for both DSM for OpenVMS VAX and DSM for OpenVMS Alpha: o 9-track magnetic tape o TLZ06[TM] o TK50[TM] tape cartridge Digital Equipment Corporation distributes DSM software on the following media: o DSM for OpenVMS VAX: - 9-track magnetic tape - TLZ06[TM] - TK50[TM] tape cartridge - CD-ROM o DSM for OpenVMS Alpha: - CD-ROM Installation Information If you are installing DSM software for the first time, read Chap- ter 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 will load Version 7.0 manager utilities and globals. You must recom- pile application routines, create new mapped routine files, and reinitialize the journal files. 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. 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 DSM DSMVAXMUPB070 OPTIONS N or $ @SYS$UPDATE:VMSINSTAL DSM DSMAXPMUPB070 OPTIONS N If you are using CD-ROM media, you can obtain a copy of the re- lease notes using the CDMENU Utility. After installation, the DSM for OpenVMS Release Notes is available in SYS$HELP:DSM070.RELEASE_ NOTES, and a copy of this cover letter and attachments is avail- able in the file SYS$HELP:DSM070A.COVER_LETTER. Thank you for purchasing DSM for OpenVMS. The DSM Product Group 2 © InterSystems Corporation. 1997 3 Attachment A - Installing the DSM Version 7.0 Kit The following sections contain information about installing the DSM kit. Installing DSM for the First Time If you are installing DSM software for the first time, read Chap- ter 1 of the DSM for OpenVMS Installation and Management Guide. That chapter describes the installation procedure in detail. Take the following steps to install the DSM Version 7.0 kit: 1. Back up your system. 2. Install the kit. Run the SYS$UPDATE:VMSINSTAL procedure. On an OpenVMS VAX system, specify DSMVAXMUPA066 as the product name. On an OpenVMS Alpha system, specify DSMAXPMUPA066 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. Post-Installation Activities: 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 in to 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. Upgrading From a Previous Version of DSM If you are upgrading from a previous release of DSM you must up- grade your existing configurations and volume sets. Read the DSM for OpenVMS Release Notes in addition to the following informa- tion. Take the following steps to upgrade from a previous version of DSM to DSM for OpenVMS Version 7.0: 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 DSMVAX070 as the product name. On an OpenVMS Alpha system, specify DSMAXP070 as the product name. 4 4. If you do not run the IVP during VMSINSTAL, install the DSM for OpenVMS images as shared using the SYS$STARTUP:DSM$INSTALL.CO procedure. Postinstallation Activities: 1. Use the SYS$MANAGER:DSM$INIT.COM procedure from a privileged OpenVMS system account to upgrade DSM for OpenVMS manager ac- counts to DSM for OpenVMS Version 6.6A environment manager accounts. 2. Log in to the DSM for OpenVMS environment manager's account and run the SYS$MANAGER:DSM$UPGRADE.COM procedure. If you are upgrading from Version 6.3, you do not need to recompile your application routines. If you are upgrading from a version of DSM prior to 6.3 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. 3. Edit the OpenVMS system files to provide for automatic startup and shutdown of DSM for OpenVMS configurations when your system is rebooted. 4. If you are using DDP, reboot your OpenVMS system to reload the DDP driver. 5. Start up the upgraded configurations. Alternate Root Installation 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 6.6A MUP kit: 1. Log in to the system account. 2. Shut down all running DSM configurations. In a VMScluster envi- ronment, shut down configurations running on each node. 3. Extract the DSM$ALTROOT_INSTALL.COM procedure from the kit saveset. On an OpenVMS VAX system, use the following command: $ BACKUP/LOG kit_device:DSMVAX070.B/SAVE/SELECT=DSM$ALTROOT_INSTAL L.COM; * On an OpenVMS Alpha system, use the following command: $ BACKUP/LOG kit_device:DSMAXP070.B/SAVE/SELECT=DSM$ALTROOT_INSTAL L.COM; * Where kit_device is the distribution tape, CD-ROM, or disk where the DSM kit is located. 5 4. Use the DSM$ALTROOT_INSTALL.COM procedure to create the alter- nate root directories and install the DSM software distribution kit. 5. Use the DSM$ALTROOT.COM procedure to create and initialize a DSM environment manager's account for the new alternate root. 6. Use the DSM$ALTROOT.COM procedure to initialize the group logi- cal name search lists for all users within the GROUP. 7. Log in to the new manager account and use the SYS$MANAGER:DSM$CONFIGURE.COM procedure to create volume sets and to define new configura- tions. 8. Edit system startup files to initialize alternate root instal- lation on system reboot. 6 Attachment B - Additional Product Information The following sections contain additional information about doc- umentation and functionality that is not included in the DSM Re- lease Notes. Documentation Notes and Corrections This section contains notes about and corrections to the DSM docu- mentation set. o The DSM for OpenVMS Programmer's Guide left out the description of the %SETUCI utility. The following is the missing descrip- tion of this utility: %SETUCI Changes your default UCI and volume set. If you omit the flag argument, then DSM changes the UCI and volume set for both globals and routines. If you do not specify the volume set name (VOL), DSM uses the volume set S0. You can control access to this external routine by enabling configuration access control using the ^CONFIG Utility. Format: SET X=$&ZLIB.%SETUCI(UCI,{VOL},{flag}) UCI New UCI name VOL New volume set name flag G = change UCI and VOL for globals R = change UCI and VOL for routines o Chapter 9 of the DSM for OpenVMS Database Operations Guide contains a typographical error. Please replace every occurrence of the word "rambles" in Chapter 9 with the word "re-enables." 7