IEZ11 Software Installation Guide Order Number: AA-PA9DA-TE March 1990 Revision/Update Information: This is a new guide. digital equipment corporation galway, ireland Theusoftware described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. © Digital Equipment Corporation 1990. All Rights Reserved. Printed in Ireland. The READER'S COMMENTS form on the last page of this docu- ment requests the user's critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: ALL-IN-1 EduSystem RT DEC IAS ULTRIX DEC/CMS MASSBUS UNIBUS DEC/MMS PDP VAX DECnet PDT VAXcluster DECmate P/OS VMS DECsystem-10 Professional VT DECSYSTEM-20 Q-bus Work Processor DECUS Rainbow DECwriter RSTS DIBOL RSX DIGITAL 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. Contents ________________________________________________________________ Preface ......................................................... v ________________________________________________________________ Chapter 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-5 1.5.5 Backing Up Your System Disk.............. 1-6 iii ________________________________________________________________ Chapter 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-7 2.1.4 Aborting the Installation ................ 2-8 2.2 The Installation Procedure ....................... 2-9 2.2.1 Invoking VMSINSTAL......................... 2-9 2.2.2 Installation Questions.................... 2-10 2.2.3 Informational Messages.................... 2-14 2.2.4 Running the Installation Verification Procedure................................... 2-15 2.2.5 Completing the Installation Procedure .. 2-15 2.3 Error Recovery ..................................... 2-16 ________________________________________________________________ Chapter 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 ________________________________________________________________ Appendix A Sample Installation iv ________________________________________________________________ Index ________________________________________________________________ Tables 1-1 Nomenclature........................................ 1-1 1-2 Disk Space Requirements........................... 1-5 2-1 Files Provided by the IEZ11 Software Installation........................................ 2-2 2-2 Macro-32 Example Programs ........................ 2-3 2-3 VAX C Example Programs............................ 2-5 v Preface ________________________________________________________________ _________________________________________________________________ Purpose of This Guide 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 suc- ceed, 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 1.0 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. v _________________________________________________________________ Associated Documents This guide has the following associated documents: o IEZ11 Hardware Installation Guide (AA-PA9EA-TE) o IEZ11 User's Guide (AA-NU45A-TE) o Software Product Description (SPD) for the DEC IEZ11 Class Driver for VMS (AE-NU46A-TE) o System Support Addendum (SSA) for the DEC IEZ11 Class Driver for VMS (SSA: 31.41.xx) (AE-NU47A-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 upper- case. CTRL/C For sequences that use the CTRL key, hold down CTRL and press the second key. VSmv_RES_Svec System displays used as examples are shown in monospace type. italics Italics are used to emphasize a term or ____________________phrase.__________________________________ vii Chapter 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_VMS 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. Preparing to Install the IEZ11 Software 1-1 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 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. _________________________________________________________________ 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 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 VMS. In a VAXcluster environment, you can install the IEZ11 soft- ware 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 in order to operate. This driver is part of the VAX/VMS operating system. The port driver is distributed with the regular VMS distribution kit, Version 5.1B and higher. 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 V5.3 of the VAX/VMS operating system. For a more detailed description of which version of VMS 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 VMS. You do not require optional software to install, or operate the IEZ11 class driver. However, if you want to develop ap- plications for the IEZ11, you may require additional software products, depending on the particular application's require- ments. 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 VMS. 1-2 Preparing to Install the IEZ11 Software _________________________________________________________________ 1.3 License Registration You must register the IEZ11-CLASS-DRIVER license through the VMS 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 informa- tion 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 VMS, 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 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 VAX/VMS operating system. In mixed version VAXclusters, you must install the IEZ11 software indepen- dently under each version of VMS. You must not copy the software from one system disk to another. Preparing to Install the IEZ11 Software 1-3 _________________________________________________________________ 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 stan- dalone VAXstation 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 IEZ11 software installation. 1-4 Preparing to Install the IEZ11 Software Table 1-2: Disk Space Requirements _____________________________________________________________ Blocks During Blocks After Kit_______________Installation_____Installation______________ IEZ11 Version 1200 850 1.0__________________________________________________________ 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 _________________________________________________________________ 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 instal- lation. 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. Preparing to Install the IEZ11 Software 1-5 _________________________________________________________________ 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 Chapter 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 installa- tion 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 in- voke VMSINSTAL and then answer the relevant question during installation. This question is near the start of the instal- lation 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. Once you have installed the IEZ11 software, you can locate the release notes in the following file: SYS$HELP:IEZ11010.RELEASE_NOTES Installing the IEZ11 Software 2-1 _________________________________________________________________ 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. Table 2-1: Files Provided by the IEZ11 Software Installation _____________________________________________________________ File_Specification______________Purpose______________________ SYS$LOADABLE_IMAGES:EKDRIVER.EXEIEZ11 class driver SYS$LIBRARY:IEZ11$DEF.ADA IEZ11 VAX Ada language sup- port file SYS$LIBRARY:IEZ11$DEF.BAS IEZ11 VAX BASIC language support file SYS$LIBRARY:IEZ11$DEF.FOR IEZ11 VAX FORTRAN language support file SYS$LIBRARY:IEZ11$DEF.H IEZ11 VAX C language support file SYS$LIBRARY:IEZ11$DEF.MAR IEZ11 VAX MACRO language support file SYS$LIBRARY:IEZ11$DEF.PAS IEZ11 VAX PASCAL 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 proce- dure, provided only if SCSI port present SYS$SYSTEM:IEZ11$IVP.EXE IEZ11 installation verifica- tion procedure (IVP) SYS$MANAGER:IEZ11$CONFIG.COM IEZ11 configuration procedure SYS$SYSTEM:IEZ11$ITADS.EXE IEZ11 installation test and ________________________________demonstration_utility________ 2-2 Installing the IEZ11 Software 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 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 _____________________________________________________________ (continued on next page) Installing the IEZ11 Software 2-3 Table 2-2 (Cont.): Macro-32 Example Programs _____________________________________________________________ File_Specification______________Example_of___________________ 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 AUXILIARY.MAR IO$_AUXILIARY function CONFIG.MAR IO$_CONFIG function CONFIG_KEEP.MAR IO$_CONFIG function with IO$M_KEEP modifier _____________________________________________________________ (continued on next page) 2-4 Installing the IEZ11 Software Table 2-2 (Cont.): Macro-32 Example Programs _____________________________________________________________ File_Specification______________Example_of___________________ 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 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 _____________________________________________________________ (continued on next page) Installing the IEZ11 Software 2-5 Table 2-3 (Cont.): VAX C Example Programs _____________________________________________________________ File_Specification______________Purpose______________________ 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 REC_EVENT_LEAVIS.C IO$_REC_EVENT function with IO$M_LEAVIS modifier _____________________________________________________________ (continued on next page) 2-6 Installing the IEZ11 Software Table 2-3 (Cont.): VAX C Example Programs _____________________________________________________________ File_Specification______________Purpose______________________ 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.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 in- stallation. Type YES, to run it. Digital recommends that you run the IVP to ensure that the IEZ11 software is correctly installed. Installing the IEZ11 Software 2-7 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 instal- lation, 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$SYSTEM: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. 2-8 Installing the IEZ11 Software _________________________________________________________________ 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: IEZ11010 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 con- sole 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 VMS documentation on software instal- lation 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 sys- tem response. This example uses the OPTIONS N release note parameter. Installing the IEZ11 Software 2-9 $ @SYS$UPDATE:VMSINSTAL IEZ11010 MKA500: OPTIONS N VAX/VMS Software Product Installation Procedure V5.3 It is 5-Jan-1990 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 de- fault 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. 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: 2-10 Installing the IEZ11 Software 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 V1.0 Beginning installation of IEZ11 V1.0 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 "Are you ready?" question. To abort the installation for other reasons, press CTRL/Y. If you specified OPTIONS N when you started the installa- tion, VMSINSTAL asks a release notes question. You have four options for handling the release notes under VMS Version 5.3 or higher. For VMS Version 5.3 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 termi- nate the display at any time by pressing CTRL/C. 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:IEZ11010.RELEASE_NOTES Choose option 4 if you have already read the release notes and are restarting the installation. Installing the IEZ11 Software 2-11 3. Continuing the installation The installation procedure now asks if you want to con- tinue 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:IEZ11010.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. 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 exam- ple: Product: IEZ11-CLASS-DRIVER Producer: DEC Version: 1.0 Release Date: 30-MAR-1990 * 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 com- plete 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 installation, VMSINSTAL determines and displays the SCSI bus configuration, as known to VMS. Note however, that VMSINSTAL cannot at this point, detect either SCSI devices currently not known to the running VMS operating system, or nonstandard SCSI devices such as nondisk and nontape devices. These nondetectable devices will be indicated as unused in this message. It is your responsibility to ensure that all SCSI IDs assigned to IEZ11 devices during this installation are unique. On a VAXstation 3100 Model 30 the message looks like: 2-12 Installing the IEZ11 Software Your current SCSI device configuration, as known to VMS, contains: (Pure internal SCSI buses not shown) 2 disks 1 tape The current SCSI ID assignment 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 as- signment 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 SCSI ID is shown to be already assigned to an IEZ11 in the current configura- tion, you must answer Yes to retain this assignment. After the successful assignment of SCSI IDs to all re- quested SCSI488/Ds, VMSINSTAL displays the resulting SCSI bus configuration: The current SCSI ID assignment is: 0 1 2 3 4 5 6 7 EKA0 unused DKA200 DKA300 EKA4 MKA500 *CPU* unused IEZ11 IEZ11 Installing the IEZ11 Software 2-13 6. Choosing to purge files You can choose to purge files from previous versions of the IEZ11 software that have been replaced by this instal- lation. 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 VMS operating system, the installation procedure now asks if you want to run the IVP. If some version of the EKDRIVER is already loaded, the IVP cannot be run during the in- stallation. This is because the EKDRIVER cannot be re- placed in the active VMS system without a reboot. You have to run the IVP manually after rebooting the system. The required DCL command is: $ RUN SYS$SYSTEM:IEZ11$IVP The IVP, for the IEZ11 software, checks that the instal- lation 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 instal- lation If some version of the EKDRIVER is already loaded into the active VMS system, you need to reboot the system to complete the installation. VMSINSTAL now asks if you will allow a reboot to be initiated by the installation 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. * Do you allow a system reboot during this installation [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: 2-14 Installing the IEZ11 Software %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... _________________________________________________________________ 2.2.4 Running the Installation Verification Procedure If you chose to run the IVP and no system reboot is required, VMSINSTAL runs it now. The IVP is successful, if you receive the following message. *** IEZ11 VMS Class Driver Installation Verification Program *** EKA0: Success: SCSI488/D Revision 4.1 (C) Copyright 1989 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.1. 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 V1.0 completed at 20:07 VMSINSTAL procedure done at 20:09 You can now log out of the privileged account: $ LOGOUT SYSTEM logged out at 5-Jan-1990 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-15 _________________________________________________________________ 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 V1.0 has failed. If the IVP fails, the VMS 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 VMS error message, you can ob- tain further information from the VMS System Messages and Recovery Procedures manuals. 2-16 Installing the IEZ11 Software Errors can occur during the installation if any of the fol- lowing conditions exist: o The operating system version is incorrect o A prerequisite software version is incorrect o Quotas necessary for successful installation are insuffi- cient 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 VMS documentation on the following top- ics: system messages, recovery procedures, and VMS software installation. If you are notified that any of these con- ditions 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. Installing the IEZ11 Software 2-17 Chapter 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: $ @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. After Installing the IEZ11 Software 3-1 This is because IEZ11$CONFIG.COM is also used by the instal- lation 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 agree- ment entitles you to telephone support. o Submit a Software Performance Report (SPR). o Fill out and submit a Reader's Comments form, if the prob- lem 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 sec- tion and page number in which the problem occurred. Read the Software Product Description (SPD) for the DEC IEZ11 Class Driver for VMS and the Warranty Addendum for an explanation of 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 Appendix A Sample Installation ________________________________________________________________ This appendix contains a sample installation of the IEZ11 software. This sample was run on a system that had no previ- ous version of the IEZ11 software installed. The Installation Verification Procedure (IVP) runs at the end of the installa- tion. Welcome to VAX/VMS V5.3 Username: SYSTEM 1 Password: Welcome to VAX/VMS version V5.3 on node CSS012 Last interactive login on Thursday, 25-JAN-1990 11:41 Last non-interactive login on Thursday, 25-JAN-1990 11:41 $ @SYS$UPDATE:VMSINSTAL 2 VAX/VMS Software Product Installation Procedure V5.3 It is 25-JAN-1990 at 12:04. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? YES 3 * Where will the distribution volumes be mounted: MKA500: 4 Enter the products to be processed from the first distribution volume set. * Products: IEZ11010 5 * Enter installation options you wish to use (none): Please mount the first volume of the set on MKA500:. * Are you ready? YES 6 %MOUNT-I-MOUNTED, IEZ11 mounted on _MKA500: The following products will be processed: IEZ11 V1.0 7 Beginning installation of IEZ11 V1.0 at 12:05 %VMSINSTAL-I-RESTORE, Restoring product saveset A ... %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. 8 Product: IEZ11-CLASS-DRIVER 9 Producer: DEC Version: 1.0 Release Date: 30-MAR-1990 * Does this product have an authorization key registered and loaded? YES Sample Installation A-1 Your current SCSI device configuration, as known to VMS, contains: (Pure internal SCSI buses not shown) 2 disks 1 tape 10 The current SCSI ID assignment 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. 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 4 is normally used for a disk device, but appears to be free.13 * Use device EKA4:, SCSI ID 4 (currently unused) [Y]? Y The current SCSI ID assignment is: 14 0 1 2 3 4 5 6 7 EKA0 unused DKA200 DKA300 EKA4 MKA500 *CPU* unused IEZ11 IEZ11 The following files will be provided by this kit: 15 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$LOADABLE_IMAGES:EKDRIVER.EXE SYS$MANAGER:IEZ11$CONFIG.COM SYS$SYSTEM:IEZ11$ITADS.EXE SYS$SYSTEM:IEZ11$IVP.EXE In addition to these mandatory files, example programs are provided in SYS$SYSHELP:[EXAMPLES.IEZ11]. All example programs are provided as 16 Macro-32 and as VAX C versions 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.1 (C) Copyright 1989 IOtech Inc. EKA4: ****** F a i l u r e ****** (see below) %SYSTEM-F-DEVOFFLINE, device is not in configuration or not available A-2 Sample Installation The installation verification program reported some errors. Please check if all configured SCSI488/D Bus Converters are 21 connected to this MicroVAX or VAXstation by an appropriate SCSI cable, the SCSI bus routed and terminated properly, and all SCSI488/D Bus Converters are powered on. After correcting these problems, please re-run the installation verification program using the DCL command $ RUN SYS$SYSTEM:IEZ11$IVP from a sufficiently privileged account (PHY_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. Installation of IEZ11 V1.0 completed at 12:13 Enter the products to be processed from the next distribution volume set. * Products: EXIT 22 VMSINSTAL procedure done at 12:14 $ LOGOUT SYSTEM logged out at 25-JAN-1990 12:14:44.95 Sample Installation A-3 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 1.0 is IEZ11010. 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 filename IEZ11010.RELEASE_NOTES. 9 VMSINSTAL displays the software license information for the current version of the IEZ11 class driver on the ter- minal. 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 2 and 3, and a tape on SCSI ID 5. The CPU itself holds SCSI ID 6. The SCSI IDs 0, 1, 4 and 7 seem to be free. 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 instal- lation, 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 configu- ration fulfills all requirements to run the IEZ11 class driver. A-4 Sample Installation 19 This informational message shows the exact location of the example programs mentioned above. 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 4 (EKA4:). 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 following %SYSTEM-F-xxxx message explains the cause of the failure. 21 VMSINSTAL displays this text if a failure is reported from the IVP. 22 This is the usual way to terminate VMSINSTAL. Sample Installation A-5 Index ________________________________________________________________ A___________________________ F___________________________ Account quotas, 1-5 FILLM, 1-5 Additional software products Firmware revision, 2-15 , 1-2 I Associated documents, vi ____________________________ ASTLM, 1-5 IEEE488 bus converter, v, B 1-1 ____________________________ IEZ11, 1-1 BIL, 1-2 compatible programming BIOLM, 1-5 languages, 1-2 BOM, 1-2 developing applications, BYPASS, 1-4 1-2 BYTLM, 1-5 startup procedure, 3-1 C IEZ11 class driver, 1-1 ____________________________ execution, 1-3 CMKRNL, 1-4 IEZ11 hardware installation CONFIG procedure, 3-1 guide, vi Conventions, vii IEZ11 software, 1-1 reinstallation, 1-3 D___________________________ IEZ11 user's guide, vi DIOLM, 1-5 Installation procedure, 2-9 aborting, 1-5, 2-8 E allowing automatic system ____________________________ reboot, 2-14 EKDRIVER, 2-14 completion message, 2-15 ENQLM, 1-5 error recovery, 2-16 Errors, 2-17 Index-1 Installation procedure Installation verification (Cont.) procedure (Cont.) example programs provided manual execution, 2-14 by the IEZ11 software, running, 2-7 2-3, 2-5 running manually, 2-8 files added to your system success message, 2-15 , 2-2 Installation verification files provided by the procedure (IVP), 1-3, IEZ11 software, 2-2 2-14 from a TK50 tape drive, L 2-9 ____________________________ general information, 2-1 LICENSE REGISTER command, informational messages, 1-3 2-14 License registration, 1-3, license registration, 2-12 2-12 mounting the media, 2-10 VMSLICENSE.COM procedure, move files, 2-14 1-3 problems, 1-5 Logging in, 2-15 purge files, 2-14 Logging out, 2-15 purging files, 2-14 sample, A-1 N___________________________ specifying number of Nomenclature, 1-1 IEZ11s to support, 2-12 system backup, 2-10 O update DCL tables, 2-14 ____________________________ update help files, 2-14 Online release notes, 1-2, verifying, 2-7 2-9 Installation procedure accessing, 2-1 requirements, 1-4 display, 2-11 backing up system disk, print, 2-11 1-6 terminate display, 2-11 disk space, 1-4 privileges, 1-4 P___________________________ time, 1-4 Preparations, 1-1 time from RX23 floppy Prerequisite and optional disk, 1-4 software, 1-2 VMSINSTAL requirements, Prerequisite hardware, 1-2 1-5 Privileged account, 1-5 Installation verification Privileges, 1-4 procedure, 2-7 Problems execution, 2-15 determining, 3-2 Index-2 Problems (Cont.) U___________________________ reporting, 3-2 Users logged in to system, Process symbol tables, 2-15 1-5 Product authorization key, 2-12 V___________________________ Product authorization key VAXcluster considerations, (PAK), 1-3 3-1 Product name, 2-12 VAXcluster environment, 1-2, Q 1-3 ____________________________ mixed, 1-3 Quotas for installation, 1-5 VAX family supported systems R , 1-2 ____________________________ VAXstation 3100 model 30, Reader's comments form, 3-2 2-12 Release notes, 2-11 VMS distribution kit, 1-2 Requirements, 1-1 VMSINSTAL device-name, 2-9 S___________________________ failure messages, 2-16 Sample installation, A-1 invoking, 2-9 SCSI488/D, v, 1-1 OPTIONS, 2-1 SCSI bus configuration OPTIONS qualifier, 2-9 display, 2-12 saveset-name, 2-9 SCSI port driver, 1-2 VMSINSTAL requirements, 1-5 SETPRV, 1-4 VMS license management Setting default device and facility (LMF), 1-3 directory, 1-5 VMS system management subkit SHOW DEVICE command, 1-5 , 1-6, 2-9 Software contract, 3-2 W Software performance report ____________________________ (SPR), 3-2 Warranty Supported systems, 1-2 addendum, 3-2 SYS$UPDATE, 1-5 agreement, 3-2 SYSGEN, 1-2 period, 3-2 SYSPRV, 1-4 WORLD, 1-4 SYSTEM account, 2-9 System help directory, 2-11 System manager account, 1-3 System reboot, 2-8 System startup file, 3-1 editing, 3-1 System support addendum, vi Index-3