IEZ11_______________________________________________ Software Installation Guide Order Number: AA-PA9DC-TE March 1993 Revision/Update Information: This revised guide replaces the IEZ11 Software Installation Guide, AA-PA9DB-TE, dated July 1991. Software Version: IEZ11 Version 2.1 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ March 1993 Possession, use, or copying of the software described in this documentation is authorized only pursuant to a valid written license from Digital, an authorized sublicensor, or the identified licensor. While Digital believes the information included in this publication is correct as of the date of publication, it is subject to change without notice. Digital Equipment Corporation makes no representations that the interconnection of its products in the manner described in this document will not infringe existing or future patent rights, nor do the descriptions contained in this document imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation March, 1993. All Rights Reserved. The Reader's Comments form at the end of this document requests your critical evaluation to help prepare future documentation. The following are trademarks of Digital Equipment Corporation: DEC, DECwindows, Digital, OpenVMS, OpenVMS VAX, VAX, VAXcluster, VAXstation, VAX Ada, VAX BASIC, VAX C, VAX FORTRAN, VAX MACRO, VAX PASCAL, VAX VMS, and the Digital logo. Motif is a registered trademark of the Open Software Foundation. FCC NOTICE: The equipment described in this manual generates, uses, and may emit radio frequency energy. The equipment has been type tested and found to comply with the limits for a Class A computing device pursuant to Subpart J of Part 15 of FCC Rules, which are designed to provide reasonable protection against such radio frequency interference when operated in a commercial environment. Operation of this equipment in a residential area may cause interference, in which case the user at his own expense may be required to take measures to correct the interference. This document was prepared using VAX DOCUMENT, Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install the IEZ11 Software 1.1 Prerequisite Hardware......................... 1-2 1.2 Prerequisite and Optional Software............ 1-2 1.3 License Registration.......................... 1-3 1.4 VAXcluster Considerations..................... 1-3 1.5 Installation Procedure Requirements........... 1-4 1.5.1 Time...................................... 1-4 1.5.2 Privileges................................ 1-4 1.5.3 Disk Space................................ 1-4 1.5.4 VMSINSTAL Requirements.................... 1-6 1.5.5 Backing Up Your System Disk............... 1-6 2 Installing the IEZ11 Software 2.1 General Information........................... 2-1 2.1.1 Accessing the Online Release Notes........ 2-1 2.1.2 Files Added to the System................. 2-2 2.1.3 The Installation Verification Procedure... 2-9 2.1.4 Aborting the Installation................. 2-9 2.2 The Installation Procedure.................... 2-10 2.2.1 Invoking VMSINSTAL........................ 2-10 2.2.2 Installation Questions.................... 2-11 2.2.3 Informational Messages.................... 2-18 2.2.4 Running the Installation Verification Procedure................................. 2-19 2.2.5 Completing the Installation Procedure..... 2-19 2.3 Error Recovery................................ 2-20 iii 3 After Installing the IEZ11 Software 3.1 Editing the System Startup File............... 3-1 3.2 VAXcluster Considerations..................... 3-1 3.3 Determining and Reporting Problems............ 3-2 A Sample Installation Index Tables 1-1 Nomenclature.............................. 1-1 1-2 Disk Space Requirements................... 1-5 2-1 Files Provided by the IEZ11 Software Installation.............................. 2-3 2-2 Macro-32 Example Programs................. 2-4 2-3 VAX C Example Programs.................... 2-6 iv _________________________________________________________________ Preface This guide describes how to install the IEEE488 Bus Converter (IEZ11) software, and how to run the Installation Verification Procedure. For the software installation to succeed, you must first install the hardware component of the IEZ11, the SCSI488/D. See the IEZ11 Hardware Installation Guide for information on how to install the hardware. This guide is for Version 2.1 of the IEZ11 class driver and all subsequent maintenance releases up to the next major version release. Structure of This Guide This guide has three chapters and one appendix: o Chapter 1 describes how to prepare for the IEZ11 software installation. o Chapter 2 describes how to install the IEZ11 software. o Chapter 3 describes post-installation considerations. o Appendix A contains a sample installation. Associated Documents This guide has the following associated documents: o IEZ11 Hardware Installation Guide (AA-PA9EC-TE) o IEZ11 User's Guide (AA-NU45C-TE) o Software Product Description (SPD) for the DEC[TM] IEZ11 Class Driver for OpenVMS[TM] (AE-NU46E-TE) v o System Support Addendum (SSA) for the DEC IEZ11 Class Driver for OpenVMS (SSA: 31.41.xx) (AE-NU47F-TE) vi Conventions This guide uses the following conventions: ___________________________________________________________ Convention__________Meaning________________________________ NOTE A note contains information of special importance to the reader. SHOW QUEUE Command names in text are shown in uppercase. CTRL/C For sequences that use the CTRL key, hold down CTRL and press the second key. Color Text in color indicates user input. VSmv_RES_Svec System displays used as examples are shown in monospace type. italics Italics are used to emphasize a term or ____________________phrase.________________________________ vii 1 _________________________________________________________________ Preparing to Install the IEZ11 Software This chapter describes the preparations and requirements for installing the IEZ11 software. Table 1-1 explains the naming convention used throughout this guide. Table_1-1_Nomenclature_____________________________________ Name_______________________Refers_to:______________________ IEZ11 The complete bus converter IEEE488 bus converter The complete bus converter SCSI488/D The IEZ11 hardware device IEZ11 software The complete IEZ11 software kit IEZ11 class driver The DEC IEZ11 class driver for ___________________________OpenVMS_________________________ ________________________ Note ________________________ The IEEE488 Bus Converter is the official name of the complete hardware and software package. IEZ11 is the catalogue reference name for the complete package. ______________________________________________________ Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged, or if you find that parts of it are missing, contact your Digital[TM] representative. The IEZ11 software provides online release notes. Digital strongly recommends that you read the release notes before proceeding with the installation. See Section 2.1.1 for information on accessing the online release notes. Preparing to Install the IEZ11 Software 1-1 Preparing to Install the IEZ11 Software 1.1 Prerequisite Hardware 1.1 Prerequisite Hardware You can use the IEZ11 class driver only on those supported systems that have a SCSI488/D connected to the external SCSI port. For a list of all VAX[TM] family supported systems, see the Hardware Requirements section of the System Support Addendum (SSA) to the Software Product Description (SPD) for the DEC IEZ11 Class Driver for OpenVMS. In a VAXcluster[TM] environment, you can install the IEZ11 software from any node in the cluster. See Section 1.4 for more details. 1.2 Prerequisite and Optional Software The IEZ11 class driver requires the SCSI Port Driver so that it can function. This driver is part of the OpenVMS VAX[TM] operating system. The port driver is distributed with the regular VMS distribution kit. During the system startup procedure, if the required system hardware is detected, SYSGEN automatically loads the SCSI port driver. No user intervention is required. The IEZ11 class driver requires at least Version 5.4 of the OpenVMS VAX operating system. For a more detailed description of which version of OpenVMS[TM] is compatible with the IEZ11 class driver, see the Software Requirements section of the SSA to the SPD for the DEC IEZ11 Class Driver for OpenVMS. The IEZ11 Exerciser requires DECwindows[TM] Motif[TM] Version 1.0 or higher. You do not require optional software to install or operate the IEZ11 class driver. However, if you want to develop applications for the IEZ11, you may require additional software products, depending on the particular application's requirements. For a list of compatible programming languages, see the Optional Software section of the SSA to the SPD for the DEC IEZ11 Class Driver for OpenVMS. 1-2 Preparing to Install the IEZ11 Software Preparing to Install the IEZ11 Software 1.3 License Registration 1.3 License Registration You must register the IEZ11-CLASS-DRIVER license through the OpenVMS License Management Facility (LMF) in accordance with the license agreement signed by your site. The Product Authorization Key (PAK), which is shipped with the IEZ11 software, contains the license registration information you need. The PAK is a paper certificate that contains information about the license. This information allows you to run a particular piece of software. During the installation, the system asks whether you have registered the IEZ11 license and loaded the appropriate PAK. To run the Installation Verification Procedure (IVP) and use the software, you must register and load your license for the IEZ11 class driver before you start the installation. To register a license under OpenVMS, first log in to the system manager account, SYSTEM. You can then choose between two ways of registering the license: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your PAK. o At the DCL prompt, issue the LICENSE REGISTER command with the appropriate qualifiers, which correspond to PAK information. If you intend to use the IEZ11 class driver on more than one node in a VAXcluster, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.2. For complete information on using LMF, consult the License Management Utility in the VMS documentation set. 1.4 VAXcluster Considerations You can install the IEZ11 software from any node within a VAXcluster. However, you can only run the IEZ11 class driver from a system that meets the hardware requirements of the product. This includes a SCSI488/D connected to the external SCSI port. After the installation is completed, configure the IEZ11 software independently on each node Preparing to Install the IEZ11 Software 1-3 Preparing to Install the IEZ11 Software 1.4 VAXcluster Considerations in the VAXcluster. Use the IEZ11$CONFIG command procedure provided in SYS$MANAGER, to configure each node. Note that you must reinstall the IEZ11 software after each update of the OpenVMS VAX operating system. In mixed version VAXclusters, you must install the IEZ11 software independently under each version of OpenVMS. You must not copy the software from one system disk to another. 1.5 Installation Procedure Requirements The following sections discuss the various requirements for installing the IEZ11 software. 1.5.1 Time The installation takes between 5 and 15 minutes, depending on the type of media and your system configuration. Installing the IEZ11 software and running the IVP on a standalone VAXstation[TM] 3100 Model 30 system takes 5 minutes, if you install it from the RX23 floppy disk. 1.5.2 Privileges To install the IEZ11 software, you must log into an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV Note that VMSINSTAL turns off BYPASS privilege at the start of the installation. 1.5.3 Disk Space A certain amount of free disk space is required during the installation. Once you have installed the IEZ11 software, less storage space is required. Table 1-2 summarizes the storage requirements for the IEZ11 software installation. 1-4 Preparing to Install the IEZ11 Software Preparing to Install the IEZ11 Software 1.5 Installation Procedure Requirements Table_1-2_Disk_Space_Requirements__________________________ Blocks During Kit_________Installation__________Blocks_After_Installation IEZ11 2000 1400 Version 2.1________________________________________________________ To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE Preparing to Install the IEZ11 Software 1-5 Preparing to Install the IEZ11 Software 1.5 Installation Procedure Requirements 1.5.4 VMSINSTAL Requirements When you invoke VMSINSTAL, it checks the following: o Whether you have set your default device and directory to SYS$UPDATE o Whether you are logged in to a privileged account o Whether you have adequate quotas for installation o Whether any users are logged in to the system ________________________ Note ________________________ VMSINSTAL requires that the installation account must have a minimum of the following quotas: ASTLM = 24 BIOLM = 18 BYTLM = 18,000 DIOLM = 18 ENQLM = 30 FILLM = 20 ______________________________________________________ If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can type YES to continue. To stop the installation process, type NO or press Return. Then correct the problem and restart the installation. 1.5.5 Backing Up Your System Disk At the start of the installation, VMSINSTAL asks if you have backed up your system disk. Digital recommends that you do a system disk backup before installing any 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 VMS System Management Subkit. 1-6 Preparing to Install the IEZ11 Software 2 _________________________________________________________________ Installing the IEZ11 Software This chapter describes how to install the IEZ11 software. Section 2.1 provides general information on the installation procedure. Section 2.2 provides a detailed description of the installation procedure. Section 2.3 provides information on error recovery. 2.1 General Information This section includes information about the following topics: o Accessing release notes o Files added to your system o Running the Installation Verification Procedure o Aborting the installation. 2.1.1 Accessing the Online Release Notes The IEZ11 software provides online release notes. To view the online release notes, specify OPTIONS N when you invoke VMSINSTAL and then answer the relevant question during installation. This question is near the start of the installation procedure. Read the release notes in case they contain information about last-minute changes in the installation procedure. If you are starting the installation again and have already read the release notes, you do not need to specify OPTIONS N. Installing the IEZ11 Software 2-1 Installing the IEZ11 Software 2.1 General Information Once you have installed the IEZ11 software, you can locate the release notes in the following file: SYS$HELP:IEZ11021.RELEASE_NOTES 2.1.2 Files Added to the System During the installation, VMSINSTAL creates some files on your system. Tables 2-1 to 2-3 list the files, and the example programs, provided by the IEZ11 software installation. 2-2 Installing the IEZ11 Software Installing the IEZ11 Software 2.1 General Information Table_2-1_Files_Provided_by_the_IEZ11_Software_Installation File_Specification______________Purpose____________________ SYS$LOADABLE_ IEZ11 class driver IMAGES:EKDRIVER.EXE SYS$LIBRARY:IEZ11$DEF.ADA IEZ11 VAX Ada[TM] language support file SYS$LIBRARY:IEZ11$DEF.BAS IEZ11 VAX BASIC[TM] language support file SYS$LIBRARY:IEZ11$DEF.FOR IEZ11 VAX FORTRAN[TM] language support file SYS$LIBRARY:IEZ11$DEF.H IEZ11 VAX C[TM] language support file SYS$LIBRARY:IEZ11$DEF.MAR IEZ11 VAX MACRO[TM] language support file SYS$LIBRARY:IEZ11$DEF.PAS IEZ11 VAX PASCAL[TM] language support file SYS$LIBRARY:IEZ11$DEF.PLI IEZ11 VAX PL/I language support file SYS$LIBRARY:IEZ11$DEF.R32 IEZ11 VAX BLISS-32 language support file SYS$LIBRARY:IEZ11$LIB.MLB IEZ11 VAX MACRO support library SYS$MANAGER:IEZ11$STARTUP.COM Actual IEZ11 startup procedure, provided only if SCSI port present SYS$TEST:IEZ11$IVP.EXE IEZ11 installation verification procedure (IVP) SYS$MANAGER:IEZ11$CONFIG.COM IEZ11 configuration procedure SYS$SYSTEM:IEZ11$ITADS.EXE IEZ11 installation test and demonstration utility SYS$SYSTEM:IEZ11$EX.EXE IEZ11 Exerciser SYS$LIBRARY:IEZ11$EX.UID UID file for IEZ11 Exerciser (continued on next page) Installing the IEZ11 Software 2-3 Installing the IEZ11 Software 2.1 General Information Table 2-1 (Cont.) Files Provided by the IEZ11 Software __________________Installation_____________________________ File_Specification______________Purpose____________________ SYS$HELP:IEZ11$EX.HLB Help file for IEZ11 ________________________________Exerciser__________________ Table 2-2 lists the Macro-32 example programs provided by the IEZ11 software installation, in SYS$SYSHELP:[EXAMPLES.IEZ11]. Table_2-2_Macro-32_Example_Programs________________________ File_Specification______________Example_of_________________ INITIALIZE.MAR IO$_INITIALIZE function COMMAND.MAR IO$_COMMAND function COMMANDS.MAR IO$_COMMANDS function GO_TO_CACS.MAR IO$_GO_TO_CACS function GO_TO_CSBS.MAR IO$_GO_TO_CSBS function PASSCONTROL.MAR IO$_PASSCONTROL function READL.MAR IO$_READLBLK function READL_NO_MLA.MAR IO$_READLBLK function with IO$M_NO_MLA modifier READL_SET_TALK.MAR IO$_READLBLK function with IO$M_SET_TALK modifier READ_RESP.MAR IO$_READ_RESP function WRITEL.MAR IO$_WRITELBLK function WRITEL_SET_LIST.MAR IO$_WRITELBLK function with IO$M_SET_LIST modifier WRITEL_NO_MTA.MAR IO$_WRITELBLK function with IO$M_NO_MTA modifier WRITEL_EOI.MAR IO$_WRITELBLK function with IO$M_EOI modifier SER_POLL.MAR IO$_SER_POLL function (continued on next page) 2-4 Installing the IEZ11 Software Installing the IEZ11 Software 2.1 General Information Table_2-2_(Cont.)_Macro-32_Example_Programs________________ File_Specification______________Example_of_________________ SER_POLL_ALLDEV.MAR IO$_SER_POLL function with IO$M_ALLDEVICES modifier PAR_POLL.MAR IO$_PAR_POLL function PAR_POLL_LEAVIS.MAR IO$_PAR_POLL function with IO$M_LEAVIS modifier PARPOLLCON.MAR IO$_PARPOLLCON function LOADPARPOLL.MAR IO$_LOADPARPOLL function PARPOLLDIS.MAR IO$_PARPOLLDIS function PARPOLLUNCON.MAR IO$_PARPOLLUNCON function SENSEMODE.MAR IO$_SENSEMODE function SENSEMODE_CHAR.MAR IO$_SENSEMODE function with IO$M_CHAR modifier SENSEMODE_IOTYPE.MAR IO$_SENSEMODE function with IO$M_IOTYPE modifier SETEVENT.MAR IO$_SETEVENT function REC_EVENT.MAR IO$_REC_EVENT function REC_EVENT_NOWAIT.MAR IO$_REC_EVENT function with IO$M_NOWAIT modifier REC_EVENT_LEAVIS.MAR IO$_REC_EVENT function with IO$M_LEAVIS modifier SETMODE_ATTNAST.MAR IO$_SETMODE function with IO$M_ATTNAST modifier SETMODE_TIMEOUT.MAR IO$_SETMODE function with IO$M_TIMOUT modifier SETMODE_CHAR.MAR IO$_SETMODE function with IO$M_CHAR modifier SETMODE_BUFFERED.MAR IO$_SETMODE function with IO$M_BUFFERED modifier SETMODE_DIRECT.MAR IO$_SETMODE function with IO$M_DIRECT modifier SERVICE.MAR IO$_SERVICE function (continued on next page) Installing the IEZ11 Software 2-5 Installing the IEZ11 Software 2.1 General Information Table_2-2_(Cont.)_Macro-32_Example_Programs________________ File_Specification______________Example_of_________________ AUXILIARY.MAR IO$_AUXILIARY function CONFIG.MAR IO$_CONFIG function CONFIG_KEEP.MAR IO$_CONFIG function with IO$M_KEEP modifier DIAGNOSE_RESET.MAR IO$_DIAGNOSE function with IO$M_RESET modifier DIAGNOSE_REMOTE.MAR IO$_DIAGNOSE function with IO$M_REMOTE modifier DIAGNOSE_READ.MAR IO$_DIAGNOSE function with IO$M_READ modifier DIAGNOSE_WRITE.MAR IO$_DIAGNOSE function with IO$M_WRITE modifier SCSI488.MAR IO$_COMMAND_SCSI488 function SCSI488_RESPONSE.MAR IO$_COMMAND_SCSI488 function with IO$M_RESPONSE ________________________________modifier___________________ Table 2-3 lists the VAX C example programs provided by the IEZ11 software installation, in SYS$SYSHELP:[EXAMPLES.IEZ11]. Table_2-3_VAX_C_Example_Programs___________________________ File_Specification______________Purpose____________________ INITIALIZE.C IO$_INITIALIZE function COMMAND.C IO$_COMMAND function COMMANDS.C IO$_COMMANDS function GO_TO_CACS.C IO$_GO_TO_CACS function GO_TO_CSBS.C IO$_GO_TO_CSBS function PASSCONTROL.C IO$_PASSCONTROL function READL.C IO$_READLBLK function (continued on next page) 2-6 Installing the IEZ11 Software Installing the IEZ11 Software 2.1 General Information Table_2-3_(Cont.)_VAX_C_Example_Programs___________________ File_Specification______________Purpose____________________ READL_NO_MLA.C IO$_READLBLK function with IO$M_NO_MLA modifier READL_SET_TALK.C IO$_READLBLK function with IO$M_SET_TALK modifier READ_RESP.C IO$_READ_RESP function WRITEL.C IO$_WRITELBLK function WRITEL_SET_LIST.C IO$_WRITELBLK function with IO$M_SET_LIST modifier WRITEL_NO_MTA.C IO$_WRITELBLK function with IO$M_NO_MTA modifier WRITEL_EOI.C IO$_WRITELBLK function with IO$M_EOI modifier SER_POLL.C IO$_SER_POLL function SER_POLL_ALLDEV.C IO$_SER_POLL function with IO$M_ALLDEVICES modifier PAR_POLL.C IO$_PAR_POLL function PAR_POLL_LEAVIS.C IO$_PAR_POLL function with IO$M_LEAVIS modifier PARPOLLCON.C IO$_PARPOLLCON function LOADPARPOLL.C IO$_LOADPARPOLL function PARPOLLDIS.C IO$_PARPOLLDIS function PARPOLLUNCON.C IO$_PARPOLLUNCON function SENSEMODE.C IO$_SENSEMODE function SENSEMODE_CHAR.C IO$_SENSEMODE function with IO$M_CHAR modifier SENSEMODE_IOTYPE.C IO$_SENSEMODE function with IO$M_IOTYPE modifier SETEVENT.C IO$_SETEVENT function REC_EVENT.C IO$_REC_EVENT function REC_EVENT_NOWAIT.C IO$_REC_EVENT function with IO$M_NOWAIT modifier (continued on next page) Installing the IEZ11 Software 2-7 Installing the IEZ11 Software 2.1 General Information Table_2-3_(Cont.)_VAX_C_Example_Programs___________________ File_Specification______________Purpose____________________ REC_EVENT_LEAVIS.C IO$_REC_EVENT function with IO$M_LEAVIS modifier SETMODE_ATTNAST.C IO$_SETMODE function with IO$M_ATTNAST modifier SETMODE_TIMEOUT.C IO$_SETMODE function with IO$M_TIMOUT modifier SETMODE_CHAR.C IO$_SETMODE function with IO$M_CHAR modifier SETMODE_BUFFERED.C IO$_SETMODE function with IO$M_BUFFERED modifier SETMODE_DIRECT.C IO$_SETMODE function with IO$M_DIRECT modifier SERVICE.C IO$_SERVICE function AUXILIARY.C IO$_AUXILIARY function CONFIG.C IO$_CONFIG function CONFIG_KEEP.C IO$_CONFIG function with IO$M_KEEP modifier DIAGNOSE_RESET.C IO$_DIAGNOSE function with IO$M_RESET modifier DIAGNOSE_REMOTE.C IO$_DIAGNOSE function with IO$M_REMOTE modifier DIAGNOSE_READ.C IO$_DIAGNOSE function with IO$M_READ modifier DIAGNOSE_WRITE.C IO$_DIAGNOSE function with IO$M_WRITE modifier SCSI488.C IO$_COMMAND_SCSI488 function SCSI488_RESPONSE.C IO$_COMMAND_SCSI488 function with IO$M_RESPONSE ________________________________modifier___________________ 2-8 Installing the IEZ11 Software Installing the IEZ11 Software 2.1 General Information 2.1.3 The Installation Verification Procedure The Installation Verification Procedure (IVP) for the IEZ11 software verifies the installation. During the installation, VMSINSTAL asks if you want to run the IVP as part of the installation. Type YES, to run it. Digital recommends that you run the IVP to ensure that the IEZ11 software is correctly installed. After you have installed the IEZ11 software, you can run the IVP independently to verify that the software is available on your system. If the installation procedure decides that a system reboot is required either to complete the installation, or after a system failure during installation, you might need to run the IVP manually to make sure that users can access the IEZ11 software. You can only run the IVP successfully from a system that has all the prerequisite hardware and software installed. To do this enter the following DCL command: $ RUN SYS$TEST:IEZ11$IVP 2.1.4 Aborting the Installation 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. Installing the IEZ11 Software 2-9 Installing the IEZ11 Software 2.2 The Installation Procedure 2.2 The Installation Procedure The IEZ11 software installation procedure consists of a series of questions and informational messages. 2.2.1 Invoking VMSINSTAL To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. Use the following syntax to invoke VMSINSTAL: @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N saveset-name This is the installation name for the component. For the IEZ11 software, use the following installation name: IEZ11021 device-name This is the name of the device on which you intend to mount the media. For example, MKA500: is the device name for a cartridge tape drive. It is not necessary to use the console drive for this installation. However, if you do use the console drive, replace any media you removed once the installation is complete. OPTIONS N This is an optional parameter indicating that you want to see the release notes question. This question asks you if you want to read the release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. Digital advises you to read the release notes before continuing with the installation, in case they contain new information about the installation. You can select several other options when you invoke VMSINSTAL. See the OpenVMS documentation on software installation in the VMS System Management Subkit for information on these options. If you specify more than one option, separate the options with commas (OPTIONS A,N). The following example invokes VMSINSTAL to install the IEZ11 software from TK50 tape drive MKA500: and shows the system response. This example uses the OPTIONS N release notes parameter. 2-10 Installing the IEZ11 Software Installing the IEZ11 Software 2.2 The Installation Procedure $ @SYS$UPDATE:VMSINSTAL IEZ11021 MKA500: OPTIONS N VAX/VMS Software Product Installation Procedure V5.5-2 It is 14-Feb-1993 at 19:58. Enter a question mark (?) at any time for help. If you do not enter either the product name, or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL also prompts you for options, if you do not enter the product name in the command line. 2.2.2 Installation Questions This section describes the questions that are displayed during the installation. Appendix A contains a sample installation procedure showing how you can answer the questions. Each question in the installation is marked with an asterisk (*) at the start of the line. Some questions show the default response in brackets [], for example [YES]. To use the default response, press Return. 1. System backup VMSINSTAL asks if you are satisfied with your system backup. It is advisable to back up your system disk before installing the IEZ11 software. If you are satisfied with your system disk backup, press Return. Otherwise, type NO to discontinue the installation. After you back up your system disk, you can restart the installation. * Are you satisfied with the backup of your system disk [YES]? 2. Mounting the media VMSINSTAL asks you to mount the first distribution volume on the device you specified when you invoked VMSINSTAL. Then VMSINSTAL asks you if you are ready to continue with the installation. Installing the IEZ11 Software 2-11 Installing the IEZ11 Software 2.2 The Installation Procedure If you type YES to indicate that you are ready, VMSINSTAL displays a message that the media containing the IEZ11 software has been mounted on the specified device, and that the installation has begun. For example: Please mount the first volume of the set on MKA500:. * Are you ready? YES %MOUNT-I-MOUNTED, IEZ11 mounted on _MKA500: The following products will be processed: IEZ11 V2.1 Beginning installation of IEZ11 V2.1 at 20:01 %VMSINSTAL-I-RESTORE, Restoring product saveset A... If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, type NO in response to the question: "Are you ready?". To abort the installation for other reasons, press CTRL/Y. If you specified OPTIONS N when you started the installation, VMSINSTAL displays a release notes question. You have four options for handling the release notes under VMS Version 5.4 or higher. For VMS Version 5.4 or higher the display is as follows: 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 choose option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing CTRL/C. 2-12 Installing the IEZ11 Software Installing the IEZ11 Software 2.2 The Installation Procedure If you choose option 2, VMSINSTAL prompts you for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: You can press Return to send the file to the default output print device, or you can enter another queue name. If you choose option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. VMSINSTAL automatically copies the IEZ11 software release notes to the system help directory. The file specification is: SYS$HELP:IEZ11021.RELEASE_NOTES Choose option 4 if you have already read the release notes and are restarting the installation. 3. Continuing the installation The installation procedure now asks if you want to continue the installation. To continue, type YES. Otherwise, press Return. In either case, the release notes are copied to a file in the SYS$HELP directory. For example: * Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. The release notes are in the following file: SYS$HELP:IEZ11021.RELEASE_NOTES ________________________ Note ________________________ The name of the release notes file installed by VMSINSTAL consists of the current product name and version number. Do not delete release notes from previous versions of the IEZ11 software. ______________________________________________________ Installing the IEZ11 Software 2-13 Installing the IEZ11 Software 2.2 The Installation Procedure 4. License Registration The installation procedure displays license information about your product and then asks if you have registered and loaded your PAK for the IEZ11 class driver. For example: Product: IEZ11-CLASS-DRIVER Producer: DEC Version: 2.1 Release Date: 04-APR-1993 * Does this product have an authorization key registered and loaded? If you have not registered and loaded your PAK, you must answer NO to this question. You have to register and load your product authorization key to successfully complete the installation. If you have not done so, stop the installation, register and load your product authorization key, and then restart the installation. 5. Specifying the number of IEZ11s you want to support The IEZ11 class driver can concurrently support a large number of IEZ11s. However, the maximum number of IEZ11s that the system can support is determined by the system configuration. During the installation, VMSINSTAL determines and displays the SCSI bus configuration, as known to OpenVMS. However, at this point, VMSINSTAL cannot detect either the SCSI devices that are currently not known to the running OpenVMS operating system, or nonstandard SCSI devices, such as nondisk and nontape devices. These nondetectable devices are indicated as unused in the message. You must ensure that all SCSI IDs assigned to IEZ11 devices during this installation are unique. For example, on a VAXstation 4000 Model 60 the message is as follows: 2-14 Installing the IEZ11 Software Installing the IEZ11 Software 2.2 The Installation Procedure Your current SCSI device configuration, as known to OpenVMS, contains: 2 disks 1 tape The current SCSI ID assignment for SCSI bus A is: 0 1 2 3 4 5 6 7 unused unused DKA200 DKA300 unused MKA500 *CPU* unused You may connect up to 4 IEZ11 SCSI488/D bus converters to the external SCSI connector of your VAXstation or MicroVAX. WARNING: Connecting more than two IEZ11 SCSI488/D bus converters may conflict with future system hardware extensions. Carefully read this message. Consider the implications of nonstandard SCSI devices, if your configuration includes those. Consider also your future plans to add disk and tape devices to the system. Finally, choose the SCSI IDs that you want to assign for IEZ11 use. VMSINSTAL asks you for the total number of IEZ11 devices you intend to connect. * How many IEZ11 bus converters will you connect to the SCSI port [1]: 2 Then VMSINSTAL prompts you for each free SCSI ID until the specified number of IEZ11s have been assigned to free SCSI IDs. An example of the assignment of two SCSI488/Ds is as follows: * Use device EKA0:, SCSI ID 0 (currently unused) [Y]? Y * Use device EKA1:, SCSI ID 1 (currently unused) [Y]? N WARNING: SCSI ID 4 is normally used for a disk device, but appears to be free. * Use device EKA4:, SCSI ID 4 (currently unused) [Y]? Y In the above example note the warning message at the assignment of SCSI ID 4. This message is always displayed for SCSI IDs, which are by convention used for standard devices, but seem to be free in the current system. If you get a warning message carefully check, if this particular SCSI ID is free for assignment. If a Installing the IEZ11 Software 2-15 Installing the IEZ11 Software 2.2 The Installation Procedure SCSI ID is shown to be already assigned to an IEZ11 in the current configuration, you must answer Yes to retain this assignment. 2-16 Installing the IEZ11 Software Installing the IEZ11 Software 2.2 The Installation Procedure After the successful assignment of SCSI IDs to all requested SCSI488/Ds, VMSINSTAL displays the resulting SCSI bus configuration: The current SCSI ID assignment for SCSI bus A is: 0 1 2 3 4 5 6 7 EKA0 unused DKA200 DKA300 EKA4 MKA500 *CPU* unused IEZ11 IEZ11 6. Choosing to purge files You can choose to purge files from previous versions of the IEZ11 software that have been replaced by this installation. Digital recommends that you purge these files. However, if you need to keep files from the previous version, type NO in response to the following question: * Do you want to purge files replaced by this installation [YES]? 7. Choosing to run the Installation Verification Procedure (IVP) If the EKDRIVER is not already loaded in the active OpenVMS operating system, the installation procedure asks you if you want to run the IVP. If a version of the EKDRIVER is already loaded, you cannot run the IVP during the installation. This is because the EKDRIVER cannot be replaced in the active OpenVMS system without a reboot. You have to run the IVP manually after rebooting the system. To run the IVP manually, enter the following DCL command: $ RUN SYS$TEST:IEZ11$IVP The IVP, for the IEZ11 software, checks that the installation is successful. In addition it verifies that the software can communicate with the IEZ11. * Do you want to run the IVP after the installation [YES]? 8. Allowing the system to reboot automatically after installation If some version of the EKDRIVER is already loaded in the active OpenVMS system, you must reboot the system to complete the installation. VMSINSTAL now asks if you will allow a reboot to be initiated by the installation Installing the IEZ11 Software 2-17 Installing the IEZ11 Software 2.2 The Installation Procedure procedure. To defer the reboot type NO. You can safely defer the system reboot to any time. However, you cannot use the newly installed version of the EKDRIVER until you reboot your system. * Will you allow a system shutdown after this product is installed [YES]? * How many minutes for system shutdown [0]? * Do you want to do an automatic system reboot [YES]? 2.2.3 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 if necessary updates DCL tables. If you had previously indicated that you want to purge files, VMSINSTAL will now purge files. The following message is displayed: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... 2-18 Installing the IEZ11 Software Installing the IEZ11 Software 2.2 The Installation Procedure 2.2.4 Running the Installation Verification Procedure If you chose to run the IVP and a system reboot is not required, VMSINSTAL runs the IVP now. If you receive the following message, it means that the IVP is successful: *** IEZ11 VMS Class Driver Installation Verification Program *** EKA0: Success: SCSI488/D Revision 4.6 (C) Copyright 1992 IOtech Inc. This last line is displayed for each device configured during this installation. Running the IVP program is a convenient way of finding out the current firmware revision of the IEZ11. The firmware revision may be higher but never less than version 4.5. The revision number may be followed by a single letter to denote minor variations. 2.2.5 Completing the Installation Procedure The following messages indicate that the entire installation procedure is complete: Installation of IEZ11 V2.1 completed at 20:07 VMSINSTAL procedure done at 20:09 You can now log out of the privileged account: $ LOGOUT SYSTEM logged out at 14-Feb-1993 20:10:34.78 ________________________ 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 account and you want to restore these symbols, log out and log in again. ______________________________________________________ Installing the IEZ11 Software 2-19 Installing the IEZ11 Software 2.3 Error Recovery 2.3 Error Recovery If errors occur during the installation or when the IVP is running, VMSINSTAL displays failure messages. If the installation fails, the following message is displayed: %VMSINSTAL-E-INSFAIL, The installation of IEZ11 V2.1 has failed. If the IVP fails, the OpenVMS operating system displays a message in the following form: %SYSTEM-F-xxxxx, ... This message indicates the reason for the IVP failure. Because this is a standard OpenVMS error message, you can get more information from the VMS System Messages and Recovery Procedures manuals. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect o A prerequisite software version is incorrect o Quotas necessary for successful installation are insufficient o System parameter values for successful installation are insufficient o The product license has not been registered and loaded o Prerequisite hardware is incorrect o Hardware is offline or not configured properly For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on the following topics: system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, take the appropriate action as described in the message. (You might need to change a system parameter or increase an authorized quota value.) For information on installation requirements, see Chapter 1. 2-20 Installing the IEZ11 Software 3 _________________________________________________________________ After Installing the IEZ11 Software After installing the IEZ11 software, modify the system startup file to call the IEZ11 startup procedure. This causes the IEZ11 class driver to be loaded automatically when the system is booted. If you do not perform this step, you must call the IEZ11 startup procedure to load the driver after booting. 3.1 Editing the System Startup File Edit the system startup file to enable the automatic loading and reconfiguring of the IEZ11 class driver, when your system is rebooted. Add the following command line to the system startup file, SYS$MANAGER:SYSTARTUP_V5.COM: $ @SYS$STARTUP:IEZ11$STARTUP.COM 3.2 VAXcluster Considerations For every node in the cluster, on which you intend to use the IEZ11, include the call to the IEZ11 startup procedure. These nodes must have the required hardware and software prerequisites as described in Chapter 1. Do not include this call for other nodes. You must alter the startup procedure for each node, so that it reflects that particular node's hardware and software configuration. Use the command procedure SYS$MANAGER:IEZ11$CONFIG.COM to create these startup files. Log in to the SYSTEM account on each node on which you want to use the IEZ11 class driver. Use the following DCL command to start the CONFIG procedure: After Installing the IEZ11 Software 3-1 After Installing the IEZ11 Software 3.2 VAXcluster Considerations $ @SYS$MANAGER:IEZ11$CONFIG The dialog produced by the CONFIG procedure is exactly the same as the SCSI ID assignment part of a full installation. This is because IEZ11$CONFIG.COM is also used by the installation procedure. 3.3 Determining and Reporting Problems If you have a problem while using IEZ11, report it to Digital. Depending on the kind of problem and the type of support you have, you can take one of the following actions: o Phone Digital if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). o Fill out and submit a Reader's Comments form, if the problem concerns the IEZ11 documentation. Reader's Comments forms are at the back of each manual. Use the form from the manual in which you found the error. Include the section and page number in which the problem occurred. Read the Software Product Description (SPD) for the DEC IEZ11 Class Driver for OpenVMS and the Warranty Addendum for an explanation of the warranty. If you find a problem during the warranty period, report the problem as indicated previously, or follow alternative instructions provided by Digital for reporting SPD nonconformance problems. 3-2 After Installing the IEZ11 Software A _________________________________________________________________ Sample Installation This appendix contains a sample installation of the IEZ11 software. This sample was run on a system that had no previous version of the IEZ11 software installed. The Installation Verification Procedure (IVP) runs at the end of the installation. Welcome to VAX/VMS V5.5-2 Username: SYSTEM 1 Password: Welcome to VAX/VMS version V5.5-2 Last interactive login on Thursday, 14-FEB-1993 18:07 Last non-interactive login on Thursday, 14-FEB-1993 17:41 $ @SYS$UPDATE:VMSINSTAL 2 VAX/VMS Software Product Installation Procedure V5.5-2 It is 14-FEB-1993 at 18:20. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? 3 * Where will the distribution volumes be mounted: MKB500: 4 Enter the products to be processed from the first distribution volume set. * Products: IEZ11021 5 * Enter installation options you wish to use (none): Please mount the first volume of the set on MKB500:. * Are you ready? YES 6 %MOUNT-I-MOUNTED, IEZ11 mounted on _MKB500: The following products will be processed: IEZ11 V2.1 7 Beginning installation of IEZ11 V2.1 at 18:25 Sample Installation A-1 Sample Installation %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. 8 Product: IEZ11-CLASS-DRIVER 9 Producer: DEC Version: 2.1 Release Date: 04-APR-1993 * Does this product have an authorization key registered and loaded? YES Your current SCSI device configuration, as known to VMS, contains: 2 disks 1 tape 10 The current SCSI ID assignment for SCSI bus A is: 0 1 2 3 4 5 6 7 unused unused unused DKB300 DKB400 MKB500 *CPU* unused You may connect up to 4 IEZ11 SCSI488/D bus converters to the external SCSI connector of your VAXstation or MicroVAX. 11 WARNING: Connecting more than two IEZ11 SCSI488/D bus converters may conflict with future system hardware extensions. * How many IEZ11 bus converters will you connect to the SCSI port [1]: 2 12 * Use device EKA0:, SCSI ID 0 (currently unused) [Y]? Y * Use device EKA1:, SCSI ID 1 (currently unused) [Y]? N WARNING: SCSI ID 2 is normally used for a disk device, but appears to be free.13 * Use device EKA2:, SCSI ID 2 (currently unused) [Y]? Y The current SCSI ID assignment for SCSI bus A is: 14 0 1 2 3 4 5 6 7 EKA0 unused EKA2 DKA300 DKA400 MKA500 *CPU* unused IEZ11 IEZ11 The following files will be provided by this kit: 15 A-2 Sample Installation Sample Installation SYS$LIBRARY:IEZ11$DEF.ADA SYS$LIBRARY:IEZ11$DEF.BAS SYS$LIBRARY:IEZ11$DEF.FOR SYS$LIBRARY:IEZ11$DEF.H SYS$LIBRARY:IEZ11$DEF.MAR SYS$LIBRARY:IEZ11$DEF.PAS SYS$LIBRARY:IEZ11$DEF.PLI SYS$LIBRARY:IEZ11$DEF.R32 SYS$LIBRARY:IEZ11$LIB.MLB SYS$LIBRARY:IEZ11$EX.UID SYS$MANAGER:IEZ11$CONFIG.COM SYS$LOADABLE_IMAGES:EKDRIVER.EXE SYS$TEST:IEZ11$IVP.EXE SYS$SYSTEM:IEZ11$ITADS.EXE SYS$SYSTEM:IEZ11$EX.EXE SYS$HELP:IEZ11$EX.HLB In addition to these mandatory files, a couple of example programs are provided in SYS$SYSHELP:[EXAMPLES.IEZ11]. All example programs 16 are provided as Macro-32 and as VAX C version and are documented in the IEZ11 User's Guide. The system specific startup commands are placed in: SYS$SPECIFIC:[SYS$STARTUP]IEZ11$STARTUP.COM 17 * Do you want to purge files replaced by this installation [YES]? YES * Do you want to run the IVP after the installation [YES]? YES 18 *** Thank you, no more questions will be asked. *** %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSHLP.EXAMPLES.IEZ11]. 19 %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... *** IEZ11 VMS Class Driver Installation Verification Program *** 20 EKA0: Success: SCSI488/D Revision 4.6 (C) Copyright 1992 IOtech Inc. EKA2: ****** F a i l u r e ****** (see below) %SYSTEM-F-DEVOFFLINE, device is not in configuration or not available The installation verification program reported some errors. Please check if all configured IEZ11 SCSI488/D bus converters 21 are connected to this MicroVAX or VAXstation by an appropriate SCSI cable, the SCSI bus routed and terminated properly, and all SCSI488/D Bus Controllers are powered on. After correcting these problems, please re-run the installation verification program using the DCL command $ RUN SYS$TEST:IEZ11$IVP from a sufficiently privileged account (LOG_IO required). If you still get error reports, please consult the IEZ11 hardware and software documentation for further assistance or contact your Digital Field Service representative. Sample Installation A-3 Sample Installation Installation of IEZ11 V2.1 completed at 18:36 Enter the products to be processed from the next distribution volume set. * Products: EXIT 22 VMSINSTAL procedure done at 18:38 $ LOGOUT SYSTEM logged out at 14-FEB-1993 18:37:29.06 1 Log in to the SYSTEM account. 2 Invoke VMSINSTAL.COM. 3 Digital recommends that you make a backup copy of your system disk before you start installing software. 4 In this case, the distribution kit is on the (external) TK50 tape drive. 5 The product designator for the IEZ11 software kit Version 2.1 is IEZ11021. 6 In the case of removable media, for example the TK50 cartridge, VMSINSTAL prompts you to make the (first) volume ready for mounting. 7 The distribution volume is scanned for the specified product(s), which are then listed here. 8 VMSINSTAL always places a copy of the online release notes in SYS$SYSHELP with the file name IEZ11021.RELEASE_NOTES. 9 VMSINSTAL displays the software license information for the current version of the IEZ11 class driver on the terminal. The license information must match the information on the Product Authorization Key (PAK), which you must install and load on the system before the start of the software installation. 10 During installation, VMSINSTAL invokes the configuration procedure IEZ11$CONFIG.COM, which first displays the usage of SCSI IDs. In this case, the system contains two disks on SCSI IDs 3 and 4, and a tape on SCSI ID 5. The CPU itself holds SCSI ID 6. The SCSI IDs 0, 1, 2 and 7 seem to be free. A-4 Sample Installation Sample Installation 11 Based on the number of currently free SCSI IDs, you can add up to four SCSI488/Ds to the existing configuration in this case. This may vary from installation to installation, depending on the current configuration known to VMS. 12 The connection of only two SCSI488/Ds was requested. You will be prompted for each free SCSI ID, until the number of SCSI488/Ds that you requested are configured. 13 If a certain SCSI ID is usually used for a standard device (disk or tape), you will receive a warning message. 14 VMSINSTAL displays the final SCSI ID usage. 15 These are the mandatory files from the IEZ11 software kit. 16 A large number of example programs are provided, written in both Macro-32 and VAX C. 17 If the current system fulfills all requirements to run the IEZ11 class driver, VMSINSTAL generates a startup file containing all required commands to load the driver into the system. 18 This question is displayed only if the current configuration fulfills all requirements to run the IEZ11 class driver. 19 This informational message shows the exact location of the example programs mentioned previously. 20 These lines are written by the IVP. In this particular installation, the first SCSI488/D was switched to SCSI ID 0 and the second to SCSI ID 1. However, the driver configured the first SCSI488/D with SCSI ID 0 (EKA0:) and the second SCSI488/D incorrectly with SCSI ID 2 (EKA2:). As a result the verification program reports success for the first and failure for the second SCSI488 /D. Note that the success message contains the firmware revision of the SCSI488/D, which should always be 4.1 or higher. In case of failure, the message, beginning with the string %SYSTEM-F-xxxx, explains the cause of the failure. Sample Installation A-5 Sample Installation 21 VMSINSTAL displays this text if a failure is reported from the IVP. 22 This is the usual way to terminate VMSINSTAL. A-6 Sample Installation _________________________________________________________________ Index A______________________________ F______________________________ Account quotas, 1-6 FILLM, 1-6 Additional software products, Firmware revision, 2-19 1-2 Associated documents, v I______________________________ ASTLM, 1-6 IEEE488 bus converter, v, 1-1 B IEZ11, 1-1 _______________________________ compatible programming BIL, 1-1 languages, 1-2 BIOLM, 1-6 developing applications, 1-2 BOM, 1-1 startup procedure, 3-1 BYPASS, 1-4 IEZ11 class driver, 1-1 BYTLM, 1-6 execution, 1-3 IEZ11 Exerciser, 1-2 C______________________________ IEZ11 hardware installation CMKRNL, 1-4 guide, v CONFIG procedure, 3-1 IEZ11 software, 1-1 Conventions, vii reinstallation, 1-4 IEZ11 user's guide, v D______________________________ Installation procedure, 2-10 DIOLM, 1-6 aborting, 1-6, 2-9 allowing automatic system E reboot, 2-17 _______________________________ completion message, 2-19 EKDRIVER, 2-17 error recovery, 2-20 ENQLM, 1-6 example programs provided by Errors, 2-20 the IEZ11 software, 2-4, 2-6 files added to your system, 2-2 files provided by the IEZ11 software, 2-3 Index-1 Installation procedure Logging in, 2-19 (cont'd) Logging out, 2-19 from a TK50 tape drive, 2-10 general information, 2-1 N______________________________ informational messages, 2-18 Nomenclature, 1-1 license registration, 2-14 mounting the media, 2-11 O______________________________ move files, 2-18 Online release notes, 1-1, problems, 1-6 purge files, 2-18 2-10 purging files, 2-17 accessing, 2-1 sample, A-1 display, 2-12 specifying number of IEZ11s print, 2-13 to support, 2-14 terminate display, 2-12 system backup, 2-11 OpenVMS license management update DCL tables, 2-18 facility (LMF), 1-3 update help files, 2-18 verifying, 2-9 P______________________________ Installation procedure Preparations, 1-1 requirements, 1-4 Prerequisite and optional backing up system disk, 1-6 software, 1-2 disk space, 1-4 Prerequisite hardware, 1-2 privileges, 1-4 Privileged account, 1-6 time, 1-4 Privileges, 1-4 time from RX23 floppy disk, Problems 1-4 determining, 3-2 VMSINSTAL requirements, 1-6 reporting, 3-2 Installation verification Process symbol tables, 2-19 procedure, 2-9 Product authorization key, execution, 2-19 2-14 manual execution, 2-17 Product authorization key running, 2-9 (PAK), 1-3 running manually, 2-9 Product name, 2-13 success message, 2-19 Installation verification Q procedure (IVP), 1-3, 2-17 _______________________________ Quotas for installation, 1-6 L______________________________ R LICENSE REGISTER command, 1-3 _______________________________ License registration, 1-3, Reader's comments form, 3-2 2-14 Release notes, 2-12 VMSLICENSE.COM procedure, Requirements, 1-1 1-3 Index-2 VMSINSTAL (cont'd) S______________________________ OPTIONS, 2-1 Sample installation, A-1 OPTIONS qualifier, 2-10 SCSI bus configuration saveset-name, 2-10 display, 2-14 VMSINSTAL requirements, 1-6 SCSI port driver, 1-2 SCSI488/D, v, 1-1 W______________________________ SETPRV, 1-4 Warranty Setting default device and addendum, 3-2 directory, 1-6 agreement, 3-2 SHOW DEVICE command, 1-5 period, 3-2 Software contract, 3-2 WORLD, 1-4 Software performance report (SPR), 3-2 Supported systems, 1-2 SYS$UPDATE, 1-6 SYSGEN, 1-2 SYSPRV, 1-4 SYSTEM account, 2-10 System help directory, 2-13 System manager account, 1-3 System reboot, 2-9 System startup file, 3-1 editing, 3-1 System support addendum, v U______________________________ Users logged in to system, 1-6 V______________________________ VAX family supported systems, 1-2 VAXcluster considerations, 3-1 VAXcluster environment, 1-2, 1-3 mixed, 1-4 VAXstation 4000 model 60, 2-14 VMS distribution kit, 1-2 VMS system management subkit, 1-6, 2-10 VMSINSTAL device-name, 2-10 failure messages, 2-20 invoking, 2-10 Index-3