DECevent Event Management Utility for OpenVMS Installation Guide Order Number: AA-Q73JD-TE This guide contains information and instructions for installing and deinstalling the DECevent event management utility on OpenVMS[TM] systems. DATE: April 1997 DECevent Version: V2.4 OpenVMS Alpha Version: V6.2 or higher OpenVMS VAX Version: V6.2 Digital Equipment Corporation Maynard, Massachusetts ________________________ 1997 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 subpara- graph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. Copyright © Digital Equipment Corporation 1997 All Rights Reserved. Printed in the United States of America. Alpha, DEC, DECevent, DIGITAL, OpenVMS, VAX, VMS, and the DIGITAL logo are trademarks of Digital Equipment Corporation. All other trademarks and registered trademarks are the property of their respective holders. This document was prepared using VAX DOCUMENT Version 2.1. Contents PREFACE v CHAPTER 1 PREPARATION 1-1 1.1 INTRODUCTION 1-1 1.2 CHECKING THE DISTRIBUTION KIT 1-2 1.3 REQUIRED OPERATING SYSTEM COMPONENTS AND SOFTWARE 1-2 1.4 PREINSTALLATION STEPS 1-2 CHAPTER 2 INSTALLING THE DECEVENT UTILITY 2-1 2.1 INTRODUCTION 2-1 2.2 INSTALLATION EXAMPLE 2-1 2.3 POSTINSTALLATION INSTRUCTIONS 2-16 2.3.1 Addition to Site-Specific Startup and Shutdown Procedures 2-16 2.3.2 Ensuring DECevent Help Is Inserted 2-16 2.3.3 Ensuring SICL Is ON 2-17 CHAPTER 3 DEINSTALLING THE DECEVENT UTILITY 3-1 3.1 INTRODUCTION 3-1 3.2 DEINSTALLATION EXAMPLE 3-1 CHAPTER 4 UPDATING KNOWLEDGE LIBRARIES FOR DEVICE SUPPORT 4-1 4.1 INTRODUCTION 4-1 4.2 KNL UPDATE EXAMPLE 4-1 APPENDIX A COMMAND SUMMARY FOR SYSTEM MANAGERS A-1 TABLES 1 Associated Documents vi A-1 Commands Related to Installation A-1 iii ___________________________________________________________________ Preface This guide describes how to install and deinstall the DECevent event management utility. ___________________________________________________________________ Intended Audience This guide is intended for users responsible for planning the installation and deinstallation of the DECevent event manage- ment utility. ___________________________________________________________________ Manual Structure This guide includes the following chapters: o Chapter 1-Provides the necessary information to prepare for a DECevent installation. o Chapter 2-Shows an actual log from a DECevent installation. Asterisks show where users need to respond to prompts or questions during the installation procedures. o Chapter 3-Shows an actual DECevent deinstallation. Asterisks show where users need to respond to prompts or questions during the deinstallation procedure. o Chapter 4-Shows an actual log from a DECevent .KNL (knowl- edge library) update. o Appendix A-Contains a table summarizing DECevent command procedures and commands used by system managers during in- stallation and post installation. ___________________________________________________________________ Associated Documents The following documents are associated with the DECevent docu- mentation. v Preface Table_1:_Associated_Documents__________________________________ Document________________________Order_No.______________________ DECevent Translation and AA-Q73KD-TE Reporting Utility for OpenVMS User and Reference Guide DECevent Analysis and AA-Q73LD-TE Notification Utility for OpenVMS User and Reference Guide The DECevent Graphical AA-QE26C-TE Interface User's Guide OpenVMS System Manager's AA-PV5MB-TK Manual: Essentials OpenVMS System Manager's AA-PV5NB-TK Manual: Tuning, Monitoring, and_Complex_Systems____________________________________________ vi Chapter 1 Preparation 1.1 Introduction This chapter describes how to prepare for the installation of the DECevent event management utility. Installing DECevent software is similar to installing other VMS optional products. The following steps must be performed: 1. Inventory the distribution kit. 2. Make sure the system has the prerequisite software. 3. Prepare the system for and inform the users of the installa- tion. 4. Perform the installation procedure and any necessary postin- stallation procedures. These procedures are explained in detail in Chapter 2. 5. Resume normal operations after the installation is complete. 6. Record the changed state of the system and report any prob- lems to the DIGITAL Customer Support Center. NOTE Previous fault management tools offered cluster-wide support by merging events from all cluster nodes into a common database. DECevent does not support the merging of events from cluster nodes into a common database. DECevent is run separately on any or all nodes of a cluster. DECevent is not supported in mixed architecture cluster environments. Preparation 1-1 1.2 Checking the Distribution Kit Each DECevent distribution kit contains: o A kit bill of materials (BOM) o The DECevent distribution medium o Documentation Check the kit contents against the kit BOM. Make sure the kit contains the correct distribution medium. The medium label contains the name of the product, DECevent, the version number (for example, DIA023), and the date. If the kit is damaged or incomplete, contact your DIGITAL rep- resentative. 1.3 Required Operating System Components and Software Installing DECevent software requires a valid VMS operating system. For OpenVMS Alpha operating systems, the system must be running at a minimum OpenVMS Alpha Version 6.2 software. For OpenVMS VAX operating systems, the system must be running OpenVMS VAX Version 6.2 software. The required software must be installed before performing the DECevent installation. 1.4 Preinstallation Steps The VMSINSTAL command procedure is used to install DECevent. NOTE System Managers need to ensure that users have an in- creased User Authorization File (UAF) page file quota (PGFLQUO) of at least 65,535 blocks. For VMSINSTAL to run properly, perform the following steps: 1. Back up the system disk. If a system failure occurs at a critical point during the installation, file corruption may occur. Therefore, back up the system disk before attempting to install DECevent software. Refer to the VMS system management documentation for more information on backup operations. 1-2 Preparation 2. Log on any terminal that has been enabled to receive op com messages. The privileges necessary for the DECevent installation are SYSPRV, DIAGNOSE, and SYSNAM. You also need the SYSLCK privilege to enable SICL. 3. Determine the number of free blocks on the appropriate disk by entering the following command: $ SHOW DEVICE SYS$SYSDEVICE The system returns the following message informing you of the number of free blocks available: Device Device Error Volume Free Trans Mnt Name Status Count Label Blocks Count Cnt $1$DUS0: (MUTT) Mounted 0 VMSRL5 900234 522 12 A minimum of 35,000 free blocks is required on the system disk to install DECevent software. 4. Make sure the JTquota for the Field account is of sufficient size to run DECevent by entering the following commands: $ SET DEFAULT SYS$SYSTEM $ MCR AUTHORIZE UAF> SHOW FIELD Username: FIELD Owner: FIELD SERVICE Account: FIELD UIC: [1,10] ([FIELD]) CLI: DCL Tables: DCLTABLES Default: SYS$SYSROOT:[SYSMAINT] LGICMD: LOGIN Flags: Primary days: Mon Tue Wed Thu Fri Secondary days: Sat Sun No access restrictions Expiration: (none) Pwdminimum: 8 Login Fails: 0 Pwdlifetime: 30 00:00 Pwdchange: 24-AUG-1993 10:33 Last Login: 27-AUG-1993 08:17 (interactive), 27-AUG-1993 08:59 (non-interactive) Maxjobs: 0 Fillm: 100 Bytlm: 10240 Maxacctjobs: 0 Shrfillm: 0 Pbytlm: 0 Maxdetach: 0 BIOlm: 18 JTquota: 4096 Prclm: 2 DIOlm: 18 WSdef: 150 Prio: 4 ASTlm: 24 WSquo: 1024 Queprio: 0 TQElm: 20 WSextent: 0 CPU: (none) Enqlm: 30 Pgflquo: 65,535 NOTE Locate the JTquota: field. Notice the JTquota is 4096 in this example. The JTquota must be increased to 8192 Preparation 1-3 for DECevent software to work. The next UAF> prompt in this procedure allows you to change the JTquota by entering the MODIFY FIELD /JTQUOTA=8192 command. Also, system managers need to ensure that users have an increased User Authorization File (UAF) page file quota (PGFLQUO) of at least 65,535 blocks as shown on the last line of the above display. Authorized Privileges: GRPNAM ALLSPOOL DIAGNOSE LOG_IO GROUP PRMCEB PRMMBX SETPRV TMPMBX NETMBX PHY_IO Default Privileges: GRPNAM ALLSPOOL DIAGNOSE LOG_IO GROUP PRMCEB PRMMBX SETPRV TMPMBX NETMBX PHY_IO UAF> MODIFY FIELD/JTQUOTA=8192 %UAF-I-MDFYMSG, user record(s) updated UAF> EXIT %UAF-I-DONEMSG, system authorization file modified %UAF-I-NAFNOMODS, no modifications made to network proxy data base %UAF-I-RDBNOMODS, no modifications made to rights data base 5. You must delete previously installed versions of DECevent from your system using the deinstallation process contained in Chapter 3. 1-4 Preparation Chapter 2 Installing the DECevent Utility 2.1 Introduction This chapter explains how to run the installation procedure for the DECevent utility. Allow 15 minutes to complete the installation. DIGITAL recommends referring to the VMSINSTAL command proce- dure in the OpenVMS documentation set. See the OpenVMS System Manager's Manual: Essentials and the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems. 2.2 Installation Example This section contains an example of a successful DECevent in- stallation. Within the installation procedures are questions that you must answer to complete the installations. These ques- tions are marked with an asterisk (*). Follow all responses to questions with a carriage return. Responses in the examples are shown in uppercase letters. NOTE A product authorization tool (PAK) license is required in order to utilize the DECevent analysis and notifica- tion added-value options. The license is obtained by a DIGITAL Customer Services engineer through the techni- cal information management architecture (TIMA) and must be installed on your system prior to kit installation. To find the DECevent service PAK in TIMA, select the TIMA tools database and search for "DECEVENT PAK". The title of the tool you need is "Service Tools Product Authorization Key (PAK) Distribution Tool". Refer to TIMA documentation for specifics. Installing the DECevent Utility 2-1 In addition, customers may acquire the PAK information by requesting the PAK from DSNlink hardware support. You may also refer to the DSNlink for OpenVMS Users's Guide (AA-PBL4D-TE) for further information about DSNlink. Licenses are verified at run time by the License Management Facility (LMF). For more information on LMF concepts and operation, enter the HELP LICENSE command at the DCL ($) prompt. NOTE If a version of DECevent software prior to V2.1 was installed on your system, all users must delete the local knowledge library, FMG_LOCAL_PARAM_LIBRARY.KNL, from their sys$login directory after installing the new version of DECevent. If installing DECevent from a tape drive, make sure the instal- lation tape is mounted and on-line. If installing DECevent from a CD-ROM, make sure the CD is inserted into the CD-ROM drive. The following is an example of a successful DECevent installa- tion to the system disk, where command @SYS$UPDATE:VMSINSTAL is the VMS install command, DIA_VMSALPHA_023 is the DECevent save set name being installed, and DKB100:[Garcia] is the name of the system disk. $ @SYS$UPDATE:VMSINSTAL DIA_VMSALPHA_023 DKB100:[Garcia] OpenVMS AXP Software Product Installation Procedure V6.2 It is 1-MAY-1996 at 10:45. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. %VMSINSTAL-W-ACTIVE, The following processes are still active: LESH HART WEIR * Do you want to continue anyway [NO]? Y * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: DIA_VMSALPHA_ V2.4 Beginning installation of DIA_VMSALPHA_ V2.4 at 10:45 %VMSINSTAL-I-RESTORE, Restoring product save set A ... 2-2 Installing the DECevent Utility This kit places the files named DECEVENT$024_RELEASE_NOTES.PS and DECEVENT$024_RELEASE_NOTES.TXT in SYS$HELP. These files summarizing the new features, changes, restrictions, and compatibility issues for this release of DECevent. This file contains information valuable to DECevent users. Please inform your user community of the existance of these files. * Do you want to purge files replaced by this installation [YES]? By default, DECevent is installed on the system disk (SYS$SPECIFIC:[DIA$TOOLS]). If space is limited you can elect to install DECevent on another disk. * Enter device name where DECevent is to be installed [SYS$SYSDEVICE]: NOTE Pressing return after the above question forces DECevent to be installed on your system disk. If you wish to install DECevent on a disk other than the system disk, enter the name of the device after the above question and press return. Please verify that your current DECevent license (PAK) is current. If your license has expired, please contact your local DIGITAL Service Representitive for information regarding an updated license. * Is there a current authorization key (PAK) registered and loaded for DECevent [YES]: DECevent requires a DIA$MANAGER account on all systems running DECevent. The entry in the User Authorization File (SYSUAF) for DIA$MANAGER MUST not be modified at any time. * Enter UIC for DIA$MANAGER (with brackets) [[375,300]]: NOTE If you enter a UIC that is already active, you are prompted to enter a new UIC. * Enter password for DIA$MANAGER account: * Re-enter password for verification: NOTE User response not echoed when a password is entered or verified. Installing the DECevent Utility 2-3 * Enter system serial number for node: OLD1S (DEC 3000): 33333333 * Start automatic analysis upon completion of this installation [Y]? NOTE Answering YES to the above question initiates auto- matic analysis on this node. Automatic analysis starts the monitoring process that enables DECevent to detect system faults. You have answered all of the questions for this installation. The installation takes 3 to 15 minutes to complete depending on your configuration. No more questions will be asked. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-SYSDIR, This product creates system specific directory [DIA$TOOLS]. %VMSINSTAL-I-SYSDIR, This product creates system specific directory [DIA$TOOLS.MANAGER]. DECevent help successfully inserted into the system help library. NOTE If for some reason DECevent help cannot be inserted into the system, the following message is displayed: The system help library cannot be updated at this time. Please wait until no users are using the help facility and then re-run the SYS$HELP:DECEVENT$UPDATE_HELP.COM command file. Follow the instructions given in the message about re- running the command file and help will be inserted. Refer to Section 2.3.2 for more information about ensur- ing that the DECevent system help library is updated. %DCL-I-SUPERSEDE, previous value of VMI$ has been superseded %DCL-I-SUPERSEDE, previous value of HLP_ has been superseded %DCL-I-SUPERSEDE, previous value of VMI$ has been superseded %VMSINSTAL-I-ACCOUNT, This installation creates an ACCOUNT named DIA$MANAGER. %UAF-I-ADDMSG, user record successfully added %UAF-I-RDBADDMSGU, identifier DIA$MANAGER value [000375,000300] added to rights database %VMSINSTAL-I-ACCOUNT, This installation updates an ACCOUNT named DIA$MANAGER. %UAF-I-MDFYMSG, user record(s) updated Your VMS system will now be modified to include the following files: 2-4 Installing the DECevent Utility SYS$LIBRARY:DCLTABLES.EXE SYS$HELP:HELPLIB.HLB SYS$SYSTEM:DIA.EXE SYS$LIBRARY:DECEVENT$SHARE.EXE SYS$LIBRARY:XDECEVENT$SHARE.EXE DECW$SYSTEM_DEFAULTS:PRE_GUI__VMS.UID SYS$STARTUP:DECEVENT$STARTUP.COM SYS$HELP:DECEVENT$023_RELEASE_NOTES.PS SYS$HELP:DECEVENT$023_RELEASE_NOTES.TXT SYS$HELP:FMG_HELP_FILE__AMERICAN_ENGLISH.HLB SYS$HELP:FMG_HELP_FILE__AMERICAN_ENGLISH.HLP SYS$HELP:DECEVENT$UPDATE_HELP.COM DIA$EXE:FMG_AMERICAN_ENGLISH__MESSAGES.KNL DIA$EXE:FMG_AMERICAN_ENGLISH__HELP_STRINGS.KNL DIA$EXE:FMG_GLOBAL_PARAM_LIBRARY.KNL DIA$EXE:FMG_FACTORY_GLOBAL_PARAM_LIBRARY.KNL DIA$EXE:FMG_CTR__DEF_RUL_LIB.KNL DIA$EXE:FMG_ETC__DEF_RUL_LIB.KNL DIA$EXE:FMG_RPT__DEF_RUL_LIB.KNL DIA$EXE:FMG_ETC__DEF_SEL_LIB.KNL DIA$EXE:FMG_ANA__DEF_RUL_LIB.KNL DIA$EXE:FMG_ANA__FAC_STATE_DB.KNL DIA$EXE:FMG_NOT__DEF_MAIL_LIB.KNL DIA$EXE:FMG_NOT__DEF_RUL_LIB.KNL DIA$EXE:FMG_NOT__DEF_EXTERNAL_LIB.KNL DIA$EXE:RFTS.EXE NOTE The above file DIA$EXE:RFTS.EXE will appear in this list only if DECevent is being installed on an OpenVMS Alpha system. DIA$EXE:AXP_SYS12_EV5.BIN DIA$EXE:AXP_SYS17_EV4.BIN DIA$EXE:AXP_SYS27_EV45.BIN DIA$EXE:AXP_SYS9_EV4.BIN DIA$EXE:AXP_SYS9_EV5.BIN DIA$EXE:DEC_4000.BIN DIA$EXE:DEC_7000.BIN DIA$EXE:RFXX.BIN DIA$EXE:KDM70.BIN DIA$EXE:DSA.BIN DIA$EXE:HSAC.BIN SYS$MANAGER:DECEVENT$SHUTDOWN.COM DIA$EXE:FMG_VMS_COMMAND.KNL DIA$EXE:FMG_UNIX_COMMAND.KNL SYS$MANAGER:DECEVENT$DEINSTALL.COM DIA$EXE:FMG_ANA__PRM_STATE_DB.KNL Installing the DECevent Utility 2-5 The file SYS$STARTUP:DECEVENT$STARTUP.COM contains commands to be executed at system startup. $ @SYS$STARTUP:DECEVENT$STARTUP.COM You must add the above line to your system's site specific startup procedure. The file SYS$STARTUP:DECEVENT$SHUTDOWN.COM contains commands to be executed when the system is to be shutdown $ @SYS$STARTUP:DECEVENT$SHUTDOWN.COM You must add the above line to the system's site specific shutdown procedure ( sys$startup:syshutdwn.com ). *************************************************************************** PLEASE NOTE: If you are installing DECevent over a pre-V2.1 version of DECevent, then ALL users MUST delete their SYS$LOGIN:FMG_LOCAL_PARAM_LIBRARY.KNL files. There was a new knowledge file format in DECevent V2.1 that superceded all previous versions of knowledge files. There is no conversion utility. DECevent will detect these outdated files and inform the user. *************************************************************************** To permanently remove the DECEVENT image, check the release notes for directions on how to run DECEVENT$DEINSTALL.COM. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... ************************************************************************ Executing the DECevent Installation Verification Procedure (IVP) ************************************************************************ $ $ IF P2 $ ENDIF $ $ ON ERROR THEN GOTO IVP_ERR $ $ DIAGNOSE SHOW SETTING DECevent V2.4 Current Settings Information: 2-6 Installing the DECevent Utility Name Value ============================================================================== CMD_TRACE 0 CTR_TRACE 0 DEBUG_STATE 0 ETC_TRACE 0 FMG__DEBUG_STATE 0 FMG__TRACE_STATE 0 RPT_TRACE 0 TRACE_STATE 0 CTR__DMP_RUL ROOT.DUMP_EVENT_CA CTR__RUL_LIB CTR__DEF_RUL_LIB CTR__SUM_LIB CTR__DEF_SUM_LIB DEF_CTR_RULE ROOT.HEADER_CA DEF_ETC_RULE ROOT.HEADER_EV ETC__DMP_RUL ROOT.DUMP_EVENT_EV ETC__RUL_LIB ETC__DEF_RUL_LIB ETC__SEL_LIB ETC__DEF_SEL_LIB RPT__RUL_LIB RPT__DEF_RUL_LIB HELP_FILE FMG_HELP_FILE CURRENT_CLI VMS VMS_DEFAULT /TRANSLATE UNIX_DEFAULT UNIX_DEFAULT CHEROKEE_VMS_DEFAULT /TRANSLATE DEF_EVT_LOG SYS$ERRORLOG:ERRLOG.SYS LOCALE AMERICAN_ENGLISH PRINT_MESSAGES 7 STREAM_SIZE 20 SYS_ACT_LOG_NAME DIA_ACTIVITY.LOG KNL__DEF_ENTRIES 32 KNL__LIB_DIRECTORY DIA$LIBRARY: KNL__LIB_PREFIX FMG_ KNL__LIB_SUFFIX .KNL VAX_VMS_STACK_SIZE 10 VAX_VMS_GUARD_SIZE 3 ALPHA_VMS_STACK_SIZE 50 ALPHA_VMS_GUARD_SIZE 30 RULE_MAX_BYTECNT 100000 DEFAULT_REPORT FULL_RE ANA_TRACE 0 NOT_TRACE 0 ANA__FAC_DB ANA__FAC_STATE_DB ANA__PRM_DB ANA__PRM_STATE_DB ANA__RUL_LIB ANA__DEF_RUL_LIB ANA__TMP_DB ANA__TMP_STATE_DB NOT__RUL_LIB NOT__DEF_RUL_LIB NOT__MAIL_LIB NOT__DEF_MAIL_LIB NOT__EXTERNAL_LIB NOT__DEF_EXTERNAL_LIB FMG__CUST_PROFILE FMGPROFILE Installing the DECevent Utility 2-7 FMG_VERSION 2.1 SICL_STATE OFF SICL_PROTOCOL_VERS 1 AUTO_COPY OFF ANALYSIS_TRIGGER_AUTOMATIC AUTOMATIC ANALYSIS_TRIGGER_MANUAL MANUAL NOT__DEF_CSC_PHONE 1-800-354-9000 NOT__MAX_DSNLNK_MSG 59 MAIL_DEBUG 0 $ DIAGNOSE /TRANSLATE COBRA_MC_670.SYS DECevent V2.4 ******************************** ENTRY 1 ******************************** Logging OS 1. OpenVMS System Architecture 2. Alpha OS version V1.0 Event sequence number 13. Timestamp of occurrence 06-NOV-1992 16:42:02 Time since reboot 0 Day(s) 1:25:04 Host name System Model Entry type 2. Machine Check CPU Minor class 1. Machine check (670 entry) frame revision x0001 scb vector x0670 processor machine check fru 1 x00 field not valid fru 2 x00 field not valid severity x0000 field not valid cpu id x0000 error count x0001 threshold for fail code x0000 fail code x0000 error flag1 x0000000800000001 CPU_0 Bus Command No-Ack CPU cycle aborted with HARD ERROR error flag2 x0000000000000000 frame id x00000002 MC 670 Frame byte count x00000218 2-8 Installing the DECevent Utility Byte Count x0218 Processor Specific Offset x00000110 System Specific Offset x000001A0 PAL Error Type Code x0000008A Bugchk Generated by OS specific PALcode PAL Frame Revision x00000001 - ALPHA CHIP REGISTERS - PALTEMP1 xFFFFFFFF816B8000 PALTEMP2 x001FC0F800000004 PALTEMP3 x0000000000000000 PALTEMP4 xFFFFFFFF80542040 PALTEMP5 x0000000000000000 PALTEMP6 xFFFFFFFF816BE000 PALTEMP7 x0000000000004200 PALTEMP8 x0000000000000400 PALTEMP9 x0000000000000003 PALTEMP10 x000000AAB42884E5 PALTEMP11 x0000000000000000 PALTEMP12 x000000000000005D PALTEMP13 xFFFFFFFF8042ECE0 PALTEMP14 x0000000000000000 PALTEMP15 x0000000000000000 PALTEMP16 x0000000000030000 PALTEMP17 x0000000000000000 PALTEMP18 x000000007FFBF80C PALTEMP19 x0000000000000081 PALTEMP20 x0000000000002041 PALTEMP21 x0000000240000000 PALTEMP22 x400001C1400001C1 PALTEMP23 x0000000000000000 PALTEMP24 xFFFFFFFF8052A000 PALTEMP25 x0000000000010000 PALTEMP26 x000000007FF96000 PALTEMP27 x0000000000000000 PALTEMP28 x000000000117E000 PALTEMP29 x0000000200000000 PALTEMP30 x00000000002E4000 PALTEMP31 x0000000001474080 Exception Address Reg x000000000002012E Exception Address Reg Provides Information About The Most Recent Exception. Address Points to Native-Mode Instruction If Machine Check or Math Trap Exception, PC in Exception Address is Correct. Last Exception Addr PC: x000000000000804B Exception Summary Reg x0000000000000000 Exception Mask Reg x0000000000000000 Icache Ctrl & Status Reg x001FC0F800000004 Performance Counters Disabled Empty Wrt Buffer Before Issuing Next Inst Installing the DECevent Utility 2-9 Branch Prediction Selection: Not Taken JSR Stack is Disabled Instructions Can Only Single Issue If Not in PALmode, Executing Reserved Inst Opcode Will Result in OPCDEC Exception. Super Page Istream Memory Mapping Disabled Float Point Inst Will Cause FEN Exception Icache Addr Space Numb: x0000000000000000 PALcode Base Address Reg x0000000000008000 PALcode Base Address: x0000000000000002 Hardware Int Enable Reg x00000001FFFFDCF0 CRD Error Interrupts Enabled CPU Hrdw Interrupts Enbld Irq_h Pins 0,1,2 CPU Hrdw Interrupts Enbld Irq_h Pins 3,4,5 Performance Cntr 0 & 1 Interrupts Disabled Serial Line Interrupts Disabled Software Interrupts Enbld on Level 1,2,3,4 Software Interrupts Enbld on Level 5,6,7,8 Software Interrupts Enbld Level 9,10,11,12 Software Interrupts Enbld Levels 13,14,15 AST Interrupts Enbld in Kernel, Executive, Supervisor, and User Mode. Hardware Int Request Reg x0000000000000702 Any Hrdw Int Req With Companion Enable Set NO Softw Int Req With Companion Enable Set NO AST Int Req With Companion Enable Set CPU Hrdw Interrupt Request on Irq_h Pin 0 Performance Counter 1 Interrupt Requested Performance Counter 0 Interrupt Requested Memory Management CSR x0000000000003640 MMCSR Valid Only on Mem Mgt Err, DTB Miss, D-Stream Fault, Dcache Parity Error. Last Faulting Instruction RA Field: R4 Last Faulting Instruction Opcode Follows: x1B - Reserved for PALcode (Data) Cache Status Reg x00000000000002E0 This is EV4 Data Cache Status Reg(DC_STAT) EV4 Chip is Early Version of 21064 Last Load or Store Missed Dcache PARITY ERROR DETECTED in Icache Cache Address Reg x00000007FFFFFFFF Abox Control Reg x000000000000040E Machine Checks Enabled for Uncorr Errors CRD Interrupts Enabled Single Entry Icache Stream Buffer Enabled Lock Operation Conforms to Alpha Architect Dcache Enabled 8K Byte Dcache Selected Bus Interface Status Reg x0000000000002041 2-10 Installing the DECevent Utility HARD ERROR Detected During External Cycle BIU Command Cycle Type: Read_Block Bus Interface Address Reg x0000000240000000 Address Only Valid if Bus Interface Status Register Error Bit 0,1,2, or 3 is Set. BIU Addr adr_h<33:5>: x0000000012000000 Bus Interface Control Reg x0000000C30006337 External Cache (Bcache) Enabled ECC MODE: External Cache ECC Enabled Cache Rams are Output Enable Controlled Ext Cache Rd Access Time: 4 CPU Cycles Ext Cache Wrt Cycle Time: 4 CPU Cycles Size of External Cache: 1 Mbyte Ext Cache Rd Time Controlling Bcache Reads Ext Cache Wrt En Ctrl: x0000000000000003 Fill Syndrome Reg x0000000000000000 No Error in Low Long Word of Quad Word No Error in Upper Long Word of Quad Word Fill Address Reg x0000000000006100 Addr Only Valid if Bus Interface Stat Reg ECC(Bit 8) or PARITY(Bit 10) Error Set. Cache Blk Phy Adr<33:5> x0000000000000308 Virtual Address Reg x0000000000006170 Dstream FLT/DTB Miss VA x0000000000006170 Bcache Tag Reg x0104900104A41224 Last Bcache Access Resulted in a Miss Parity Bit for Bcache Tag Status Bits Clr Bcache Tag Dirty Bit Set Bcache Tag Shared Bit Clear Bcache Tag Valid Bit Clear Bcache Tag Addrress Parity Bit Clear Tag Being Probed: x0000000000012091 BCC_CSR0 x400001C1400001C1 enb allocate enb cor err interrupt enb ecc correction enb edc chk enb allocate h enb cor err interrupt h enb ecc correction h enb edc chk h BCCE_CSR1 x0000000000000000 edc syndrome 0 x0000000000000000 edc syndrome 2 x0000000000000000 edc syndrome 1 x0000000000000000 Installing the DECevent Utility 2-11 edc syndrome 3 x0000000000000000 BCCEA_CSR2 x0000000000000000 b-cache map offset x0000000000000000 tag value x0000000000000000 b-cache map offset h x0000000000000000 tag value h x0000000000000000 BCUE_CSR3 x0000000000000000 edc syndrome 0 x0000000000000000 edc syndrome 2 x0000000000000000 edc syndrome 1 x0000000000000000 edc syndrome 3 x0000000000000000 BCUEA_CSR4 x00440A6400440A64 B-CACHE MAP OFFSET x0000000000000A64 tag parity tag parity h tag value x0000000000000008 b-cache map offset h x0000000000000A64 tag value h x0000000000000008 DTER_CSR5 x0006619000066190 dup tag store offset x0000000000000064 dup tag x0000000000000198 dup tag store offset h x0000000000000064 dup tag h x0000000000000198 CBCTL_CSR6 x00007F2800007F28 enable parity check enb c-bus error interrupt reserve diagnostic enable parity check h enb c-bus error interrupt h reserve diagnostic h c/a wrong parity x0000000000000000 commander id x0000000000000001 arb control mask x0000000000000007 c/a wronge parity h x0000000000000000 commander id h x0000000000000001 2-12 Installing the DECevent Utility arb control mask h x0000000000000007 CBE_CSR7 xCC003002C8004002 reserved diagnostic c/a not acked madr valid reserved diagnostic h data parity error lw5 error data parity error lw7 error madr valid h miss count x0000000000000024 miss count h x0000000000000026 CBEAL_CSR8 x8000004390000003 address x0000000024000000 address h x0000000020000010 CBEAH_CSR9 xFF200053FF200093 exchange address x0000000000000024 transaction type x0000000000000000 commander id x0000000000000001 exchange address h x000000000000053F transaction type h x0000000000000000 commander id h x0000000000000000 PMBX_CSR10 x0000000000000000 IPIR_CSR11 x0000000000000000 SIC_CSR12 x0000000000000004 dec_4000-bus error interrup clear ADLK_CSR13 x000C1388000C1388 lock address x0000000000018271 lock address h x0000000000018271 MADRL_CSR14 x00104A7B00104A8B madr valid madr valid h transaction type x0000000000000001 address x00000000000412A2 transaction type h x0000000000000001 address h x000000000004129E frame id x00000000 End of Frame byte count x00000000 $ $ IF .NOT. P1 $ THEN $ DIAGNOSE /ANALYZE COBRA_MC_670.SYS DECevent V2.4 Installing the DECevent Utility 2-13 The optional, licensed, software to perform analysis and/or notification is enabled. Copyright (c) Digital Equipment Corporation, All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation ("DIGITAL"). This software has been installed and enabled to enhance the maintenance services provided by DIGITAL. Use of this software by anyone other than DIGITAL maintenance personnel is not permitted without a license. Customers who have signed a DIGITAL Service Agreement ("Agreement") have been granted such a license for their own use on equipment covered by the Agreement. Any other use, copying or license to any other party whatsoever is not permitted. DIGITAL reserves the right to remove or disable this software at its discretion. DECevent Notification Report DECevent has detected that the following device needs attention: DEVICE: NONE DEC_4000 NODE: N/A SYSTEM SERIAL NUMBER: N/A SYSTEM TYPE: N/A DECevent Diagnosis Information Digital Services Device: NONE DEC_4000 Error: N/A Count: 0 Theory: 30F2C.10-1:3;1 Evidence: TBD Time Of Error: 92-11-06 16:42:02 $ DIAGNOSE SHOW PARAM DECevent V2.4 The optional, licensed, software to perform analysis and/or notification is enabled. Copyright (c) Digital Equipment Corporation, All Rights Reserved. 2-14 Installing the DECevent Utility This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation ("DIGITAL"). This software has been installed and enabled to enhance the maintenance services provided by DIGITAL. Use of this software by anyone other than DIGITAL maintenance personnel is not permitted without a license. Customers who have signed a DIGITAL Service Agreement ("Agreement") have been granted such a license for their own use on equipment covered by the Agreement. Any other use, copying or license to any other party whatsoever is not permitted. DIGITAL reserves the right to remove or disable this software at its discretion. Analysis Notification Parameters: PHONE NUMBER Customer Service Phone Number is 1-800-354-9000 SICL System Initiated Call Logging is OFF SYSTEM INFO System Info for OLD1S Serial Number 33333333 System Type DEC 3000 $ DIAGNOSE SHOW MAIL DECevent V2.4 The optional, licensed, software to perform analysis and/or notification is enabled. Copyright (c) Digital Equipment Corporation, All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation ("DIGITAL"). This software has been installed and enabled to enhance the maintenance services provided by DIGITAL. Use of this software by anyone other than DIGITAL maintenance personnel is not permitted without a license. Customers who have signed a DIGITAL Service Agreement ("Agreement") have been granted such a license for their own use on equipment covered by the Agreement. Any other use, copying or license to any other party whatsoever is not permitted. DIGITAL reserves the right to remove or disable this software at its discretion. Notification Mailing Lists: -- Mailing List: CUSTOMER SYSTEM -- Mailing List: FSE FIELD -- Mailing List: MONITOR SYSTEM Installing the DECevent Utility 2-15 -- Mailing List: SICL DSN%SICL $ ENDIF $ GOTO END $END: $ SET NOVERIFY %RUN-S-PROC_ID, identification of created process is 000000C8 Installation of DIA_VMSALPHA_ V2.4 completed at 10:47 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]DIA_VMSALPHA_023.VMI_DATA VMSINSTAL procedure done at 10:47 $ 2.3 Postinstallation Instructions The DECevent installation procedure contains instructions for certain postinstallation procedures. These postinstallation procedures are contained in this section. 2.3.1 Addition to Site-Specific Startup and Shutdown Procedures You must add the following command to your system site specific startup procedure in the file SYS$STARTUP:SYSTARTUP_VMS.COM: $ @SYS$STARTUP:DECEVENT$STARTUP.COM The SYS$STARTUP:DECEVENT$SHUTDOWN.COM file contains commands to be executed when the system is to be shutdown. You must add the following line to the system's site specific shutdown procedure (SYS$STARTUP:SYSHUTDWN.COM): $ @SYS$STARTUP:DECEVENT$SHUTDOWN.COM 2.3.2 Ensuring DECevent Help Is Inserted If for some reason DECevent help cannot be inserted into the system, you must run the SYS$HELP:DECEVENT$UPDATE_HELP.COM command file as part of the postinstallation procedures. The installation procedure warns you if DECevent help was not in- serted during installation with the following message: 2-16 Installing the DECevent Utility The system help library cannot be updated at this time. Please wait until no users are using the help facility and then re-run the SYS$HELP:DECEVENT$UPDATE_HELP.COM command file. 2.3.3 Ensuring SICL Is ON To ensure the System Initiated Call Logging (SICL) process is active on the system on which DECevent has been installed, the following command procedure should be run by your DIGITAL Multivendor Customer Services engineer. Engineer responses are needed where asterisks are shown. DSNlink is required on your system in order for the SICL function to operate as well as the SYSLCK privilege. @DIA$MGR:DECEVENT$SICL_ENABLE This procedure is used to enable the DECevent SICL capabilities. SICL (System Initiated Call Logging) causes the DECevent software to log service calls with a DIGITAL Customer Support Center when repair actions are required for a particular device. It requires access to the SYS$STARTUP:DECEVENT$STARTUP.COM file and SYSNAM privilege. Enter "?" for help with any question. * Do you want to continue [YES]: YES * Is SICL to be enabled at this site [YES]: YES If your site has not been registered with the Customer Support Center then SICL calls are not processed by the CSC. You can continue the SICL installation even if you are not registered. * Do you want to continue [YES]: YES In order to properly handle SICL data at the DIGITAL CSC, system serial numbers must be accurately entered in the DECevent database. The following information was found in the DECevent database: Your current DECevent System Information Settings are: DECevent V2.4 Analysis Notification Parameters: PHONE NUMBER Customer Service Phone Number is 1-800-354-9000 SICL System Initiated Call Logging is OFF COPY Autocopy is OFF SYSTEM INFO System Info for OLD1S Serial Number 105 System Type DEC 3000 Installing the DECevent Utility 2-17 * Is the DECevent information complete and correct [YES]: YES SICL requires that DSNlink software be installed and that this site is registered for SICL with the appropriate Customer Support Center (CSC). * Is DSNlink installed at this site [YES]: YES The next question asks for the location of the customer profile file. This file contains site specific customer profile data as ASCII text. Enter NONE if no customer profile information is desired. * Enter customer profile filename [NONE]: SYS$MANAGER:DIA$CUSTOMER_PROFILE.DAT The customer profile contains the following: ******************************************************************** Customer Name: Unbroken Chain Customer Address: Brokedown Palace St. San Fran. CA Customer Phone: 808-352-1324 Customer Contact: Phil Lesh Customer System Dec3500AXP ******************************************************************** SICL mail sent to the DIA$MANAGER account includes the replies to service request messages sent by the CSC that contain the log number of the call. The next question asks for the VAXmail address to forward these replies to from the DIA$MANAGER account. * Enter VAXmail address to receive SICL reply messages from CSC [SYSTEM]: Outgoing service request mail normally only goes to the DSN%SICL address. The next question asks for a list (separated by commas) of additional VAXmail addresses to get copies of service request mail. * Enter VAXmail addresses for copies of outgoing SICL messages: FIELD * Do you want to purge old versions of sys$startup:decevent$startup.com [YES]: %DECevent-I-NOMORE, no more questions will be asked %DECevent-I-EDITSTARTUP, editing SYS$STARTUP:DECEVENT$STARTUP.COM %DECevent-I-REPLPROF, replacing existing FMGPROFILE definition %DECevent-I-SETFORWARD, forwarding DIA$MANAGER mail to SYSTEM %DECevent-I-SETMAILLIST, setting up DECevent SICL mailing list %DECevent-I-ADDSICL, Adding FIELD to the SICL mailing list DECevent V2.4 Your current SICL mail distribution lists are: 2-18 Installing the DECevent Utility DECevent V2.4 Notification Mailing Lists: -- Mailing List: CUSTOMER SYSTEM -- Mailing List: FSE FIELD -- Mailing List: MONITOR SYSTEM -- Mailing List: SICL DSN%SICL FIELD If you need to modify the SICL mailing lists, use the DECevent ADD USER and REMOVE USER commands. %DECevent-I-SETSICLSTATE, setting DECevent SICL state to ON, ignore DIA>prompts DIA> SHOW SICL Current Settings Information: Name Value ================================================================== SICL_STATE ON DIA> This system is now enabled for System Initiated Call Logging Installing the DECevent Utility 2-19 Chapter 3 Deinstalling the DECevent Utility 3.1 Introduction This chapter explains how to run the deinstallation procedure for the DECevent event management utility. Follow the procedure closely. 3.2 Deinstallation Example This section contains an example of a deinstallation procedure on a system. You must respond to questions during the deinstal- lation procedure. These questions are marked with an asterisk (*). User responses are shown in uppercase letters. Upon com- pletion of the deinstallation procedure, you must log off the system, log back on, and delete the DECEVENT$DEINSTALL.COM command procedure from SYS$MANAGER. NOTE The DECevent automatic analysis option must be disabled before DECevent software can be deinstalled. Enter the SHOW SYSTEM command to see if automatic analysis is currently running. Look in the display for the name DECevent_, as shown on the last line of the following example. GARCIA> SHOW SYSTEM Deinstalling the DECevent Utility 3-1 OpenVMS V6.2 on node GARCIA 7-FEB-1995 10:24:50.90 Uptime 0 01:26:30 Pid Process Name State Pri I/O CPU Page flts Pages 00000081 SWAPPER HIB 16 0 0 00:00:00.06 0 0 00000086 OPCOM HIB 6 58 0 00:00:00.35 92 43 00000087 AUDIT_SERVER HIB 10 55 0 00:00:00.11 310 46 00000088 JOB_CONTROL HIB 9 80 0 00:00:00.05 37 55 00000089 QUEUE_MANAGER HIB 8 44 0 00:00:00.08 105 149 0000008A TP_SERVER HIB 10 382 0 00:00:01.02 55 86 0000008C NETACP HIB 10 121 0 00:00:00.15 131 73 0000009A SYSTEM LEF 9 35 0 00:00:00.09 135 61 000000AA DECevent_GARCIA HIB 6 156 0 00:00:03.01 857 880 If the name DECevent_ appears in the display, indi- cating automatic analysis is running, you must execute one of the following commands. $ @SYS$STARTUP:DECEVENT$SHUTDOWN.COM NOTE You must have SYSLCK privileges to run the above command procedure. $ DIAGNOSE SHUTDOWN STRIKE Once the shutdown command procedure has been executed, run the deinstallation procedure as follows: $ @SYS$MANAGER:DECEVENT$DEINSTALL This procedure will remove DECevent facility from your system disk. * Do you wish to continue? [Yes] : YES 3-2 Deinstalling the DECevent Utility %DIAGNOSE-I-REMOVE, Removing verb DIAGNOSE from: SYS$COMMON:[SYSLIB]DCLTABLES.EXE %DIAGNOSE-I-INSTAL, Installing SYS$COMMON:[SYSLIB]DCLTABLES.EXE %DIAGNOSE-I-DELHELP, Removing help topic: DIAGNOSE from system help file %DIAGNOSE-I-DELFIL, Deleting DECevent files and directory %DELETE-I-FILDEL, SYS$COMMON:[SYS$STARTUP]DECEVENT$STARTUP.COM;1 deleted (27 blocks) %DELETE-W-SEARCHFAIL, error searching for SYS$HELP:FMG_HELP_FILE__AMERICAN_ENGLISH.HLB;* -RMS-F-FNM, error in file name %DELETE-I-FILDEL, SYS$COMMON:[SYSEXE]FMG__MAIN.EXE;1 deleted (7344 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;32 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;31 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;30 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;29 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;28 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;27 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;26 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;25 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;24 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;23 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;22 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;21 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;20 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;19 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;18 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;17 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;16 deleted (705 blocks) %DELETE-I-FILDEL, SYS$SYSROOT:[SYSLIB]FMG_ANA__PRM_STATE_DB.KNL;15 deleted (705 blocks) Deinstalling the DECevent Utility 3-3 %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB] FMG_AMERICAN_ENGLISH__HELP_STRINGS.KNL;1 deleted (24 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB] FMG_AMERICAN_ENGLISH__MESSAGES.KNL;1 deleted (453 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB]FMG_CTR__DEF_RUL_LIB.KNL;1 deleted (7008 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB]FMG_ETC__DEF_RUL_LIB.KNL;1 deleted (3807 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB]FMG_ETC__DEF_SEL_LIB.KNL;1 deleted (51 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB] FMG_FACTORY_GLOBAL_PARAM_LIBRARY.KNL;1 deleted (75 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB]FMG_GLOBAL_PARAM_LIBRARY.KNL;1 deleted (75 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB]FMG_RPT__DEF_RUL_LIB.KNL;1 deleted (1818 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYSLIB]FMG_VMS_COMMAND.KNL;1 deleted (1035 blocks) %DELETE-I-TOTAL, 27 files deleted (27036 blocks) %DIAGNOSE-I-DELLOG, deleting DECevent logicals %DIAGNOSE-I-REMOVE, removing added value package %DELETE-I-FILDEL, DIA$:[000000]FMG_ANA__DEF_RUL_LIB.KNL;1 deleted (543 blocks) %DELETE-I-FILDEL, DIA$:[000000]FMG_ANA__FAC_STATE_DB.KNL;1 deleted (705 blocks) %DELETE-I-FILDEL, DIA$:[000000]FMG_ANA__PRM_STATE_DB.KNL;1 deleted (705 blocks) %DELETE-I-FILDEL, DIA$:[000000]FMG_NOT__DEF_EXTERNAL_LIB.KNL;1 deleted (24 blocks) %DELETE-I-FILDEL, DIA$:[000000]FMG_NOT__DEF_MAIL_LIB.KNL;1 deleted (24 blocks) %DELETE-I-FILDEL, DIA$:[000000]FMG_NOT__DEF_RUL_LIB.KNL;1 deleted (828 blocks) %DELETE-I-TOTAL, 6 files deleted (2829 blocks) %DELETE-I-FILDEL, DIA$:[000000]DEC_4000.BIN;1 deleted (180 blocks) %DELETE-I-FILDEL, DIA$:[000000]DEC_7000.BIN;1 deleted (351 blocks) %DELETE-I-FILDEL, DIA$:[000000]DSA.BIN;1 deleted (642 blocks) %DELETE-I-FILDEL, DIA$:[000000]KDM70.BIN;1 deleted (120 blocks) %DELETE-I-FILDEL, DIA$:[000000]RFXX.BIN;1 deleted (306 blocks) %DELETE-I-TOTAL, 5 files deleted (1599 blocks) %DELETE-I-FILDEL, SYS$COMMON:[SYS$STARTUP]DECEVENT$SHUTDOWN.COM;1 deleted (6 blocks) %DELETE-I-FILDEL, DIA$:[MANAGER]DECEVENT$SICL_DISABLE.COM;1 deleted (3 blocks) %DELETE-I-FILDEL, DIA$:[MANAGER]DECEVENT$SICL_ENABLE.COM;1 3-4 Deinstalling the DECevent Utility deleted (42 blocks) %DELETE-I-FILDEL, DIA$:[MANAGER]DECEVENT_START.LOG;18 deleted (9 blocks) %DELETE-I-FILDEL, DIA$:[MANAGER]DECEVENT_START.TMPCOM;18 deleted (3 blocks) %DELETE-I-FILDEL, DIA$:[MANAGER]DIA_ACTIVITY.LOG;18 deleted (3 blocks) %DELETE-I-FILDEL, DIA$:[MANAGER]FMG_LOCAL_PARAM_LIBRARY.KNL;1 deleted (99 blocks) %DELETE-I-TOTAL, 40 files deleted (363 blocks) %DELETE-I-FILDEL, DIA$:[000000]MANAGER.DIR;1 deleted (3 blocks) %DELETE-I-FILDEL, SYS$SPECIFIC:[000000]DIA$TOOLS.DIR;1 deleted (3 blocks) %UAF-I-REMMSG, record removed from system authorization file %UAF-I-RDBREMMSGU, identifier DIA$MANAGER value [000375,000300] removed from rights database %UAF-I-DONEMSG, system authorization file modified %UAF-I-NAFNOMODS, no modifications made to network proxy database %UAF-I-RDBDONEMSG, rights database modified %DIAGNOSE-I-SUCCESS, Successful deinstalled of DECevent at 7-FEB-1995 14:08:55.49 * PLEASE RE-LOGIN TO USE NEW DCLTABLES * Manually delete DECEVENT$DEINSTALL.COM from SYS$MANAGER Remember to manually delete DECEVENT$DEINSTALL.COM from SYS$MANAGER using the following command: $ DELETE SYS$MANAGER:DECEVENT$DEINSTALL.COM; Deinstalling the DECevent Utility 3-5 Chapter 4 Updating Knowledge Libraries for Device Support 4.1 Introduction DECevent knowledge libraries contain the necessary informa- tion about devices supported by DECevent enabling translation, reporting and analysis on those devices. DECevent allows you to update knowledge libraries by installing a .KNL (knowledge library) update kit. This chapter shows an example of a .KNL update kit installation. 4.2 KNL Update Example Before updating knowledge libraries, ensure that the DIA$ logicals are defined on your system by issuing the following command. $ SHOW LOGICAL DIA$* The system responds with the following display. "DIA$" = "DISK:[SYS0.DIA$TOOLS.]" "DIA$DAT" = "DIA$:[000000]" "DIA$EXE" = "DIA$:[000000]" "DIA$LIBRARY" = "DIA$:[000000]" "DIA$LOGS" = "DIA$:[000000]" "DIA$MGR" = "DIA$:[MANAGER]" If the DIA$ logicals are not defined as per the above dis- play, execute the DECevent start up procedure by issuing the following: $ @SYS$STARTUP:DECEVENT$STARTUP Continue the .KNL installation by entering the @sys$update:vmsinstal command at the system prompt, as shown below. The system re- sponds with information relevant to the installation procedure. Updating Knowledge Libraries for Device Support 4-1 VETTE> @sys$update:vmsinstal OpenVMS VAX Software Product Installation Procedure V6.2 It is 14-DEC-1996 at 10:45. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: DKA300:[GARCIA.KITS] Enter the products to be processed from the first distribution volume set. Enter the name of the KNL update kit, in this case DIAKNL01_ VMSVAX_023, you wish to install. * Products: DIAKNL01_VMSVAX_023 * Enter installation options you wish to use (none): The following products will be processed: DIAKNL01_VMSVAX_ V2.4 Beginning installation of DIAKNL01_VMSVAX_ V2.4 at 10:47 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Checking for DECevent V2.2 or higher installed. This kit will place the files named DECEVENT$024_RELEASE_NOTES.PS and in DECEVENT$024_RELEASE_NOTES.TXT in SYS$HELP. These files summarizing the new features, changes, restrictions, and compatibility issues for this release of DECevent. This file contains information valuable to DECevent users. Please inform your user community of the existence of these files. * Do you want to purge files replaced by this installation [YES]? * Start automatic analysis upon completion of this installation [Y]? Shutting down automatic analysis if it is running. DECevent V2.4 The optional, licensed, software to perform analysis and/or notification is enabled. Copyright (c) Digital Equipment Corporation, All Rights Reserved. 4-2 Updating Knowledge Libraries for Device Support This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation ("DIGITAL"). This software has been installed and enabled to enhance the maintenance services provided by DIGITAL. Use of this software by anyone other than DIGITAL maintenance personnel is not permitted without a license. Customers who have signed a DIGITAL Service Agreement ("Agreement") have been granted such a license for their own use on equipment covered by the Agreement. Any other use, copying or license to any other party whatsoever is not permitted. DIGITAL reserves the right to remove or disable this software at its discretion. U.S. Pat. 5,469,463. You have answered all of the questions for this installation. The installation takes 3 to 15 minutes to complete depending on your configuration. No more questions will be asked. %VMSINSTAL-I-RESTORE, Restoring product save set B ... File 'vmi$specific:[dia$tools]fmg_ana__prm_state_db.knl' is already a Version 3.x KNL Your VMS system will now be modified to include the following files: SYS$HELP:DECEVENTKNL$023_RELEASE_NOTES.PS SYS$HELP:DECEVENTKNL$023_RELEASE_NOTES.TXT DIA$EXE:FMG_CTR__DEF_RUL_LIB.KNL DIA$EXE:FMG_ETC__DEF_RUL_LIB.KNL DIA$EXE:FMG_ANA__DEF_RUL_LIB.KNL DIA$EXE:FMG_ANA__FAC_STATE_DB.KNL DIA$EXE:FMG_ANA__PRM_STATE_DB.KNL DIA$EXE:AXP_SYS12_EV5.BIN DIA$EXE:AXP_SYS17_EV4.BIN DIA$EXE:AXP_SYS27_EV45.BIN DIA$EXE:AXP_SYS9_EV4.BIN DIA$EXE:AXP_SYS9_EV5.BIN DIA$EXE:DEC_4000.BIN DIA$EXE:DEC_7000.BIN DIA$EXE:KDM70.BIN DIA$EXE:DSA.BIN DIA$EXE:HSAC.BIN %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Starting automatic analysis" %RUN-S-PROC_ID, identification of created process is 00000539 ************************************************************************ Executing the DECevent Installation Verification Procedure (IVP) ************************************************************************ Updating Knowledge Libraries for Device Support 4-3 At this point in the KNL update, the DECevent Installation Verification Procedure (IVP) is run to ensure successful bit- to-text translation, to ensure a Product Authorization Key (PAK) is installed to support analysis, to ensure proper set- tings for DECevent, and to ensure proper parameters are set, if a PAK is installed, for DECevent to function correctly. The IVP is shown in Chapter 2 and will not be shown here. Installation of DIAKNL01_VMSVAX_ V2.4 completed at 10:58 Enter the products to be processed from the next distribution volume set. * Products: Press Return at the * Products prompt to install only the KNL update kit VMSINSTAL procedure done at 10:58 The KNL update kit installation is now complete. 4-4 Updating Knowledge Libraries for Device Support Appendix A Command Summary for System Managers This appendix contains a table summarizing DECevent command procedures and commands that a system manager may need to know during the installation and post installation procedures of DECevent. Table_A-1:_Commands_Related_to_Installation____________________ Command_________________________Summary________________________ @SYS$UPDATE:VMSINSTALL vmsinstall for DECevent starts the installation of the DECevent event manage- ment software. A file named DECEVENT$V11_RELEASE_NOTES.PS is placed in SYS$HELP sum- marizing the new features, changes, restrictions, and compatibility issues for this release of DECevent. @SYS$STARTUP:DECEVENT$DEINSTALL.COM This command procedure per- manently removes the DECevent image from your system. Refer to Chapter 3 for an expla- nation on how to run this procedure. @SYS$HELP:DECEVENT$UPDATE_ HELP.COM Command Summary for System Managers A-1 Table_A-1_(Cont.):_Commands_Related_to_Installation____________ Command_________________________Summary________________________ This command procedure is run as part of the post in- stallation procedure if the system help library could not be updated during the in- stallation of DECevent. You must wait until no users are using the help facility be- fore re-running this command procedure. @SYS$STARTUP:DECEVENT$STARTUP.COM This command procedure con- tains commands to be ex- ecuted at system startup. You must add this command to to your system's site specific startup procedure, SYS$STARTUP:SYSTARTUP_VMS.COM, as part of the post installa- tion procedures. @SYS$STARTUP:DECEVENT$SHUTDOWN.COM This file contains commands to be executed when the sys- tem is to be shutdown. You must add this command to your systems's site spe- cific shutdown procedure, SYS$STARTUP:SYSHUTDWN.COM, as part of the post installation procedures. DELETE SYS$LOGIN:FMG_LOCAL_ PARAM_LIBRARY.KNL Users must delete this file if found in their SYS$LOGIN directory. DECevent recreates this file in its own format upon completion of the in- stallation. Failure to delete this file causes DECevent to perform incorrectly. DELETE SYS$MANAGER:DECEVENTDEINSTALL.COM A-2 Command Summary for System Managers Table_A-1_(Cont.):_Commands_Related_to_Installation____________ Command_________________________Summary________________________ You must manually delete this command procedure from SYS$MANAGER at the end of the deinstallation procedure. @DIA$MGR:DECEVENT$SICL_ ENABLE.COM This command procedure is used to enable the System Initiated Call Logging (SICL) capabilities. It requires access to the SYS$STARTUP:DECEVENT$STARTUP.COM file and the SYSNAM privilege. @DIAMGR:DECEVENT$SICL_ DISABLE.COM This command procedure is used to disable the System Initiated Call Logging (SICL) capabilities. It requires access to the SYS$STARTUP:DECEVENT$STARTUP.COM file and the SYSNAM privilege. DIAGNOSE STARTUP STRIKE This command is another method of enabling the au- tomatic analysis option of DECevent, although the pre- ferred method is to issue the @SYS$STARTUP:DECEVENT$STARTUP.COM command procedure. Command Summary for System Managers A-3 Table A-1 (Cont.): Commands Related to Installation DIAGNOSE SHUTDOWN STRIKE This command is another method of disabling the au- tomatic analysis option of DECevent, although the pre- ferred method is to issue the @SYS$STARTUP:DECEVENT$SHUTDOWN.COM command procedure. One or the other command must be per- formed prior to deinstalling ________________________________DECevent.______________________ A-4 Command Summary for System Managers