DECvoice VOX V1.1 DECvoice VOX V1.1 DECvoice VOX V1.1 Installation Guide Installation Guide Installation Guide Order Number: AA-PB3HA-TE October 1989 October 1989 October 1989 This book describes how to install DECvoice VOX V1.1 software on a VAX VMS V5.2 or later system. Revision/Update Information: Revision/Update Information: Revision/Update Information: This is a new document. Operating System and Version: Operating System and Version: Operating System and Version: VAX/VMS Version 5.2 Software Version: Software Version: Software Version: DECvoice Version V1.1 ________________________ November 1989 November 1989 November 1989 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software 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. __________ Copyright ©September 1989 Digital Equipment Corporation All Rights Reserved. Printed in U.S.A. The postpaid Reader's Comments forms at the end of this document request your critical evaluation to assist in preparing future documentation. ALL-IN-1 EduSystem RT DEC IAS ULTRIX DEC/CMS MASSBUS UNIBUS DEC/MMS PDP VAX DECnet PDT VAXcluster DECmate P/OS VMS DECvoice Professional VT DECUS Q-bus Work Processor DECwrite Rainbow DECwriter RSTS DIGITAL DIGITAL DIGITAL DIBOL RSX _______________________________________________________ Contents Contents Contents _______________________________________________________ CHAPTER 1 PREPARING TO INSTALL DECVOICE VOX 1-1 CHAPTER 1 PREPARING TO INSTALL DECVOICE VOX 1-1 CHAPTER 1 PREPARING TO INSTALL DECVOICE VOX 1-1 _________________________________________________ 1.1 REQUIRED OPERATING SYSTEM 1.1 REQUIRED OPERATING SYSTEM 1.1 REQUIRED OPERATING SYSTEM COMPONENTS 1-2 COMPONENTS 1-2 COMPONENTS 1-2 _________________________________________________ 1.2 PREREQUISITE AND OPTIONAL 1.2 PREREQUISITE AND OPTIONAL 1.2 PREREQUISITE AND OPTIONAL COMPONENTS 1-2 COMPONENTS 1-2 COMPONENTS 1-2 _________ 1.2.1 Prerequisite Software 1-2 1.2.1 Prerequisite Software 1-2 1.2.1 Prerequisite Software 1-2 _____________ 1.2.2 Optional Software 1-2 1.2.2 Optional Software 1-2 1.2.2 Optional Software 1-2 _________ 1.2.3 Prerequisite Hardware 1-3 1.2.3 Prerequisite Hardware 1-3 1.2.3 Prerequisite Hardware 1-3 _____________ 1.2.4 Optional Hardware 1-4 1.2.4 Optional Hardware 1-4 1.2.4 Optional Hardware 1-4 _________________________________________________ 1.3 VMS LICENSE MANAGEMENT FACILITY 1-4 1.3 VMS LICENSE MANAGEMENT FACILITY 1-4 1.3 VMS LICENSE MANAGEMENT FACILITY 1-4 _________________________________________________ 1.4 INSTALLATION PROCEDURE REQUIREMENTS 1-5 1.4 INSTALLATION PROCEDURE REQUIREMENTS 1-5 1.4 INSTALLATION PROCEDURE REQUIREMENTS 1-5 __________________________ 1.4.1 Time 1-6 1.4.1 Time 1-6 1.4.1 Time 1-6 ____________________ 1.4.2 Privileges 1-6 1.4.2 Privileges 1-6 1.4.2 Privileges 1-6 ____________________ 1.4.3 Disk Space 1-6 1.4.3 Disk Space 1-6 1.4.3 Disk Space 1-6 _____________ 1.4.4 System Parameters 1-7 1.4.4 System Parameters 1-7 1.4.4 System Parameters 1-7 1.4.4.1 Checking System Parameter Values, 1-12 1.4.4.2 Setting the CLISYMTBL Dynamic System Parameter, 1-12 1.4.4.3 Calculating GBLPAGES, GBLPAGFIL and GBLSECTIONS, 1-13 1.4.4.4 Changing System Parameter Values with AUTOGEN, 1-15 ________ 1.4.5 VMSINSTAL Requirements 1-16 1.4.5 VMSINSTAL Requirements 1-16 1.4.5 VMSINSTAL Requirements 1-16 iii iii iii Contents Contents Contents ___ 1.4.6 Backing Up Your System Disk 1-16 1.4.6 Backing Up Your System Disk 1-16 1.4.6 Backing Up Your System Disk 1-16 1.4.7 License Management Utility 1.4.7 License Management Utility 1.4.7 License Management Utility __________________ Requirements 1-17 Requirements 1-17 Requirements 1-17 _______________________________________________________ CHAPTER 2 INSTALLING DECVOICE 2-1 CHAPTER 2 INSTALLING DECVOICE 2-1 CHAPTER 2 INSTALLING DECVOICE 2-1 _________________________________________________ 2.1 GENERAL INFORMATION 2-1 2.1 GENERAL INFORMATION 2-1 2.1 GENERAL INFORMATION 2-1 2.1.1 Accessing the Online Release 2.1.1 Accessing the Online Release 2.1.1 Accessing the Online Release _________________________ Notes 2-1 Notes 2-1 Notes 2-1 2.1.2 VMSINSTAL Directory Creation 2.1.2 VMSINSTAL Directory Creation 2.1.2 VMSINSTAL Directory Creation _______ Messages Can Be Ignored 2-2 Messages Can Be Ignored 2-2 Messages Can Be Ignored 2-2 _ 2.1.3 New Files Added to the System 2-2 2.1.3 New Files Added to the System 2-2 2.1.3 New Files Added to the System 2-2 2.1.4 Logical Names Added to the 2.1.4 Logical Names Added to the 2.1.4 Logical Names Added to the ________________________ System 2-4 System 2-4 System 2-4 2.1.5 Running the Installation 2.1.5 Running the Installation 2.1.5 Running the Installation __ Verification Procedure (IVP) 2-4 Verification Procedure (IVP) 2-4 Verification Procedure (IVP) 2-4 _____ 2.1.6 Aborting the Installation 2-6 2.1.6 Aborting the Installation 2-6 2.1.6 Aborting the Installation 2-6 _________________________________________________ 2.2 THE INSTALLATION PROCEDURE 2-6 2.2 THE INSTALLATION PROCEDURE 2-6 2.2 THE INSTALLATION PROCEDURE 2-6 ____________ 2.2.1 Invoking VMSINSTAL 2-6 2.2.1 Invoking VMSINSTAL 2-6 2.2.1 Invoking VMSINSTAL 2-6 ________ 2.2.2 Installation Questions 2-8 2.2.2 Installation Questions 2-8 2.2.2 Installation Questions 2-8 ________ 2.2.3 Informational Messages 2-13 2.2.3 Informational Messages 2-13 2.2.3 Informational Messages 2-13 2.2.4 Running the Installation 2.2.4 Running the Installation 2.2.4 Running the Installation ________ Verification Procedure 2-13 Verification Procedure 2-13 Verification Procedure 2-13 2.2.5 Completing the Installation 2.2.5 Completing the Installation 2.2.5 Completing the Installation _____________________ Procedure 2-14 Procedure 2-14 Procedure 2-14 _________________________________________________ 2.3 ERROR RECOVERY 2-14 2.3 ERROR RECOVERY 2-14 2.3 ERROR RECOVERY 2-14 iv iv iv Contents Contents Contents _______________________________________________________ CHAPTER 3 AFTER INSTALLING DECVOICE 3-1 CHAPTER 3 AFTER INSTALLING DECVOICE 3-1 CHAPTER 3 AFTER INSTALLING DECVOICE 3-1 _________________________________________________ 3.1 EDITING THE SYSTEM FILES 3-1 3.1 EDITING THE SYSTEM FILES 3-1 3.1 EDITING THE SYSTEM FILES 3-1 _________________________________________________ 3.2 REBOOTING THE SYSTEM 3-2 3.2 REBOOTING THE SYSTEM 3-2 3.2 REBOOTING THE SYSTEM 3-2 _________________________________________________ 3.3 DELETING VOX VERSION V1.0 FILES 3-2 3.3 DELETING VOX VERSION V1.0 FILES 3-2 3.3 DELETING VOX VERSION V1.0 FILES 3-2 _________________________________________________ 3.4 VAXCLUSTER CONSIDERATIONS 3-3 3.4 VAXCLUSTER CONSIDERATIONS 3-3 3.4 VAXCLUSTER CONSIDERATIONS 3-3 _________________________________________________ 3.5 ENHANCING DECVOICE SYSTEM 3.5 ENHANCING DECVOICE SYSTEM 3.5 ENHANCING DECVOICE SYSTEM PERFORMANCE 3-4 PERFORMANCE 3-4 PERFORMANCE 3-4 3.5.1 VMS Guide To Performance 3.5.1 VMS Guide To Performance 3.5.1 VMS Guide To Performance ____________________ Management 3-4 Management 3-4 Management 3-4 3.5.2 Installing DECvoice as a Shared 3.5.2 Installing DECvoice as a Shared 3.5.2 Installing DECvoice as a Shared _________________________ Image 3-4 Image 3-4 Image 3-4 3.5.3 Example Process Account 3.5.3 Example Process Account 3.5.3 Example Process Account ________________________ Quotas 3-5 Quotas 3-5 Quotas 3-5 3.5.4 Process Account Quotas for 3.5.4 Process Account Quotas for 3.5.4 Process Account Quotas for ____________ Large Applications 3-7 Large Applications 3-7 Large Applications 3-7 _________ 3.5.5 Insufficient Pagefile 3-9 3.5.5 Insufficient Pagefile 3-9 3.5.5 Insufficient Pagefile 3-9 ____________ 3.5.6 Disk Fragmentation 3-10 3.5.6 Disk Fragmentation 3-10 3.5.6 Disk Fragmentation 3-10 _________________________________________________ 3.6 GENERAL VMS PROGRAMMING REFERENCES 3-10 3.6 GENERAL VMS PROGRAMMING REFERENCES 3-10 3.6 GENERAL VMS PROGRAMMING REFERENCES 3-10 _________________________________________________ 3.7 DETERMINING AND REPORTING PROBLEMS 3-10 3.7 DETERMINING AND REPORTING PROBLEMS 3-10 3.7 DETERMINING AND REPORTING PROBLEMS 3-10 v v v Contents Contents Contents _______________________________________________________ APPENDIX A SAMPLE INSTALLATION A-1 APPENDIX A SAMPLE INSTALLATION A-1 APPENDIX A SAMPLE INSTALLATION A-1 _______________________________________________________ APPENDIX B TROUBLESHOOTING INFORMATION B-1 APPENDIX B TROUBLESHOOTING INFORMATION B-1 APPENDIX B TROUBLESHOOTING INFORMATION B-1 _______________________________________________________ INDEX INDEX INDEX _______________________________________________________ TABLES TABLES TABLES _______ 1-1 Disk Space Requirements 1-7 1-1 Disk Space Requirements 1-7 1-1 Disk Space Requirements 1-7 _ 1-2 System Parameter Descriptions 1-7 1-2 System Parameter Descriptions 1-7 1-2 System Parameter Descriptions 1-7 1-3 Required System Parameter 1-3 Required System Parameter 1-3 Required System Parameter ________________________ Values 1-10 Values 1-10 Values 1-10 3-1 Process Account Quotas for 3-1 Process Account Quotas for 3-1 Process Account Quotas for ___________ Common Applications 3-6 Common Applications 3-6 Common Applications 3-6 3-2 Process Account Quotas for 3-2 Process Account Quotas for 3-2 Process Account Quotas for ____________ Large Applications 3-7 Large Applications 3-7 Large Applications 3-7 B-1 Troubleshooting DECvoice B-1 Troubleshooting DECvoice B-1 Troubleshooting DECvoice ______________________ Problems B-2 Problems B-2 Problems B-2 vi vi vi _______________________________________________________ 1 Preparing to Install DECvoice VOX 1 Preparing to Install DECvoice VOX 1 Preparing to Install DECvoice VOX This document discusses the preparations and requirements necessary for the installation of DECvoice VOX version V1.1 on a VMS Version V5.2 system. This document supercedes all previous installation information. This document also supercedes chapter one in the , ________ _____ ________ _________ ______ DECvoice DTC04 Software Reference Manual Version V1.1 order number AA-LE86B-TE, and Version V1.0 order number AA-LE86A-TE. [This manual applies to Version 1.1 of DECvoice and all subsequent maintenance releases up to the next major product release.] 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. DECvoice provides online release notes. DIGITAL strongly recommends that you read the Release Notes before proceeding with the installation. The information on a number of DECvoice routines is located only in the release notes document. The documentation for these routines will be incorporated into a future release of the ________ _____ ________ DECvoice DTC04 Software _________ ______ Reference Manual 1-1 1-1 1-1 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX __________________________________________________________________ 1.1 Required Operating System Components 1.1 Required Operating System Components 1.1 Required Operating System Components DECvoice software requires a minimum of the BASE VMS tailoring class for support in a run-time environment. Development of software based on DECvoice requires a minimum of the BASE and PROGRAMMING tailoring classes of VMS. __________________________________________________________________ 1.2 Prerequisite and Optional Components 1.2 Prerequisite and Optional Components 1.2 Prerequisite and Optional Components This section discusses the system hardware and the software you must have installed on your system prior to installing DECvoice. The section also includes information about software that you can use together with DECvoice. Please refer to the System Software Addendum (SSA) for the required versions of these prerequisites. The SSA is a component of the DECvoice Software Product Description, SPD 29.97.01. ___________________________ 1.2.1 Prerequisite Software 1.2.1 Prerequisite Software 1.2.1 Prerequisite Software DECvoice VOX V1.1 requires a minimum of VMS Version V5.2. There are no other prerequisite software products. ___________________________ 1.2.2 Optional Software 1.2.2 Optional Software 1.2.2 Optional Software The DECvoice software functions with the following optional software: o DECvoice Continuous Word Recognizer, Version V1.1, SPD 31.69.00. The Continous Word Recognizer is a seperately licensed product integrated into DECvoice. The Continuous Word Recognizer eliminates the requirement for a pause seperation between spoken digits. The Continuous Word Recognizer, like the Isolated Word Recognizer, can be 'hotswapped' onto a DECvoice module as required. Contact your 1-2 1-2 1-2 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX DIGITAL sales represenative for further information on this product. ___________________________ 1.2.3 Prerequisite Hardware 1.2.3 Prerequisite Hardware 1.2.3 Prerequisite Hardware Note: Note: Note: An incorrectly configured DECvoice hardware interrupt An incorrectly configured DECvoice hardware interrupt An incorrectly configured DECvoice hardware interrupt vector switch setting is the most common source of vector switch setting is the most common source of vector switch setting is the most common source of DECvoice problems. DECvoice problems. DECvoice problems. The SYSGEN utility does display the DECvoice DTC04 The SYSGEN utility does display the DECvoice DTC04 The SYSGEN utility does display the DECvoice DTC04 ___ not not not interrupt vector setting. interrupt vector setting. interrupt vector setting. The only way to determine the current vector setting The only way to determine the current vector setting The only way to determine the current vector setting is to physically remove the DTC04 module from the Q- is to physically remove the DTC04 module from the Q- is to physically remove the DTC04 module from the Q- bus and decode the physical interrupt vector switch bus and decode the physical interrupt vector switch bus and decode the physical interrupt vector switch setting on the interrupt vector switch pack. The setting on the interrupt vector switch pack. The setting on the interrupt vector switch pack. The setting should then be compared to the proper setting, setting should then be compared to the proper setting, setting should then be compared to the proper setting, as displayed by SYSGEN. The switch setting must the as displayed by SYSGEN. The switch setting must the as displayed by SYSGEN. The switch setting must the same as, or must be reset to, the value of the vector same as, or must be reset to, the value of the vector same as, or must be reset to, the value of the vector that is displayed by SYSGEN. Consult the that is displayed by SYSGEN. Consult the that is displayed by SYSGEN. Consult the ________ DECvoice DECvoice DECvoice for information on switch for information on switch for information on switch _____ _________ ______ DTC04 Technical Manual DTC04 Technical Manual DTC04 Technical Manual location, configuration and settings. Contact DIGITAL location, configuration and settings. Contact DIGITAL location, configuration and settings. Contact DIGITAL Field Service for assistance. Field Service for assistance. Field Service for assistance. DECvoice software can be installed on any valid VAX hardware configuration. DECvoice software utilizes the DECvoice DTC04-AA Q- bus module hardware for most speech sythesis, all digitized voice input and output, all telephone handling and for all voice recognition capabilities. 1-3 1-3 1-3 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX ___________________________ 1.2.4 Optional Hardware 1.2.4 Optional Hardware 1.2.4 Optional Hardware A component of the DECvoice speech synthesizer, the Automatic Customer Name and Address (ACNA) routines, can be used in conjunction with a DTC01 or DTC03 DECtalk peripheral, as well as with the DECvoice module. See the information located in the DECvoice V1.1 release notes for documentation on the ACNA capabilities and the VOX$PRONOUNCE_NAME call. __________________________________________________________________ 1.3 VMS License Management Facility 1.3 VMS License Management Facility 1.3 VMS License Management Facility The VMS License Management Facility (LMF) is available with Version V5.0 of the VMS operating system. When you install DECvoice on a VMS system, you must register your software license. The license registration information you need is contained in the Product Authorization Key (PAK) that is shipped with DECvoice. The DECvoice VOX PAK is a paper certificate that contains information about the license; information you are required to have entered into the LMF database, and have loaded into the running VMS system, prior to running the DECvoice VOX software. The license name used by DECvoice VOX is "VOX". It is best to register your DECvoice license before you perform the installation. During the installation, you are asked if you have registered the DECvoice license and loaded the appropriate authorization key. If you have not already done so, you can complete the installation; however, you will not be able to run either the DECvoice software nor the Installation Verification Procedure (IVP, see Section 2.1.5). Once you have performed the license registration and have loaded the authorization key, you will be able to run the IVP and use DECvoice. 1-4 1-4 1-4 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX To register a licenses under VMS V5.0, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to perform the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your Product Authorization Key (PAK). o Issue the LICENSE REGISTER command, at the DCL prompt, specifying the appropriate qualifiers that correspond to the information on the PAK. To display a list of the currently loaded licenses, use the command: $ SHOW LICENSE The DECvoice VOX license, named VOX, will be listed near the end of the display, if the license is currently loaded. The DECvoice VOX V1.1 license release date is 1-SEP-1989. The PAK provided in your software kit will have this date, or a later date, as the software release date. The release date is NOT a license termination date. For complete information on using LMF, see the ___ VMS , included in the _______ __________ _______ ______ License Management Utility Manual VMS V5.0 documentation set. The booklet _ _________ A Practical , order number _____ __ ________ ________ ________ Guide to Managing Software Licenses EJ-31899-76, contains an overview of DIGITAL's software licensing and LMF. __________________________________________________________________ 1.4 Installation Procedure Requirements 1.4 Installation Procedure Requirements 1.4 Installation Procedure Requirements This following sections discuss various requirements for installing DECvoice. 1-5 1-5 1-5 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX ___________________________ 1.4.1 Time 1.4.1 Time 1.4.1 Time The installation should take approximately 20 to 60 minutes, depending on your type of media, chosen installation options, and your system configuration. Running the IVP, SYS$TEST:VOX$IVP.COM, on a standalone microVAX-II system requires less than one minute. See Section 2.1.5. ___________________________ 1.4.2 Privileges 1.4.2 Privileges 1.4.2 Privileges To install DECvoice, you must be logged in to an account that has SETPRV or at least the following privileges: o ALTPRI o CMEXEC o CMKRNL o DETACH o SHARE o SYSNAM o SYSPRV Note that VMSINSTAL turns off BYPASS privilege at the start of the installation. ___________________________ 1.4.3 Disk Space 1.4.3 Disk Space 1.4.3 Disk Space Installing DECvoice requires a certain amount of free storage disk space during the installation. Once DECvoice is installed, less storage space is required. Table 1-1 summarizes the storage requirements for DECvoice. 1-6 1-6 1-6 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX _______________________________________________________ Table 1-1 Disk Space Requirements Table 1-1 Disk Space Requirements Table 1-1 Disk Space Requirements Blocks During Blocks After Blocks During Blocks After Blocks During Blocks After _______________________________________________________ Kit Installation Installation Kit Installation Installation Kit Installation Installation _______________________________________________________ DECvoice V1.1 14,431 14,431 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.4.4 System Parameters 1.4.4 System Parameters 1.4.4 System Parameters Table 1-3 describes the various core SYSGEN parameters commonly used by, and commonly modified for, DECvoice. Table 1-3 lists the minimum required system parameter values for the installation. Site-specific increases above the values shown here may be required. Proper sizes are determined on an application and site specific basis. _______________________________________________________ Table 1-2 System Parameter Descriptions Table 1-2 System Parameter Descriptions Table 1-2 System Parameter Descriptions CLISYMTBL Regulates the size of the command interpreter symbol tables. The required setting for this parameter is derived from the requirements of the DECvoice VMSINSTAL command procedures. 1-7 1-7 1-7 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX _______________________________________________________ Table 1-2 (Cont.) System Parameter Descriptions Table 1-2 (Cont.) System Parameter Descriptions Table 1-2 (Cont.) System Parameter Descriptions GBLPAGES Regulates the number of global page table entries-the limit for the number of global pages that can be created. DECvoice uses zero or more 2048 page-one megabyte - global sections to store global messages. GBLSECTIONS This parameter limits the number of global section descriptors that can be created. This is the maximum number of seperate global sections that can be created. DECvoice uses zero or more global sections to store global messages. GBLPAGFIL This parameter is the number of global pages, as limited by GBLPAGES, that can have backing storage in the page file. DECvoice VOX backs shared messages in the page file. DECvoice allocates backing storage in units of 2048 pages. Unlike most other SYSGEN parameters, there is not a direct method of determining the amount of GBLPAGFIL that is currently unused. 1-8 1-8 1-8 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX _______________________________________________________ Table 1-2 (Cont.) System Parameter Descriptions Table 1-2 (Cont.) System Parameter Descriptions Table 1-2 (Cont.) System Parameter Descriptions SPTREQ The SPTREQ parameter is the number of additional System Page Table Entries (SPTs) available for mapping various system components. The DECvoice driver uses SPTs to communicate with the DTC04 module. 128 SPTs are required for EACH DECvoice configured. MAXBUF This parameter controls the maximum size of a buffered I/O transfer. This is the maximum number of bytes that can be transfered in a buffered I/O request. All buffered I/O transfers, performed by any software anywhere on the VMS system, are limited by this parameter. The largest buffered I/O transfer performed by DECvoice is 8192. VIRTUALPAGECNT This is the amount of virtual address space available to a process. This number can be divided between the program region (P0) and the control region (P1) in any fashion. DECvoice uses virtual address space to buffer messages, either local or global, in memory. If you must increase GBLPAGES, you may need to increase VIRTUALPAGECNT. 1-9 1-9 1-9 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX _______________________________________________________ Table 1-2 (Cont.) System Parameter Descriptions Table 1-2 (Cont.) System Parameter Descriptions Table 1-2 (Cont.) System Parameter Descriptions STARTUP_P1 This parameter is used to control the system startup. Various keywords can be placed in this parameter. For the purpose of DECvoice, two keywords are important: a blank string, and the string "MIN". WINDOW_SYSTEM This parameter is used to select the windowing system to be used on a workstation. Zero selects no windowing. This is the default. A one selects the VMS DECwindows environment. A two selects the VMS UIS workstation _______________________________________________________ environment. _______________________________________________________ Table 1-3 Required System Parameter Values Table 1-3 Required System Parameter Values Table 1-3 Required System Parameter Values _______________________________________________________ System Parameter Requirement Value System Parameter Requirement Value System Parameter Requirement Value CLISYMTBL[1] Minimum 250 GBLPAGES[2] Addition current + 3096 GBLSECTIONS[2] Addition current + 24 GBLPAGFIL[2] Addition current + 2048 _______________________________________________________ [1]Minimum value of 250 during the installation procedure. The value can be reset once installation is complete. [2]The current value refers to the system parameter values that are currently in use. To install DECvoice, you must raise these values by the number indicated. 1-10 1-10 1-10 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX _______________________________________________________ Table 1-3 (Cont.) Required System Parameter Values Table 1-3 (Cont.) Required System Parameter Values Table 1-3 (Cont.) Required System Parameter Values _______________________________________________________ System Parameter Requirement Value System Parameter Requirement Value System Parameter Requirement Value SPTREQ[3] Addition current + 128 * modules MAXBUF[4] Minimum 8192 VIRTUALPAGECNT[5] Minimum 8192 STARTUP_P1[6] Requirement " " WINDOW_SYSTEM[7] Maximum 1 _______________________________________________________ [3]The current value refers to the system parameter values that are currently in use. To install DECvoice, you must raise these values by the number indicated for each DECvoice DTC04 module installed in the microVAX system. (See Section 1.4.4.3.) [4]This dynamic system parameter must be set permanently to a value equal to or greater than the value listed. Do not lower this value after the installation. [5]The VIRTUALPAGECNT system parameter may need to be set to a value of 30720 pages or more, depending on the application and the amount of global messages in use. Applications that buffer large amounts of voice data in local or global memory are particularly prone to consuming this resource, and the process account quota PGFLQUOTA. (See Section 3.5.4.) [6]The STARTUP_P1 system parameter is typically left as a blank string during normal system operations. [7]Requirements made by windowing system can interact with the performance of DECvoice. _______________________________________________________ The following sections show you how to check system parameter values, set the CLISYMTBL dynamic system parameter with the VMS System Generation Utility (SYSGEN), calculate values for the GBLPAGES and 1-11 1-11 1-11 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX GBLSECTIONS system parameters, and change parameter values with the VMS AUTOGEN command procedure. _____________________ 1.4.4.1 Checking System Parameter Values 1.4.4.1 Checking System Parameter Values 1.4.4.1 Checking System Parameter Values To check the values of your system parameters, enter the following command at the DCL prompt to invoke the SYSGEN utility: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN> prompt, enter the SHOW command to display the value of each system parameter. The values displayed should equal or exceed the the value of each parameter listed in Table 1-3. The following command displays the value for the MAXBUF system parameter: SYSGEN> SHOW MAXBUF After you finish checking the parameters with the SHOW command, you can enter the EXIT command at the SYSGEN> prompt to return to DCL level. _____________________ 1.4.4.2 Setting the CLISYMTBL Dynamic System 1.4.4.2 Setting the CLISYMTBL Dynamic System 1.4.4.2 Setting the CLISYMTBL Dynamic System Parameter Parameter Parameter If the CLISYMTBL system parameter value for your system is less than 250, change the setting by using the following series of privileged commands: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE ACTIVE SYSGEN> SET CLISYMTBL 250 SYSGEN> WRITE ACTIVE SYSGEN> EXIT Dynamic parameters changed with the SYSGEN utility become active immediately without any need to reboot your system. In fact, rebooting returns dynamic system parameter values to their previous settings, so you should complete the installation before rebooting the system. 1-12 1-12 1-12 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Once the installation is complete, you can reset CLISYMTBL to its previous setting or let it be reset automatically when you reboot your system. _____________________ 1.4.4.3 Calculating GBLPAGES, GBLPAGFIL and 1.4.4.3 Calculating GBLPAGES, GBLPAGFIL and 1.4.4.3 Calculating GBLPAGES, GBLPAGFIL and GBLSECTIONS GBLSECTIONS GBLSECTIONS To install and run DECvoice, you must set the correct values for the GBLPAGES, GBLPAGFIL, GBLSECTIONS and VIRTUALPAGECNT system parameters. The values for GBLPAGES, GBLPAGFILE, GBLSECTIONS and VIRTUALPAGECNT in Table 1-3 indicate that you must have at least the specified number of unused pages or sections available on your system for the installation to process successfully. To determine what the current settings of various parameters are, use the following DCL commands: $ WRITE SYS$OUTPUT 'F$GETSYI("CONTIG_GBLPAGES")' 16384 $ WRITE SYS$OUTPUT 'F$GETSYI("FREE_GBLPAGES")' 16385 $ WRITE SYS$OUTPUT 'F$GETSYI("GBLPAGFIL")' 10240 $ WRITE SYS$OUTPUT 'F$GETSYI("FREE_GBLSECTS")' 64 $ WRITE SYS$OUTPUT 'F$GETSYI("VIRTUALPAGECNT")' 40768 The VMS system may be configured with excess GBLPAGES but may lack sufficient CONTIGUOUS space in the global page tables. If global page table fragmentation occurs, a reboot is required to realize enough contiguous space. Additionally, it may become necessary to increase the value of the GBLPAGES parameter (see Section 1.4.4.4 for the procedures used to increase this paramter), or to perform periodic system reboots, to reduce the incidence of global page table fragmentation. 1-13 1-13 1-13 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX There must be a sufficient number of GBLPAGFIL pages-the DECvoice VOX shared messages uses global pages backed by the pagefile - preconfigured into the system. The amount of GBLPAGFIL pages required varies depending on system configuration. There is no easy way to determine the quantity of GBLPAGFIL pages currently available. The VIRTUALPAGECNT SYSGEN parameter places an upper limit on the amount of virtual address space available to a process. SS$_VASFULL errors are a symptom of an insufficient VIRTUALPAGECNT setting to support current activities. If SS$_VASFULL errors are encountered, you will need to increase the setting of VIRTUALPAGECNT. Section 1.4.4.4 describes the procedures for this. The values for GBLPAGES, GBLPAGFILE and VIRTUALPAGECNT, when an increase is required by a DECvoice application, should all be increased in multiples of 2048 pages. For each 2048 page increment performed on GBLPAGES or GBLPAGFILE, GBLSECTIONS should be incremented by one. If the total number of free global pages, or the number of contiguous free global pages, or the number of GBLPAGFIL, fall below 2048, you may need to reboot to defragment the available memory; if the condition persists, you will need to increase the GBLPAGES, GBLPAGFIL, VIRTUALPAGECNT and GBLSECTIONS parameters and reboot. Section 1.4.4.4 describes the procedures for increasing these values as well as those of other system parameters. Refer to the VMS documentation on system management and operations for more information. Note that DECvoice may require additional increases to GBLPAGES, GBLPAGFIL, GBLSECTIONS and VIRTUALPAGECNT based on the number and size of global messages currently loaded. The DECvoice software will automatically, and dynamically, increase the utilization of GBLPAGES, GBLPAGFIL, GBLSECTIONS and VIRTUALPAGECNT based on the aggregate size of global messages required. Any attempt to expand beyond SYSGEN 1-14 1-14 1-14 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX limits will fail. Each global message memory dynamic expansion requires an additional 2048 pages to each of GBLPAGFIL, GBLPAGES and VIRTUALPAGECNT, and an additional GBLSECTIONS entry. _____________________ 1.4.4.4 Changing System Parameter Values with 1.4.4.4 Changing System Parameter Values with 1.4.4.4 Changing System Parameter Values with AUTOGEN AUTOGEN AUTOGEN You use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the ones you reset manually. To change system parameters with AUTOGEN, you must edit the the following file: SYS$SYSTEM:MODPARAMS.DAT For example, to change the setting for the MAXBUF system parameter, add this line to the file: MIN_MAXBUF = 8192 Or for incremental SYSGEN parameters: ADD_GBLPAGES = 3096 Now, run the AUTOGEN procedure to recalculate your system parameters. Enter the following command at the DCL prompt: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT AUTOGEN performs an automatic system shutdown and reboots when it has finished. Rebooting your system makes the new parameter values active. Also on VMS V5.x systems you may wish to add the [NO]FEEDBACK parameter to the AUTOGEN command line. For more information about using AUTOGEN, see the instructions on modifying system parameters in the VMS documentation on System Management and Operations. 1-15 1-15 1-15 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX DIGITAL recommends that any parameters included in MODPARAMS.DAT use the ADD_, MIN_ or MAX_ prefixes, as appropriate. This allows AUTOGEN to make any necessary, but compatible, changes to the specified parameters. The spellings of all SYSGEN parameters included in the file SYS$SYSTEM:MODPARAMS.DAT must be correct and all parameters must be named in full. Spelling errors typically do not cause AUTOGEN to display any error messages. ___________________________ 1.4.5 VMSINSTAL Requirements 1.4.5 VMSINSTAL Requirements 1.4.5 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 If VMSINSTAL detects any problems during the installation, it notifies you of the problem and asks if you want to continue the installation. In some instances, you can enter YES to continue. To stop the installation process and correct the situation, enter NO or press RETURN. Then correct the problem and restart the installation. ___________________________ 1.4.6 Backing Up Your System Disk 1.4.6 Backing Up Your System Disk 1.4.6 Backing Up Your System Disk At the beginning 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 on top of the operating system. 1-16 1-16 1-16 Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Preparing to Install DECvoice VOX Use the backup procedures that have been established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the VMS documentation set. ___________________________ 1.4.7 License Management Utility Requirements 1.4.7 License Management Utility Requirements 1.4.7 License Management Utility Requirements You will need to register and load your license for DECvoice before you start the installation in order to run the Installation Verification Procedure. For more information on the VMS License Management Facility, see the ___ _______ __________ _______ VMS License Management Utility in the VMS documentation set and the overview ______ Manual in the booklet _ _________ _____ __ ________ ________ A Practical Guide to Managing Software , order number EJ-31899-76. ________ Licenses 1-17 1-17 1-17 _______________________________________________________ 2 Installing DECvoice 2 Installing DECvoice 2 Installing DECvoice This chapter describes how to install DECvoice. Section 2.2 contains a step-by-step description of the installation procedure. __________________________________________________________________ 2.1 General Information 2.1 General Information 2.1 General Information This section includes information about accessing Release Notes, determining the files and logical names added to your system, running the Installation Verification Procedure (IVP), and aborting the installation. ___________________________ 2.1.1 Accessing the Online Release Notes 2.1.1 Accessing the Online Release Notes 2.1.1 Accessing the Online Release Notes DECvoice provides online Release Notes. If you specify OPTIONS N when you invoke VMSINSTAL, the installation procedure asks you if you want to display or print the Release Notes. The Release Notes question comes near the beginning of the installation. You should review the Release Notes in case they contain any information about changes in the installation procedures. After DECvoice has been installed, the Release Notes are located in the file: SYS$HELP:VOX$011.RELEASE_NOTES. To print a copy of the release notes on the default printer, use the command: $PRINT SYS$HELP:VOX$011.RELEASE_NOTES 2-1 2-1 2-1 Installing DECvoice Installing DECvoice Installing DECvoice To display a copy of the release notes on your terminal, use the command: $TYPE/PAGE SYS$HELP:VOX$011.RELEASE_NOTES ___________________________ 2.1.2 VMSINSTAL Directory Creation Messages Can Be Ignored 2.1.2 VMSINSTAL Directory Creation Messages Can Be Ignored 2.1.2 VMSINSTAL Directory Creation Messages Can Be Ignored The DECvoice VMSINSTAL installation procedure displays a number of messages concerning the creation of directories in VAXcluster environments. These messages can safely be ingored; all necessary system-specific directory creations are handled automatically by the DECvoice startup procedure. ___________________________ 2.1.3 New Files Added to the System 2.1.3 New Files Added to the System 2.1.3 New Files Added to the System o SYS$SYSROOT:[SYSLIB]VOX$DEF.BAS o SYS$SYSROOT:[SYSLIB]VOX$DEF.FOR o SYS$SYSROOT:[SYSLIB]VOX$DEF.H o SYS$SYSROOT:[SYSLIB]VOX$DEF.MAR o SYS$SYSROOT:[SYSLIB]VOX$DEF.PAS o SYS$SYSROOT:[SYSLIB]VOX$DEF.PLI o SYS$SYSROOT:[SYSLIB]VOX$DEF.R32 o SYS$SYSROOT:[SYSLIB]VOX$DEF.LIB o SYS$SYSROOT:[SYSLIB]VOX$MSG.BAS o SYS$SYSROOT:[SYSLIB]VOX$MSG.FOR o SYS$SYSROOT:[SYSLIB]VOX$MSG.H o SYS$SYSROOT:[SYSLIB]VOX$MSG.MAR o SYS$SYSROOT:[SYSLIB]VOX$MSG.PAS o SYS$SYSROOT:[SYSLIB]VOX$MSG.PLI o SYS$SYSROOT:[SYSLIB]VOX$MSG.R32 2-2 2-2 2-2 Installing DECvoice Installing DECvoice Installing DECvoice o SYS$SYSROOT:[SYSLIB]VOX$MSG.LIB o SYS$SYSROOT:[SYSTEST]VOX$IVP.COM o SYS$SYSROOT:[SYSTEST.VOX]VOX$IVP.EXE o SYS$SYSROOT:[SYSEXE]VOX$ACP.EXE o SYS$SYSROOT:[SYSEXE]VOX$CP.EXE o SYS$SYSROOT:[SYSLIB]VOX$CPDBGDSHR.EXE o SYS$SYSROOT:[SYSLIB]VOX$CPDBGUSHR.EXE o SYS$SYSROOT:[SYSLIB]VOX$VMSSHR.EXE o SYS$SYSROOT:[SYSLIB]VOX$RTL.EXE o SYS$SYSROOT:[SYSMSG]VOX$MSG.EXE o SYS$SYSROOT:[SYS$LDR]VXDRIVER.EXE o SYS$SYSROOT:[SYSHLP]VOX$CP.HLB o SYS$SYSROOT:[SYSHLP.EXAMPLES.VOX]VOX$DEMO.C o SYS$SYSROOT:[SYSHLP.EXAMPLES.VOX]VOX$MAKE_PROMPT.C o SYS$SYSROOT:[SYSHLP.EXAMPLES.VOX]VOX$MCU.C o SYS$SYSROOT:[VOX$DTC.TEMPLATES]VOX$STD*.DAT o SYS$SYSROOT:[VOX$DTC.MICROCODE]VOX$AUDIO.SYS o SYS$SYSROOT:[VOX$DTC.MICROCODE]VOX$RECOG.SYS o SYS$SYSROOT:[VOX$DTC.MICROCODE]VOX$STORE.SYS o SYS$SYSROOT:[VOX$DTC.MICROCODE]VOX$STORE_ADPCM.SYS o SYS$SYSROOT:[VOX$DTC.MICROCODE]VOX$STORE_SUBBAND.SYS o SYS$SYSROOT:[VOX$DTC.MICROCODE]VOX$SYS.SYS o SYS$SYSROOT:[VOX$DTC.MICROCODE]VOX$TEXT.SYS o SYS$SYSROOT:[VOX$DTC.MICROCODE]VOX$CRECOG.SYS o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$MOUNT.COM o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$DISMOUNT.COM o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$ACNA_DICTIONARY.DAT 2-3 2-3 2-3 Installing DECvoice Installing DECvoice Installing DECvoice o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$DELETE_GLOBAL.EXE o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$DIAG.EXE o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$DIAG_DIAL.EXE o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$DIAG_TEST.EXE o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$DIAL.EXE o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$TEST.EXE o SYS$SYSROOT:[VOX$DTC.SYSTEM]VOX$DB86.EXE o SYS$SYSROOT:[VOX$DTC.VOICE]VOX$K_*.DAT ___________________________ 2.1.4 Logical Names Added to the System 2.1.4 Logical Names Added to the System 2.1.4 Logical Names Added to the System DECvoice also creates a small number of logical names. All logical names created by DECvoice software are prefixed by "VOX$". o VOX$EXAMPLES o VOX$MICROCODE o VOX$SYSTEM o VOX$TEMPLATES o VOX$VOICE Several other logical names, and logical name tables, are created for internal DECvoice use. Modifications or changes to these logical names and tables are not supported and may cause software failures. ___________________________ 2.1.5 Running the Installation Verification Procedure (IVP) 2.1.5 Running the Installation Verification Procedure (IVP) 2.1.5 Running the Installation Verification Procedure (IVP) The Installation Verification Procedure (IVP) for DECvoice verifies the installation. During the installation, you are asked if you want to run the IVP as part of the installation. If you respond YES, VMSINSTAL runs the IVP. It is recommended that you 2-4 2-4 2-4 Installing DECvoice Installing DECvoice Installing DECvoice run the IVP to be sure that DECvoice is installed correctly. After DECvoice is installed, you can run the IVP independently to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access DECvoice. To run the IVP type the command: $ @SYS$TEST:VOX$IVP The DECvoice IVP is intended as a test of the DECvoice software. It is not intended as a test of the DECvoice DTC04 hardware and only performs a few operations with the module while testing the software. The IVP will complete successfully if the DECvoice software is functioning. If hardware is not present, or is malfunctioning, the IVP will function. The IVP will, in addition to the software testing, search for all DECvoices installed in the system. The system software status will be checked for each module; thus the IVP can potentially detect, and report, problems with a DECvoice vector switch setting. Note: Note: Note: An incorrectly configured DECvoice hardware interrupt An incorrectly configured DECvoice hardware interrupt An incorrectly configured DECvoice hardware interrupt vector switch setting is the most common source of vector switch setting is the most common source of vector switch setting is the most common source of DECvoice problems. DECvoice problems. DECvoice problems. The SYSGEN utility does display the DECvoice DTC04 The SYSGEN utility does display the DECvoice DTC04 The SYSGEN utility does display the DECvoice DTC04 ___ not not not interrupt vector setting. interrupt vector setting. interrupt vector setting. The only way to determine the current vector setting The only way to determine the current vector setting The only way to determine the current vector setting is to physically remove the DTC04 module from the is to physically remove the DTC04 module from the is to physically remove the DTC04 module from the Q-bus and decode the physical interrupt vector switch Q-bus and decode the physical interrupt vector switch Q-bus and decode the physical interrupt vector switch setting on the interrupt vector switch pack. The setting on the interrupt vector switch pack. The setting on the interrupt vector switch pack. The setting should then be compared to the proper setting, setting should then be compared to the proper setting, setting should then be compared to the proper setting, as displayed by SYSGEN. The switch setting must the as displayed by SYSGEN. The switch setting must the as displayed by SYSGEN. The switch setting must the same as, or must be reset to, the value of the vector same as, or must be reset to, the value of the vector same as, or must be reset to, the value of the vector that is displayed by SYSGEN. Consult the that is displayed by SYSGEN. Consult the that is displayed by SYSGEN. Consult the ________ DECvoice DECvoice DECvoice 2-5 2-5 2-5 Installing DECvoice Installing DECvoice Installing DECvoice for information on switch for information on switch for information on switch _____ _________ ______ DTC04 Technical Manual DTC04 Technical Manual DTC04 Technical Manual location, configuration and settings. Contact DIGITAL location, configuration and settings. Contact DIGITAL location, configuration and settings. Contact DIGITAL Field Service for assistance. Field Service for assistance. Field Service for assistance. ___________________________ 2.1.6 Aborting the Installation 2.1.6 Aborting the Installation 2.1.6 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.2 The Installation Procedure 2.2 The Installation Procedure 2.2 The Installation Procedure The DECvoice installation process consists of a series of questions and informational messages. ___________________________ 2.2.1 Invoking VMSINSTAL 2.2.1 Invoking VMSINSTAL 2.2.1 Invoking VMSINSTAL To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. Next, invoke VMSINSTAL. You use the following syntax to invoke VMSINSTAL: @SYS$UPDATE:VMSINSTAL product-name device-name OPTIONS N product-name product-name product-name The installation name for the component. For DECvoice, use the following installation name: VOX011 device-name device-name device-name The name of the device on which you plan to mount the media. For example, XDELTA$MUA0: is the device name for a TK70 cassette tape drive. It is not necessary to use the console drive for this installation. However, if you do use the console drive, you should 2-6 2-6 2-6 Installing DECvoice Installing DECvoice Installing DECvoice replace any media you removed once the installation is completed. OPTIONS N OPTIONS N OPTIONS N An optional parameter that indicates you want to be prompted to display or print the Release Notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not prompt you to display or print the Release Notes. You are strongly recommended to read the Release Notes before proceeding with this installation. VMSINSTAL has several other options; for information, see the VMS documentation on Software Installation. The following example displays the command to invoke VMSINSTAL to install DECvoice from TK70 cassette tape drive XDELTA$MUA0: and the system response. This example uses the OPTIONS N parameter for printing or displaying Release Notes. $ @SYS$UPDATE:VMSINSTAL VOX011 XDELTA$MUA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.2 It is 01-SEP-1989 at 5:09. Enter a question mark (?) at any time for help. If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later on in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the Release Notes during the installation. 2-7 2-7 2-7 Installing DECvoice Installing DECvoice Installing DECvoice ___________________________ 2.2.2 Installation Questions 2.2.2 Installation Questions 2.2.2 Installation Questions This section discusses the questions that appear during the installation. See Appendix A for a sample installation procedure. Each question in the installation is marked with an asterisk (*) at the beginning of the line. Some questions show the default response in brackets, for example [YES]. If you want to give the default response, press the RETURN key. 1 1 1 Process status VMSINSTAL displays a list of all active processes. It then asks if you want to continue the installation. You should install DECvoice on a standalone system or cluster. NO is the default response to the question. %VMSINSTAL-W-ACTIVE, The following processes are still active: HOFFMAN$WM_1 HOFFMAN_001C SIMM_001F BATCH_0023 . . * Do you want to continue anyway [NO]? 2 2 2 System backup VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press RETURN. Otherwise, enter 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-8 2-8 2-8 Installing DECvoice Installing DECvoice Installing DECvoice 3 3 3 Mounting the media You should now mount the first distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL then asks you if you are ready to continue with the installation. If you respond YES to indicate that you are ready, VMSINSTAL displays a message that the media containing DECvoice has been mounted on the specified device and that the installation has begun. For example: Please mount the first volume of the set on XDELTA$MUA0:. * Are you ready? YES %MOUNT-I-MOUNTED, VOX MOUNTED ON XDELTA$MUA0: The following products will be processed: VOX V1.1 Beginning installation of VOX V1.1 at 5:09 %VMSINSTAL-I-RESTORE, Restoring product saveset A... If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. To abort the installation for other reasons, press CTRL/Y. 4 4 4 Additional media volumes If your installation kit contains more than one volume, VMSINSTAL prompts you to insert the additional volumes and then asks you to indicate that you are ready for the installation to proceed. %BACKUP-I-READYREAD, mount volume 2 on _XDELTA$MUA0: for reading Enter "YES" when ready: 2-9 2-9 2-9 Installing DECvoice Installing DECvoice Installing DECvoice 5 5 5 Release Notes If you specified OPTIONS N when you invoked VMSINSTAL, you are now given three options for reviewing the Release Notes. Release Notes Options: 1. Display Release Notes 2. Print Release Notes 3. Both 1 and 2 4. None of the Above * Select option [3]: If you select option 1, VMSINSTAL displays the Release Notes immediately on the console terminal. You can terminate the display at any time by pressing CTRL/C. Display of the release notes to the screen is probably not desirable; the file is large. Specification of option 2 is recommended. If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: You can enter a queue name or press RETURN to send the file to the default output print device. The DECvoice release notes file is a large file, thus the selection of option 2 is recommended. If you select option 3, VMSINSTAL displays the Release Notes immediately on the console terminal and then prompts you for a queue name for the printed version. Display of the release notes to the screen is probably not desirable; the file is large. Specification of option 2 is recommended. 6 6 6 Continuing the installation The installation procedure now asks if you want to continue the installation. To continue, enter YES. Otherwise, press RETURN. In either case, the 2-10 2-10 2-10 Installing DECvoice Installing DECvoice Installing DECvoice 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 products Release Notes have been successfully moved to SYS$HELP. The Release Notes are located in the following file:. SYS$HELP:VOX$011.RELEASE_NOTES. Note: The name of the Release Notes file installed Note: The name of the Release Notes file installed Note: The name of the Release Notes file installed by VMSINSTAL consists of the current product name by VMSINSTAL consists of the current product name by VMSINSTAL consists of the current product name and version number. Do not delete Release Notes for and version number. Do not delete Release Notes for and version number. Do not delete Release Notes for previous versions of DECvoice. previous versions of DECvoice. previous versions of DECvoice. 7 7 7 Choosing to purge files You have the option to purge files from previous versions of DECvoice that are superseded by this installation. Purging is recommended; however, if you need to keep files from the previous version, enter NO in response to the question. * Do you want to purge files replaced by this installation [YES]? 8 8 8 License Registration The installation procedure asks you if have registered and loaded your authorization key for DECvoice and prints out information specific to the particular license, for example: Product: VOX Producer: DEC Version: 1.1 Release Date: 1-SEP-1989 The installation also inquires: * Does this product have an authorization key registered and loaded? 2-11 2-11 2-11 Installing DECvoice Installing DECvoice Installing DECvoice If you have not registered and loaded your authorization key, you must answer "NO" to this question. A successful installation of DECvoice depends upon an authorization key being registered and loaded. Please be certain that this has been completed before proceeding with the installation. 9 9 9 Prerecorded Voice Snippet Files The voice files are a group of files that contain prerecorded English snippets. These files are used for the concatenation of numbers in prototype applications and are not necessary for the operation of the DECvoice software. The voice files comprise of 304 files that occupy 3917 blocks of disk space on a disk volume with a disk volume clustersize of three blocks. * Do you wish to install the voice files [YES]? If you do not plan to use these prerecorded voice files, or you have your own files, or if your system has little free space, answer this question NO. 10 10 10 Choosing to run the Installation Verification Procedure (IVP) The installation procedure now asks if you want to run the Installation Verification Procedure. The IVP for DECvoice checks to be sure that the installation is successful. It is recommended that you run the IVP. * Do you want to run the IVP after the installation [YES]? 2-12 2-12 2-12 Installing DECvoice Installing DECvoice Installing DECvoice ___________________________ 2.2.3 Informational Messages 2.2.3 Informational Messages 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. If you asked for files to be purged, that work is done now. The following messages are displayed: %VOX-I-GOAWAY, no more questions will be asked. %VMSINSTAL-I-RESTORE, Restoring product saveset B ... %VMSINSTAL-I-RESTORE, Restoring product saveset C ... The installation will now execute a number of CREATE /DIRECTORY commands. Informational messages resulting from these creations, and all messages requesting creation of directories under SYS$SPECIFIC by the user can be ignored. The DECvoice startup command procedure will automatically create the requisite system-specific directories in standalone and VAXcluster environments. %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... ___________________________ 2.2.4 Running the Installation Verification Procedure 2.2.4 Running the Installation Verification Procedure 2.2.4 Running the Installation Verification Procedure If you chose to run the IVP, VMSINSTAL will attempt to run the IVP now. If the current running VMS system is not properly configured, the IVP will not be run. The two most common problems with a failed IVP are an incorrect SYSGEN parameter, or a DECvoice device with an incorrectly set hardware vector. See Section 2.1.5 for information on running the IVP manually. See Section 2.3 for information about errors that may be displayed by the IVP. 2-13 2-13 2-13 Installing DECvoice Installing DECvoice Installing DECvoice ___________________________ 2.2.5 Completing the Installation Procedure 2.2.5 Completing the Installation Procedure 2.2.5 Completing the Installation Procedure The following messages indicate that the entire installation procedure is complete: Installation of VOX V1.1 completed at 5:30 VMSINSTAL procedure done at 5:30 You can now log out of the privileged account: $ LOGOUT SYSTEM logged out at 30-AUG-1989 05:30:44.31 Note that VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again. __________________________________________________________________ 2.3 Error Recovery 2.3 Error Recovery 2.3 Error Recovery If errors occur during the installation itself 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 VOX V1.1 has failed. If the IVP fails, the following messages are displayed: The VOX V1.1 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for VOX V1.1 has failed. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. V1.1 requires VMS V5.2 or above. o A DECvoice ACP is currently operating on the system. 2-14 2-14 2-14 Installing DECvoice Installing DECvoice Installing DECvoice o A DECvoice device is marked as mounted. o Quotas necessary for successful installation are insufficient. o System parameter values for successful installation are insufficient. o The DECvoice hardware device vector is incorrectly set. For descriptions of the error messages generated by these conditions, see Appendix B in this document, the VMS documentation on system messages and recovery procedures, and the documentation on the VMS software installation procedures. DECvoice VOX V1.1 includes three new messages broadcast to the console by the VXDRIVER device driver. These messages are: o %VXDRIVER, Unit init running on DECvoice: VXcu: This message indicates normal device initialization and does not indicate a problem. o %VXDRIVER, DECvoice timeout- check vector on: VXcu: This indicates a hardware failure or, far more likely, an setting in the hardware vector switch pack. See the ________ _____ _________ ______ DECvoice DTC04 Technical Manual for DECvoice module configuration information and switch setting requirements. Contact your local DIGITAL Field Service office for assistance. o %VXDRIVER, shared memory access failure on DECvoice: VXcu: This is typically a hardware problem. It indicates that the driver cannot access the DECvoice Q-bus shared memory. This condition can be caused by insufficient system page table entries. See Section 1.4.4 for information on increasing the SYSGEN parameter SPTREQ. 2-15 2-15 2-15 Installing DECvoice Installing DECvoice Installing DECvoice If you are notified that an error condition exists, you should 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. For information on problem reporting, see Section 3.7. 2-16 2-16 2-16 _______________________________________________________ 3 After Installing DECvoice 3 After Installing DECvoice 3 After Installing DECvoice After installing DECvoice, you need to perform the following tasks: o Edit the system startup and shutdown files. o Reboot the system. o Modify system parameters settings This chapter also explains how to run the Installation Verification Procedure (IVP) after the software has been installed, and provides information on other, more general, manuals that you may find useful. __________________________________________________________________ 3.1 Editing the System Files 3.1 Editing the System Files 3.1 Editing the System Files You must edit the system startup files to provide for automatic startup of DECvoice when your system is rebooted. Add the command line that starts DECvoice to the site-specific system startup file, SYS$MANAGER:SYSTARTUP_V5.COM. The following example shows the command used DECvoice: $ @SYS$STARTUP:VOX$STARTUP.COM The site-specific system startup is executed from a privileged environment. The DECvoice startup requires the following privileges to execute: o ALTPRI o CMKRNL o CMEXEC 3-1 3-1 3-1 After Installing DECvoice After Installing DECvoice After Installing DECvoice o DETACH o SHARE o SYSNAM o SYSPRV Additional privileges, such as PRMGBL and SYSGBL, may be required by startup, and by user applications, depending on the requirements for DECvoice shared message global sections. All DECvoice user-written applications require a minimum of, and typically only, TMPMBX. __________________________________________________________________ 3.2 Rebooting the System 3.2 Rebooting the System 3.2 Rebooting the System You can reboot your system after you have installed the DECvoice DTC04, the DECvoice software, have edited the system startup file to incorporate the DECvoice startup, and have reset the system parameters (if necessary). A system reboot verifies that DECvoice is ready for use, and ensures that the edits to the system startup command file are correct. It also establishes any new parameter settings as the current settings. Note, however, that rebooting is optional except when a non-dynamic SYSGEN parameter must be altered. __________________________________________________________________ 3.3 Deleting VOX Version V1.0 Files 3.3 Deleting VOX Version V1.0 Files 3.3 Deleting VOX Version V1.0 Files Note: DIGITAL strongly recommends that you have Note: DIGITAL strongly recommends that you have Note: DIGITAL strongly recommends that you have a satisfactory backup of your system disk before a satisfactory backup of your system disk before a satisfactory backup of your system disk before executing any of the commands listed in this executing any of the commands listed in this executing any of the commands listed in this section. DIGITAL also recommends all running DECvoice section. DIGITAL also recommends all running DECvoice section. DIGITAL also recommends all running DECvoice applications be shut down, and all DECvoice ACPs applications be shut down, and all DECvoice ACPs applications be shut down, and all DECvoice ACPs dismounted, prior to executing these commands. dismounted, prior to executing these commands. dismounted, prior to executing these commands. 3-2 3-2 3-2 After Installing DECvoice After Installing DECvoice After Installing DECvoice If DECvoice VOX V1.0 was previously installed on the system, you can delete it before or after the installation of VOX V1.1 or above, using the SYSTEM account, with the following commands: $ SET PROCESS/PRIVILEGE=SYSPRV $ SET PROTECTION=(SYSTEM:RWED) - SYS$SYSDEVICE:[VOX$DTC...]*.*;* $ DELETE SYS$SYSDEVICE:[VOX$DTC...]*.*;* $ DELETE SYS$SYSDEVICE:[VOX$DTC...]*.*;* $ DELETE SYS$SYSDEVICE:[VOX$DTC...]*.*;* $ SET PROTECTION=(SYSTEM:RWED) - SYS$SYSDEVICE:[000000]VOX$DTC.DIR;* $ DELETE SYS$SYSDEVICE:[000000]VOX$DTC.DIR;* These commands delete all VOX V1.0 files from all VAXcluster nodes that are sharing this system disk. In VAXclusters with multiple system disks, you must install VOX V1.1 on each different system disk and you must perform this deletion on each disk that has V1.0 installed on it. __________________________________________________________________ 3.4 VAXcluster Considerations 3.4 VAXcluster Considerations 3.4 VAXcluster Considerations DECvoice VOX software installs in subdirectories of the VAXcluster common root, SYS$COMMON:. Various subdirectories under SYS$COMMON:[VOX$DTC] are created by the installation. The DECvoice system startup procedure creates all necessary system-specific DECvoice directories if they are not found. These subdirectories are under SYS$SPECIFIC:[VOX$DTC]. You must make the specified SYSGEN adjustments and edit SYS$MANAGER:SYSTARTUP_V5.COM on all nodes in the VAXcluster that will be using DECvoice. All nodes in the VAXcluster that will be using DECvoice, or simply running the DECvoice startup, must be licensed for DECvoice. (See Section 1.3.) 3-3 3-3 3-3 After Installing DECvoice After Installing DECvoice After Installing DECvoice In VAXclusters with multiple system disks, you must perform a complete VOX V1.1 installation on each system with a distinct system disk. __________________________________________________________________ 3.5 Enhancing DECvoice System Performance 3.5 Enhancing DECvoice System Performance 3.5 Enhancing DECvoice System Performance This section includes information on general system tuning. It also includes information on installing the DECvoice RTL as a sharable image, sample account quotas for various applications and information on disk fragmentation. ___________________________ 3.5.1 VMS Guide To Performance Management 3.5.1 VMS Guide To Performance Management 3.5.1 VMS Guide To Performance Management After you install DECvoice, you might want to adjust, or tune, your system to enhance performance or lower the use of certain system resources. Information about tuning your VMS system is included in the ___ _____ __ VMS Guide To manual. ___________ __________ Performance Management ___________________________ 3.5.2 Installing DECvoice as a Shared Image 3.5.2 Installing DECvoice as a Shared Image 3.5.2 Installing DECvoice as a Shared Image If the DECvoice Run-Time Library will be used extensively on your system, you can reduce the system overhead and memory requirements by installing it as a shared image. To install DECvoice as a shared image on a system that is currently running, use the VMS Install Utility (INSTALL). It is recommended that you perform the installation on a system that has just been bootstrapped because the available space in the global page table is less likely to be fragmented. First, determine the number of available global pages and global sections on your system. See Section 1.4.4.3 for information on how to verify and modify the number of global pages and global sections. Table 1-3 contains the required values for these parameters. 3-4 3-4 3-4 After Installing DECvoice After Installing DECvoice After Installing DECvoice Once you have reset the system parameter values, invoke the VMS Install Utility from a privileged account and then install DECvoice as a shared image: $ INSTALL INSTALL> CREATE SYS$SHARE:VOX$RTL.EXE /OPEN /SHARED /HEADER INSTALL> EXIT You must now add the following lines to the appropriate system startup command file, SYS$MANAGER:SYSTARTUP_V5.COM, so that each time the system is started, DECvoice is available as a shared image. $ INSTALL CREATE SYS$SHARE:VOX$RTL.EXE /OPEN /SHARED /HEADER Note that when you install DECvoice as a shared image you need to increase the global pages and global sections parameters. Increase global pages (GBLPAGES) by 674 pages and global sections (GBLSECTIONS) by 3 sections. Refer to Section 1.4.4 for information on changing these parameters. ___________________________ 3.5.3 Example Process Account Quotas 3.5.3 Example Process Account Quotas 3.5.3 Example Process Account Quotas DECvoice digitized-voice applications typically require large amounts of memory for voice data buffers. An application can calculate an approximation of the amount of virtual memory required by multiplying the encoding rate times the number of seconds of data to be held in memory. If this amount is large, and the process working set or the amount of non-paged pool, is small, performance degradation can result. Table 3-1 provides general guidelines for process quotas for common applications. The information in Table 3-1 should be taken as a starting point for tuning a typical application and adjusted as required. 3-5 3-5 3-5 After Installing DECvoice After Installing DECvoice After Installing DECvoice Table 3-1 Process Account Quotas for Common Table 3-1 Process Account Quotas for Common Table 3-1 Process Account Quotas for Common _______________________________________________________ Applications Applications Applications _______________________________________________________ Account Quota Value Account Quota Value Account Quota Value ASTLM 512 BIOLM 512 BYTLM[1] 20480 PGFLQUOTA[2] 20480 WSDEFAULT[3] 512 WSQUOTA[3] 2048 WSEXTENT[3] 4096 _______________________________________________________ [1]Insufficient BYTLM quota has caused certain applications to spend noticable amounts of time in a mutex wait state. BYTLM is allocated from the VMS system non-paged memory pool. The amount of non-paged pool is set by the SYSGEN parameter NPAGEDYN. Use the DCL command "SHOW MEMORY/POOL" to show the current, and initial settings of non-paged pool. Insufficient non-paged pool can result in system-wide performance degradation-particularly on systems with a small amount of free physical memory. [2]The address space available to a process is limited by both this parameter and by the SYSGEN parameter VIRTUALPAGECNT. [3]The values for WSEXTENT and WSQUOTA must be equal to or greater than the WSDEFAULT value. Additionally, the largest working set possible is governed by the setting of the SYSGEN parameter WSMAX. _______________________________________________________ 3-6 3-6 3-6 After Installing DECvoice After Installing DECvoice After Installing DECvoice ___________________________ 3.5.4 Process Account Quotas for Large Applications 3.5.4 Process Account Quotas for Large Applications 3.5.4 Process Account Quotas for Large Applications Large applications may require increases to the user authorization quotas. The following table shows some general guidelines for process accounts used for very large applications. Deficiencies in these quotas can result in application performance degredation in large applications. Table 3-2 provides general guidelines for process quotas for large applications. The information in Table 3-2 should be taken as a starting point for tuning a large application and adjusted as required. Table 3-2 Process Account Quotas for Large Table 3-2 Process Account Quotas for Large Table 3-2 Process Account Quotas for Large _______________________________________________________ Applications Applications Applications _______________________________________________________ Account Quota Value Account Quota Value Account Quota Value ASTLM 1024 BIOLM 1024 BYTLM[1] 524288 DIOLM 48 ENQLM 750 _______________________________________________________ [1]Insufficient BYTLM quota has caused some large applications to spend noticable amounts of time in a mutex wait state. BYTLM is allocated from the VMS system non-paged memory pool. The amount of non-paged pool is set by the SYSGEN parameter NPAGEDYN. Use the DCL command "SHOW MEMORY/POOL" to show the current, and initial settings of non-paged pool. Insufficient non-paged pool can result in system-wide performance degradation-particularly on systems with a small amount of free memory. 3-7 3-7 3-7 After Installing DECvoice After Installing DECvoice After Installing DECvoice Table 3-2 (Cont.) Process Account Quotas for Large Table 3-2 (Cont.) Process Account Quotas for Large Table 3-2 (Cont.) Process Account Quotas for Large _______________________________________________________ Applications Applications Applications _______________________________________________________ Account Quota Value Account Quota Value Account Quota Value FILLM 100 PRCLM 10 JTQUOTA 8192 PGFLQUOTA[2] 40960 WSDEFAULT 1024[3] WSQUOTA 2048[3] WSEXTENT 4096[3] _______________________________________________________ [2]The address space available to a process is limited by both this parameter and by the SYSGEN parameter VIRTUALPAGECNT. [3]The values for WSEXTENT and WSQUOTA must be equal to or greater than the WSDEFAULT value. Additionally, the largest working set possible is governed by the setting of the SYSGEN parameter WSMAX. _______________________________________________________ User account quotas are stored in the file SYSUAF.DAT. You use the VMS Authorize Utility to verify and change user account quotas. First set your default directory to SYS$SYSTEM and then run AUTHORIZE: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> At the AUTHORIZE prompt (UAF>), use the SHOW command with an account name to check a particular account. For example: UAF> SHOW HOFFMAN 3-8 3-8 3-8 After Installing DECvoice After Installing DECvoice After Installing DECvoice To change a quota, use the MODIFY command at the UAF> prompt. MODIFY has the following format: MODIFY account-name /quota-name=nnnn This example changes the FILLM quota for the SMITH account and then exits from the Authorize Utility: UAF> MODIFY HOFFMAN /FILLM=50 UAF> EXIT After you exit from the utility, the VMS system displays messages indicating whether or not changes were made. Once the changes have been made, you must log out and log in again for the new quotas to take effect. For more information on modifying account quotas, see the description of the AUTHORIZE utility in the VMS documentation on System Management and Operations. ___________________________ 3.5.5 Insufficient Pagefile 3.5.5 Insufficient Pagefile 3.5.5 Insufficient Pagefile DECvoice applications can consume quantities of pagefile. To display the current amount of pagefile that is available and reservable, use the command: $ SHOW MEMORY/FILES A severly overcommitted pagefile can result in degraded DECvoice application performance. To alter the size of the pagefile, execute the following command from the SYSTEM account: $ @SYS$UPDATE:SWAPFILES.COM 3-9 3-9 3-9 After Installing DECvoice After Installing DECvoice After Installing DECvoice ___________________________ 3.5.6 Disk Fragmentation 3.5.6 Disk Fragmentation 3.5.6 Disk Fragmentation Performance of the DECvoice software and the VMS system can be reduced by excess disk fragmentation. Note that some disk fragmentation is normal and should be expected. Consult the VMS documentation set for information on system disk disk defragmentation procedures and for information on the use of the standalone VMS BACKUP utility. __________________________________________________________________ 3.6 General VMS Programming References 3.6 General VMS Programming References 3.6 General VMS Programming References The , order _____ __ ________ ___ _______ __________ Guide to Creating VMS Modular Procedures number AA-LA58A-TE, included in the VMS documentation set and the ____________ __ __________ ___________ Introduction to VAXcluster Application , order number AA-JP32B-TE, are good general ______ Design starting points for information on writing modular applications in either standalone or distributed and VAXcluster environments. The , ________ _____ ________ _________ ______ DECvoice DTC04 Software Reference Manual mentioned in Chapter 1, contains the information necessary to program the DECvoice VOX Run-Time Library. __________________________________________________________________ 3.7 Determining and Reporting Problems 3.7 Determining and Reporting Problems 3.7 Determining and Reporting Problems If an error occurs while DECvoice is being used and you believe that the error is caused by a problem with DECvoice, take one of the following actions: o Confirm that the DECvoice hardware CSR and vector switches are set up correctly. This check can only be performed by removing the DECvoice DTC04 module from the backplane and examining the physical CSR and vector switch settings. These settings must be identical to the desired CSR and vector settings displayed by the SYSGEN utility. See the for DECvoice ________ _____ _________ ______ DECvoice DTC04 Technical Manual 3-10 3-10 3-10 After Installing DECvoice After Installing DECvoice After Installing DECvoice module configuration information and switch setting requirements. Contact your local DIGITAL Field Service office for assistance. o If you have a BASIC or DECsupport Software Agreement, you should call your Customer Support Center. (With these services, you receive telephone support that provides high-level advisory and remedial assistance.) o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). o If you purchased DECvoice within the past 90 days and you think the problem is caused by a software error, you can submit a Software Performance Report (SPR). If you find an error in the DECvoice documentation, you should fill out and submit the Reader's Comments form at the back of the document in which the error was found. Please include the section and page number where the error was found. 3-11 3-11 3-11 _______________________________________________________ A Sample Installation A Sample Installation A Sample Installation This appendix contains a sample installation of DECvoice. This sample was run on a system that had no previous version of DECvoice installed. The sample installation assumes that DECnet has been shut down, that no users are logged on to your system, and that OPTIONS N is specified to print the Release Notes. The Installation Verification Procedure (IVP) runs at the end of the installation. See Section 2.1.5 for information on running the IVP manually. Note: This example installation displays an error Note: This example installation displays an error Note: This example installation displays an error during the IVP. The IVP encountered non-fatal hardware during the IVP. The IVP encountered non-fatal hardware during the IVP. The IVP encountered non-fatal hardware error accessing the DECvoice TLI. In this case the error accessing the DECvoice TLI. In this case the error accessing the DECvoice TLI. In this case the TLI was deliberately electrically disconnected, for TLI was deliberately electrically disconnected, for TLI was deliberately electrically disconnected, for the purpose of testing, from the DTC04 module in the the purpose of testing, from the DTC04 module in the the purpose of testing, from the DTC04 module in the VAXstation 3200 Q-bus. Typical runs of the IVP will VAXstation 3200 Q-bus. Typical runs of the IVP will VAXstation 3200 Q-bus. Typical runs of the IVP will not report this error. not report this error. not report this error. XDELTA::, Voice Products VAXstation 3200, VMS V5.2 Username: SYSTEM Password: XDELTA::, Voice Products VAXstation 3200, VMS V5.2 Digital Equipment Corporation Voice Products Group Last interactive login on Wednesday, 30-AUG-1989 13:58 Last non-interactive login on Tuesday, 29-AUG-1989 09:32 $ @sys$update:vmsinstal VOX011 XDELTA$MUA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.2 A-1 A-1 A-1 Sample Installation Sample Installation Sample Installation It is 30-AUG-1989 at 05:09. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? YES The following products will be processed: VOX V1.1 Beginning installation of VOX V1.1 at 05:09 %VMSINSTAL-I-RESTORE, Restoring product saveset A ... 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]: 4 * Do you want to continue the installation [NO]? YES %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. *************************************************************** * * * DECvoice DTC04-AA * * VOX V1.1 * * * * Installation Procedure * * * * Copyright. 1988, 1989. Digital Equipment Corporation * * All Rights Reserved. * * * *************************************************************** * Do you want to purge files replaced by this installation [YES]? YES Product: VOX Producer: DEC Version: 1.1 Release Date: 1-SEP-1989 A-2 A-2 A-2 Sample Installation Sample Installation Sample Installation * Does this product have an authorization key registered and loaded? YES * Do you wish to install the voice files [YES]? YES * Do you want to run the IVP after the installation [YES]? YES %VOX-I-GOAWAY, No more questions will be asked. %VMSINSTAL-I-RESTORE, Restoring product saveset B ... %VMSINSTAL-I-RESTORE, Restoring product saveset C ... %VMSINSTAL-I-SYSDIR, This product creates system directory [VOX$DTC.MICROCODE]. If you intend to execute this layered product on other nodes in your VAXcluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[VOX$DTC.MICROCODE] /OWNER_UIC=[1,4]/PROTECTION=(S:RWE,O:RWE,G:RWE,W:RE)/VERSION_LIMIT=3 %VMSINSTAL-I-SYSDIR, This product creates system directory [VOX$DTC.SYSTEM]. If you intend to execute this layered product on other nodes in your VAXcluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[VOX$DTC.SYSTEM] /OWNER_UIC=[1,4]/PROTECTION=(S:RWE,O:RWE,G:RWE,W:RE)/VERSION_LIMIT=3 %VMSINSTAL-I-SYSDIR, This product creates system directory [VOX$DTC.TEMPLATES]. If you intend to execute this layered product on other nodes in your VAXcluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[VOX$DTC.TEMPLATES] /OWNER_UIC=[1,4]/PROTECTION=(S:RWE,O:RWE,G:RWE,W:RE)/VERSION_LIMIT=3 %VMSINSTAL-I-SYSDIR, This product creates system directory [VOX$DTC.VOICE]. A-3 A-3 A-3 Sample Installation Sample Installation Sample Installation If you intend to execute this layered product on other nodes in your VAXcluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[VOX$DTC.VOICE] /OWNER_UIC=[1,4]/PROTECTION=(S:RWE,O:RWE,G:RWE,W:RE)/VERSION_LIMIT=3 %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSHLP.EXAMPLES.VOX]. If you intend to execute this layered product on other nodes in your VAXcluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.VOX] /OWNER_UIC=[1,4]/PROTECTION=(S:RWE,O:RWE,G:RWE,W:RE)/VERSION_LIMIT=3 %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSTEST.VOX]. If you intend to execute this layered product on other nodes in your VAXcluster, and you have the appropriate software license, you must prepare the system-specific roots on the other nodes by issuing the following command on each node (using a suitably privileged account): $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSTEST.VOX]/OWNER_UIC=[1,4] /PROTECTION=(S:RWE,O:RWE,G:RWE,W:RE)/VERSION_LIMIT=3 Upon completion of this installation, please be sure to perform the following steps: o P L E A S E R E A D T H E R E L E A S E N O T E S Digital places important release notes and related information in file SYS$HELP:VOX$011.RELEASE_NOTES. o Edit the system startup files to include the command "@Sys$Startup:VOX$Startup.Com". o Edit the file SYS$SYSTEM:MODPARAMS.DAT to change the SYSGEN parameters listed in the DTC04 Software Reference Manual and in the release notes. If these parameters are not currently set correctly the IVP will not be run. A-4 A-4 A-4 Sample Installation Sample Installation Sample Installation %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... %VOX-I-STARTUP, the DECvoice "VOX" software startup is executing. Copr. (c) Digital Equipment Corp. 1988, 1989. All Rights Reserved. **** VOX V1.1-002 Installation Verification Procedure Starting **** This IVP is intended solely as a test of the DECvoice software installed on this system. It is not a hardware diagnostic and performs no useful testing of the DECvoice hardware. Consult the DECvoice DTC04 System Technical Manual for diagnostic information. Using SYS$DEVICE_SCAN to look for all DECvoices. _VXA0: is mounted. SYS$DEVICE_SCAN located 1 DECvoice. Using DECvoice: _VXA0: Limited testing using the hardware will be performed. VOX$_BADTLI: Check the DECvoice hardware configuration. The DECvoice TLI appears to be bad or is disconnected. **** VOX V1.1-002 Installation Verification Procedure Successful **** Installation of VOX V1.1 completed at 5:30 VMSINSTAL procedure done at 5:30 $ LO SYSTEM logged out at 30-AUG-1989 5:30:44.02 A-5 A-5 A-5 _______________________________________________________ B Troubleshooting Information B Troubleshooting Information B Troubleshooting Information Table B-1 describes various problems that may be encountered with a DECvoice, describes potential causes of the problem, and gives corrective actions for each. Note: Note: Note: An incorrectly configured DECvoice hardware interrupt An incorrectly configured DECvoice hardware interrupt An incorrectly configured DECvoice hardware interrupt vector switch setting is the most common source of vector switch setting is the most common source of vector switch setting is the most common source of DECvoice problems. DECvoice problems. DECvoice problems. The SYSGEN utility does display the DECvoice DTC04 The SYSGEN utility does display the DECvoice DTC04 The SYSGEN utility does display the DECvoice DTC04 ___ not not not interrupt vector setting. interrupt vector setting. interrupt vector setting. The only way to determine the current vector setting The only way to determine the current vector setting The only way to determine the current vector setting is to physically remove the DTC04 module from the is to physically remove the DTC04 module from the is to physically remove the DTC04 module from the Q-bus and decode the physical interrupt vector switch Q-bus and decode the physical interrupt vector switch Q-bus and decode the physical interrupt vector switch setting on the interrupt vector switch pack. The setting on the interrupt vector switch pack. The setting on the interrupt vector switch pack. The setting should then be compared to the proper setting, setting should then be compared to the proper setting, setting should then be compared to the proper setting, as displayed by SYSGEN. The switch setting must the as displayed by SYSGEN. The switch setting must the as displayed by SYSGEN. The switch setting must the same as, or must be reset to, the value of the vector same as, or must be reset to, the value of the vector same as, or must be reset to, the value of the vector that is displayed by SYSGEN. Consult the that is displayed by SYSGEN. Consult the that is displayed by SYSGEN. Consult the ________ DECvoice DECvoice DECvoice for information on switch for information on switch for information on switch _____ _________ ______ DTC04 Technical Manual DTC04 Technical Manual DTC04 Technical Manual location, configuration and settings. Contact DIGITAL location, configuration and settings. Contact DIGITAL location, configuration and settings. Contact DIGITAL Field Service for assistance. Field Service for assistance. Field Service for assistance. B-1 B-1 B-1 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 Troubleshooting DECvoice Problems Table B-1 Troubleshooting DECvoice Problems Table B-1 Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action B-2 B-2 B-2 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice is The DECvoice vector The SYSGEN visible with a is set incorrectly. utility DCL "SHOW DEVICE CONFIGURE _VXcu:[1]" command command but is marked as is used to offline and/or determine writelocked.[2] the correct vector setting. Note that SYSGEN does ___ not display the actual vector setting on any display. SYSGEN does display the _______ desired vector setting. See the ________ DECvoice _____ DTC04 _________ Technical for ______ Manual vector-related information. An An An incorrectly incorrectly incorrectly set set set hardwareB-3 hardwareB-3 hardwareB-3 vector is vector is vector is the single the single the single most most most common common common source of source of source of DECvoice DECvoice DECvoice problems. problems. problems. Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice Increase driver is unable the number to allocate enough of system system page table page table entries. entries available by following the procedure in Section 1.4.4 to increase the SPTREQ SYSGEN parameter. _______________________________________________________ [1]The actual DECvoice name should be substituted for the template name "_VXcu:" shown here. If the third DECvoice installed in the system is the problem device, use the device name "_VXC0:". DECvoice devices are always sequentially named; the first DECvoice installed on a system will be always be named "_VXA0:" [2]Check the system console, OPA0:, for messages generated by the VXDRIVER. All driver-generated messages are prefixed with "%VXDRIVER". These messages, if present, may provide additional clues to the nature of the problem. B-4 B-4 B-4 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice Increase driver is unable the number to allocate enough of system system page table page table entries. entries available by following the procedure in Section 1.4.4 to increase the SPTREQ SYSGEN parameter. See Section 3.7 for information on problem reporting procedures. The DECvoice Contact hardware, DIGITAL potentially the Field hardware that Service. implements the Q-bus shared memory used for module communications, has failed. B-5 B-5 B-5 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice ACP is This situation Comment mounted and should may occur during out the not be. a reinstallation or VOX$STARTUP.COM upgrade. call in the SYS$MANAGER:SYSTARTUP_V5.COM and reboot the system. The DECvoice ACP This situation has Comment is not mounted on been seen to occur out the any DECvoice but is occassionally during VOX$STARTUP.COM still present on the a DECvoice ACP call system. dismount operation. in the Note that most sites SYS$MANAGER:SYSTARTUP_V5.COM will not never need and to dismount the ACP. reboot the system. B-6 B-6 B-6 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice ACP This situation Manually is not mounted and may occur if the execute should be. VOX$STARTUP is not the run. "@SYS$STARTUP:VOX$STARTUP.COM" call from a privileged username. Remember to add the call into the SYS$MANAGER:SYSTARTUP_V5.COM so that the DECvoice devices will automatically remount after the next reboot the system. B-7 B-7 B-7 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The startup A previously running To work procedure returns ACP has failed. around interlock errors. this problem, reboot the VMS system. If the problem persists, see Section 3.7 for information on how to report problems. B-8 B-8 B-8 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice device The DECvoice Review the (_VXcu:[1]) is software is not installation not displayed when installed information you issue the DCL provided command "SHOW DEVICE in this _VXcu:[1]" document and perform the software installation. The SYSGEN parameter Follow the "STARTUP_P1" is procedures non-blank. mentioned above for resetting various SYSGEN parameters and set this parameter to "". A system reboot will be required. _______________________________________________________ [1]The actual DECvoice name should be substituted for the template name "_VXcu:" shown here. If the third DECvoice installed in the system is the problem device, use the device name "_VXC0:". DECvoice devices are always sequentially named; the first DECvoice installed on a system will be always be named "_VXA0:" B-9 B-9 B-9 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice CSR is See the set incorrectly.[2] ________ DECvoice _____ DTC04 _________ Technical for ______ Manual information about setting the CSR. After setting the CSR always check to see if the physical vector switch setting is correct. The DECvoice Contact hardware has failed. DIGITAL Field Service. _______________________________________________________ [2]Check the system console, OPA0:, for messages generated by the VXDRIVER. All driver-generated messages are prefixed with "%VXDRIVER". These messages, if present, may provide additional clues to the nature of the problem. B-10 B-10 B-10 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice device The DECvoice Make (_VXcu:[1]) is software has not certain online but is not been started. the mounted. "@SYS$STARTUP:VOX$STARTUP" line has been included in and executed by the site-specific startup procedure, "SYS$MANAGER:SYSTARTUP_V5.COM". _______________________________________________________ [1]The actual DECvoice name should be substituted for the template name "_VXcu:" shown here. If the third DECvoice installed in the system is the problem device, use the device name "_VXC0:". DECvoice devices are always sequentially named; the first DECvoice installed on a system will be always be named "_VXA0:" B-11 B-11 B-11 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice Check the startup detected console a configuration log for problem and aborted the system the startup. startup. The "@SYS$STARTUP:VOX$STARTUP" command will display a message indicating that the software is starting, and will subsequently produce one or more error messages pertaining to the problem that was detected. B-12 B-12 B-12 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice See ancillary control Section 3.7 process has failed for to start up. information on problem reporting procedures. B-13 B-13 B-13 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The VMS system hangs The Q-bus See the when the VOX$STARTUP configuration is ________ DECvoice procedure is potentially invalid. _____ DTC04 executed. If the _________ Technical system is in a for ______ Manual VAXcluster, it exits information the VAXcluster. concerning Q-bus configuration. Check for unoccupied Q-bus slots between the DECvoice and the processor. __ ___ Do not _____ place _____ Q-bus _____ grant _____ __ cards in ______ memory ______ slots, ___ __ nor in ___ ______ C/D slots. Contact DIGITAL Field Service for assistance. B-14 B-14 B-14 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action The DECvoice Contact hardware has failed. DIGITAL Field Service. The DECvoice The warnings are Perform startup procedure, generated by the the action VOX$STARTUP, is DECvoice software, indicated displaying one or that is, they have a by the more error messages "VOX" prefix. messages. The warnings are Determine not generated by the which DECvoice software, commands that is, they do or ___ not have a "VOX" prefix. software is causing the problem and correct it. If unable to locate cause of the problem, see Section 3.7 for information on problem reporting procedures. B-15 B-15 B-15 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action %VXDRIVER, Unit init This message This is an running on DECvoice: indicates informational VXcu: normal device message initialization that is has occurred and displayed does not indicate a on the problem. system console, OPA0:, during DECvoice device configuration. B-16 B-16 B-16 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action %VXDRIVER, DECvoice This message is This timeout-check vector displayed only message is on: VXcu: on the system displayed console, OPA0:. This on the indicates a hardware console problem or, more any time likely, an incorrect an attempt hardware vector is made to switch setting. initialize the specified DECvoice module. The SYSGEN utility CONFIGURE command is used to determine the correct vector setting. Note that SYSGEN does not, and cannot, display the actual vector setting on any display. See the ________ DECvoice B-17 B-17 B-17 _____ DTC04 _________ Technical for ______ Manual information about setting the An An An vector. incorrectly incorrectly incorrectly set vector set vector set vector is a is a is a common common common source of source of source of problems. problems. problems. Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action %VXDRIVER, shared This message is This memory access displayed on the error is failure on DECvoice: system console, displayed VXcu: OPA0:, only. This is only on typically indicative the system of a hardware console, problem. OPA0:. It indicates that the VXDRIVER, the DECvoice device driver, cannot access the DECvoice Q-bus shared memory. Contact DIGITAL Field Service. B-18 B-18 B-18 Troubleshooting Information Troubleshooting Information Troubleshooting Information _______________________________________________________ Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Table B-1 (Cont.) Troubleshooting DECvoice Problems Corrective Corrective Corrective _______________________________________________________ Problem Possible Cause Action Problem Possible Cause Action Problem Possible Cause Action Many processes are VMS system See in states other performance tuning Section 3.5 than HIB or LEF in or application and a DCL "SHOW SYSTEM" redesign may be the ___ VMS command. Possible required. _____ __ Guide To other states include ___________ Performance LEFO, COM, COMO, __________ Management MUTEX and RWxxx manual. states Return status calls These codes See of SS$_VASFULL, typically indicate Section 3.5, SS$_EXQUOTA a dearth of a the ___ VMS SYSGEN-controlled _____ __ Guide To resource or ___________ Performance a limitation __________ Management induced by a manual and quota-controlled the ______ System process resource. ________ Messages ___ and ________ Recovery __________ Procedures manual. Note that the SS$_EXQUOTA code is completely unrelated to any diskquota _______________________________________________________ limitations. B-19 B-19 B-19 _________________________________________________________________ Index Index Index _______________________________ A A A DETACH, 3-2 _______________________________ Device Timeout, B-17 DIOLM, 3-7 ACNA, 1-4 disk fragmentation, 3-10 ALTPRI, 3-1 DTC01, 1-4 ASTLM, 3-6, 3-7 DTC03, 1-4 AUTHORIZE, 3-8 DTC04, 1-1 Automatic Customer Name and _______________________________ Address, 1-4 _______________________________ E E E _______________________________ B B B _______________________________ ENQLM, 3-7 Errors, B-1 BASE Tailoring Class, 1-2 _______________________________ BIOLM, 3-6, 3-7 F F F BYTLM, 3-6, 3-7 _______________________________ _______________________________ C C C FILLM, 3-8 _______________________________ _______________________________ G G G CLISYMTBL, 1-10 _______________________________ CMEXEC, 3-1 CMKRNL, 3-1 GBLPAGES, 1-10 console, 2-15 GBLPAGFIL, 1-10 _______________________________ GBLSECTIONS, 1-10 D D D Guide to Creating VMS Modular _______________________________ Procedures, 3-10 _______________________________ DECtalk, 1-4 I I I DECvoice Continuous Word _______________________________ Recognizer, 1-2 DECvoice DTC04 Software Installation Verification Reference Manual, 1-1 Procedure, 2-1 DECvoice Software Product Interrupt Vector, 1-3, 2-5, Description, 1-2 B-1 DECvoice timeout, 2-15 Index-1 Index-1 Index-1 Index Index Index _______________________________ S S S Introduction to VAXcluster _______________________________ Application Design, 3-10 IVP, 2-1 SHARE, 3-2 _______________________________ shared memory access failure, J J J 2-15 _______________________________ Software Performance Report, 3-11 JTQUOTA, 3-8 SPD 29.97.01, 1-2 _______________________________ SPD 31.69.00, 1-2 L L L SPR, 3-11 _______________________________ SPTREQ, 1-11 SS$_VASFULL, 1-14 License Management Facility, STARTUP_P1, 1-11 1-17 SYS$MANAGER:SYSTARTUP_V5.COM, _______________________________ 3-1 M M M SYS$UPDATE:VMSLICENSE.COM, 1-5 _______________________________ SYSGBL, 3-2 Manuals, 1-1, 3-10 SYSGEN, 1-3, 2-5, B-1 MAXBUF, 1-11 SYSNAM, 3-2 _______________________________ SYSPRV, 3-2 _______________________________ P P P _______________________________ T T T _______________________________ pagefile, 3-9 PAK, 1-4 Tailoring, 1-2 PGFLQUOTA, 3-6, 3-8 Tailoring Classes, 1-2 PRCLM, 3-8 Timeout, B-17 privileges, 3-1 Troubleshooting, 1-3, 2-5, B-1 PRMGBL, 3-2 tuning, 3-4 _______________________________ Product Authorization Key, 1-4 PROGRAMMING Tailoring Class, U U U 1-2 _______________________________ _______________________________ Unit init, 2-15 R R R User account quotas, 3-8 _______________________________ Release Notes, 2-1 Index-2 Index-2 Index-2 Index Index Index _______________________________ V V V VOX$PRONOUNCE_NAME, 1-4 _______________________________ %VXDRIVER, B-16 _______________________________ VAXcluster, 3-10 W W W Vector, 1-3, 2-5, B-1, B-3, _______________________________ B-10, B-17 VIRTUALPAGECNT, 1-11, 1-14 WINDOW_SYSTEM, 1-11 VMS, 3-10 WSDEFAULT, 3-6, 3-8 VMSINSTAL, 1-16 WSEXTENT, 3-6, 3-8 VMS Version V5.2, 1-2 WSQUOTA, 3-6, 3-8 Index-3 Index-3 Index-3