DECdecision___________________________________ Installation and System Management Guide Order Number: AA-ML41C-TE September 1991 DECdecision is a decision-support environment with database, spreadsheet, and charting components, and an application tape recorder. This guide describes how to install and maintain DECdecision on a VMS system. Operating System and Version: VMS Version 5.4 or higher Software Version: DECdecision Version 1.5 Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ September 1991 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. © Digital Equipment Corporation 1991. All Rights Reserved. The postpaid Reader's Comments forms at the end of this document request your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: CDA, DATATRIEVE, DDIF, DECalc, DECchart, DECdecision, DECpresent, DECquery, DECwindows, DECwrite, DTIF, DX, LiveLink, RdbAccess for VAX RMS, Rdb/VMS, TEAMDATA, ULTRIX, VAX, VAX RMS, VIDA, VMS, and the DIGITAL logo. ZK5589 This document is available on CDROM. This document was prepared using VAX DOCUMENT, Version 1.2 ________________________________________________________________ Contents Preface.................................................. vii 1 Preparing for Installation 1.1 Checking the Distribution Kit................ 1-2 1.2 Prerequisite Hardware........................ 1-2 1.3 Prerequisite Software........................ 1-3 1.4 Required Operating System Components......... 1-3 1.5 Registering Your License..................... 1-4 1.6 DECdecision Directories...................... 1-4 1.7 VAXcluster Considerations.................... 1-5 1.8 Preparing Your System and the Installing Account...................................... 1-6 1.8.1 Checking Privileges of the Installing Account.................................. 1-6 1.8.2 Checking Quotas of the Installing Account.................................. 1-6 1.8.3 System Disk Space Requirements........... 1-8 1.8.4 User Disk Space Requirements............. 1-9 1.8.5 System Parameter Values.................. 1-9 1.8.5.1 Checking Parameter Values.............. 1-10 1.8.5.2 Calculating GBLPAGES and GBLSECTIONS Parameter Values....................... 1-11 1.8.5.3 Changing Parameter Values with AUTOGEN. 1-11 1.9 Make Sure Rdb/VMS is Running................. 1-12 1.10 Backing Up Your System Disk.................. 1-12 1.11 Determining and Reporting Problems........... 1-12 1.12 Pre-Installation Check List.................. 1-13 iii 2 Installing DECdecision 2.1 Installation Overview........................ 2-1 2.2 Running the VMSINSTAL Command Procedure...... 2-2 3 Post-Installation Procedures 3.1 Editing System Startup and Shutdown Files.... 3-1 3.2 Activating DECdecision on a VAXcluster....... 3-2 3.3 Revoking SCHEMA Privileges from Existing DECdecision Version 1.1 Databases............ 3-2 3.4 Updating the DECquery Examples Folder........ 3-4 3.5 User Account Requirements.................... 3-4 3.5.1 User Account Privileges.................. 3-4 3.5.2 User Account Quotas...................... 3-5 3.6 Rebooting the System......................... 3-6 3.7 Running the Installation Verification Procedure Separately......................... 3-6 3.8 Running DECdecision.......................... 3-6 3.9 Post-Installation Check List................. 3-8 4 Managing Your DECdecision Environment 4.1 Performance Considerations................... 4-1 4.1.1 Working Set Values....................... 4-2 4.1.2 Global Pages and Global Sections......... 4-2 4.2 Managing DECquery Files and Databases........ 4-3 4.2.1 Using DECdecision with DATATRIEVE Domains.................................. 4-4 4.2.2 Granting Database Access to Users on Other Systems............................ 4-4 4.3 DECdecision Fatal Errors .................... 4-5 4.4 Using Logical Names with DECdecision......... 4-5 A Sample DECdecision Installation iv B Sample DECdecision Upgrade from a Previous Version C DECdecision Files Index Tables 1-1 DECdecision Directories.................. 1-5 1-2 Minimum Installing Account Quotas........ 1-6 1-3 Disk Requirements........................ 1-8 1-4 Required Minimum System Parameter Values. 1-9 1-5 Pre-Installation Check List.............. 1-13 2-1 DECchart Component Installation.......... 2-2 2-2 DECdecision Save Set Contents............ 2-2 3-1 Minimum User Account Quotas ............. 3-5 3-2 Post-Installation Check List............. 3-8 v ________________________________________________________________ Preface DECdecision is a decision-support environment with database, spreadsheet, and charting components, and an application tape recorder. Purpose of This Guide This guide describes how to install and maintain DECdecision on the VMS operating system. You should review the entire guide before you start the installation. Who Should Use This Guide This guide is for VMS system managers or others re- sponsible for installing system software. To install the DECdecision software, you must have access to a privileged account such as the SYSTEM account, and you must be familiar with the VMS installation procedure, VMSINSTAL.COM. Structure of This Guide The guide has four chapters and three appendixes. Chapter 1 describes installation prerequisites and pre-installation procedures. Chapter 2 describes the installation procedure. Chapter 3 describes required post- installation procedures. Chapter 4 provides information about managing your DECdecision environment. Appendix A shows a sample printout of a first-time installation. Appendix B shows a sample printout of an upgrade from DECdecision Version 1.1 to Version 1.5. Appendix C shows the files vii that are transferred to your system when you install DECdecision. For More Information Refer to the following documentation for more information about DECdecision: o DECdecision Overview-provides a tutorial and general information on using DECdecision o Component online help-provides a full set of informa- tion about using a component o DECdecision Calc Macro Guide-describes how to use the Calc Macro Language o DECdecision Release Notes-describes problems and workarounds for this version of DECdecision For more information about DECwindows, see the VMS DECwindows User's Guide. For more information about the VMSINSTAL command procedure, see one of the following manuals: o VMS System Manager's Manual, in the VMS base documenta- tion set o Guide to Setting Up a VMS System, in the VMS system management kit Conventions The following conventions are used in this guide: In procedures, key names are shown enclosed to indicate that you press a key on the keyboard. A sequence such as indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. viii () In format descriptions, parentheses indicate that, if you choose more than one option, you must enclose the choices in parentheses. [] In format descriptions, brackets indicate that whatever is enclosed is optional; you can select none, one, or all of the choices. {} In format descriptions, braces surround a required choice of options; you must choose one of the options listed. user input Blue-green ink indicates information that you must enter from the keyboard or a screen object that you must choose or click on. In the Bookreader, information you must enter from the keyboard is indicated by boldface text. italic text Italic text represents information that can vary in system messages (for example, Internal error number). UPPERCASE TEXT Uppercase letters indicate that you must enter a command (for example, enter OPEN /READ). Uppercase letters also indicate the name of a routine, the name of a file, the name of a file protection code, or the abbreviation of a system privilege. DECdecision The term DECdecision refers to the DECdecision[TM] software. DECchart The term DECchart refers to the DECchart[TM] software. DECquery The term DECquery refers to the DECquery[TM] software. ix 1 ________________________________________________________________ Preparing for Installation This chapter describes tasks that you must complete before installing DECdecision. Installing DECdecision is similar to installing other VMS layered products. You must do the following: o Take an inventory of the software distribution kit. o Make sure that your system has the prerequisite hardware, and that it has enough memory and available disk space to install and run DECdecision. o Make sure that your system has the required VMS operating system components and the prerequisite software. o If you are installing on a VAXcluster, decide how best to install DECdecision, depending on your configuration. o Register and load your DECdecision license. o Check that the account you use to install the software has the required privileges and quotas. o Decide what values your VMS system parameters should have. o Back up your system disk. o Advise your users when the installation will take place and how long it will take. The full installation takes approximately 45 minutes on a VAX 3900 system. Your time may vary depending on your system configuration and the type of installation media. Preparing for Installation 1-1 Preparing for Installation Once you have prepared your system, you can then perform the installation procedure as described in Chapter 2, and any necessary post-installation procedures as described in Chapter 3. 1.1 Checking the Distribution Kit Each DECdecision distribution kit contains: o A bill of materials (BOM) and indented bills report (BIL) o The distribution medium for the DECdecision software o Documentation for the product Media Only kits include just the installation guide. o The software license If you are upgrading from a previous version of DECdecision, you do not receive a new license. Your current license is still valid. To ensure that you have a complete kit, check the kit contents against the bill of materials and the indented bills report. Check also that you received the correct distribution medium, labeled as DECdecision Version 1.5. If your kit is damaged or parts of it are missing, contact your Digital representative. 1.2 Prerequisite Hardware DECdecision runs on all hardware configurations supported by VMS DECwindows Motif Version 1.0 with 8 MB or greater of memory. For more information, refer to your Software Product Description and your System Support Addendum. 1-2 Preparing for Installation Preparing for Installation 1.3 Prerequisite Software To install DECdecision, you must have: 1. A valid VMS operating system configuration running VMS Version 5.4 or higher and VMS DECwindows Motif Version 1.0. 2. Your DECdecision software license registered. See Section 1.5 for more information. 3. One of the following Rdb/VMS kits: _ Rdb/VMS Full Development Kit Version 3.0 or higher _ Rdb/VMS Interactive Kit Version 3.0 or higher _ Rdb/VMS Run-Time Kit Version 3.0 or higher ________________________Note ________________________ Previous versions of DECdecision also included the Rdb/VMS Run-Time Kit. This is no longer true for DECdecision V1.5. Before installing DECdecision, you must install the prerequisite version of Rdb/VMS. _____________________________________________________ For more information, refer to your Software Product Description and your System Support Addendum. 1.4 Required Operating System Components DECdecision requires the following VMS Version 5.4 components: o VMS required files (BASE) o Network support (NETWORK) o Programming support (PROG) o Secure user's environment (USER) o Utilities (UTIL) If your system does not meet these requirements, the installation will fail. You must install the required software using VMSTAILOR before performing the DECdecision installation. Preparing for Installation 1-3 Preparing for Installation 1.5 Registering Your License You must register and load your DECdecision software license. The information you need is in the Product Authorization Key (PAK) shipped with the product. The PAK is a paper certificate that contains data about your license. You should register the license before you install DECdecision. If you do not, the Installation Verification Procedure (IVP) will fail. To register the license for the initial installation, first log in to a privileged account such as the system manager's account, SYSTEM. Then use the License Management Facility to perform the registration, choosing one of the following procedures (the second method is faster for experienced users): o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When prompted for information, respond with data from your Product Authorization Key (PAK). o Issue the DCL command LICENSE REGISTER with the appropriate qualifiers that correspond to information on the PAK. If you plan to use DECdecision on more than one node in a VAXcluster, you must perform a LICENSE LOAD on the other nodes after you complete this installation. See Section 3.2 for more information. For complete information on using the License Management Facility, see your VMS documentation set. 1.6 DECdecision Directories During the installation, DECdecision creates the default root directory SYS$COMMON:[DECISION], plus a subdirectory for each component. Table 1-1 lists the directories and their logical names. 1-4 Preparing for Installation Preparing for Installation Table_1-1_DECdecision_Directories_______________________________ Component_Directory__________________Logical_Name_______________ DECdecisioSYS$COMMON:[DECISION] DECISION$LIBRARY DECquery SYS$COMMON:[DECISION.ACCESSDECISION$ACCESS_LIBRARY Builder SYS$COMMON:[DECISION.BUILDEDECISION$BUILDER_LIBRARY Calc SYS$COMMON:[DECISION.ECALC]DECISION$ECALC_LIBRARY DECchart SYS$COMMON: CHART$EXAMPLES __________[SYSHLP.EXAMPLES.DECCHART]____________________________ 1.7 VAXcluster Considerations You can install DECdecision on a VAXcluster. In a common-environment VAXcluster, you can install DECdecision on the VAXcluster boot node. This allows more than one VAX processor to share the same DECdecision software. In a multiple-system VAXcluster, you can install DECdecision on each system disk in the cluster. You must make sure that each node where you plan to install or run DECdecision meets the minimum system parameter value requirements. See Section 1.8.5 for a list of required system parameter values. After you install DECdecision, you must run the DECdecision startup command procedure (SYS$STARTUP:DECISION$STARTUP.COM) and load the software license on every cluster node where you want to run DECdecision. See Section 3.1 and Section 3.2 for more information. Preparing for Installation 1-5 Preparing for Installation 1.8 Preparing Your System and the Installing Account This section tells you which characteristics of your system and installing account you need to check before you install DECdecision. These characteristics include: o Account privileges o Account quotas o Disk space requirements o System parameters You must adjust those characteristics that do not match the minimum values required for installing and running DECdecision. 1.8.1 Checking Privileges of the Installing Account The account you use to install DECdecision must have the user privilege SETPRV. As one of the first actions, the VMSINSTAL command procedure grants all privileges (except BYPASS) to the process that invokes it. This command succeeds only if the account has SETPRV. On most systems, the SYSTEM account has SETPRV and is used to install software. The procedures described in this installation guide refer to the SYSTEM account, but they are the same for any account with SETPRV. 1.8.2 Checking Quotas of the Installing Account The installing account must have sufficient quotas to perform the installation and run the Installation Verification Procedure (IVP). Table 1-2 summarizes the minimum account quotas required. Table_1-2_Minimum_Installing_Account_Quotas_______________ Account_Quota____Value_______Description__________________ ASTLM 100 AST queue limit BYTLM 30,000 Buffered I/O byte count limit (continued on next page) 1-6 Preparing for Installation Preparing for Installation Table_1-2_(Cont.)_Minimum_Installing_Account_Quotas_______ Account_Quota____Value_______Description__________________ ENQLM 2000 Lock queue limit FILLM 100 Open file limit MAXDETACH 0 Maximum number of detached processes PGFLQUO 20,000 Paging file limit PRCLM 1 Subprocess creation limit WSEXTENT 2048 Working set extent WSQUO____________512_________Working_set_quota____________ Account quotas are stored in the file SYSUAF.DAT. Use the VMS Authorize Utility to verify and change user account quotas. Follow these steps: 1. Set your directory to SYS$SYSTEM and then run AUTHORIZE as follows: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> 2. At the AUTHORIZE prompt (UAF>), use the SHOW command with an account name to check your account. For example: UAF> SHOW SMITH 3. To change a quota, use the MODIFY command at the UAF> prompt. The MODIFY command uses the following format: MODIFY account-name /quota-name=nnnn Preparing for Installation 1-7 Preparing for Installation For example, to change the FILLM quota to 100 for the SMITH account, then exit from the Authorize Utility, you would enter the following: UAF> MODIFY SMITH /FILLM=100 UAF> EXIT After you exit from the utility, the VMS system displays messages indicating whether 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 Guide to Setting Up a VMS System. 1.8.3 System Disk Space Requirements Your system must have sufficient disk storage space to accommodate the installation. Table 1-3 lists the required free disk blocks. Table_1-3_Disk_Requirements_______________________________ Free Blocks Required During Blocks Used After Installation_____Installation_____________________________ 38,000___________31,500___________________________________ Use the DCL command SHOW DEVICE to determine the number of free blocks that are available on the system disk, as follows: $ SHOW DEVICE SYS$SYSDEVICE If the disk does not have enough free blocks, delete unnecessary files to provide the space required. 1-8 Preparing for Installation Preparing for Installation 1.8.4 User Disk Space Requirements When a user runs the DECquery component for the first time, DECquery creates a default user database. The two files, named DECISION$ACCESS_DB.RDB and DECISION$ACCESS_ DB.SNP, require a total of 1692 free disk blocks. Over time, more disk space will be required as the user adds new tables to the database or creates new databases. 1.8.5 System Parameter Values Table 1-4 lists the minimum system parameter values required for DECdecision installation and use. If your parameters are higher, do not lower them. Other applications on your system may require higher values than these minimum values. On a VAXcluster, you must adjust not only the system parameters of nodes on which you install DECdecision, but also the nodes on which you intend to run DECdecision. Table_1-4_Required_Minimum_System_Parameter_Values________ System Parameter________Minimum_Value______________Type__________ CHANNELCNT A number larger than the largest FILLM used on the system. DECdecision requires a minimum FILLM of 100. See Table 3-1. CLISYMTBL[1] 500 Dynamic GBLPAGES 6,500 (unused global pages) GBLPAGFIL 2048 GBLSECTIONS 25 (unused global sections) [1]Required_only_for_installation_________________________ (continued on next page) Preparing for Installation 1-9 Preparing for Installation Table 1-4 (Cont.) Required Minimum System Parameter __________________Values__________________________________ System Parameter________Minimum_Value______________Type__________ LOCKIDTBL 256 LOCKIDTBL_MAX 2048 Dynamic MAXBUF 1584 Dynamic PQL_DBYTLM 20,000 Dynamic PROCSECTCNT 64 RESHASHTBL 512 SRPCOUNT 1024 SRPCOUNTV 2048 VIRTUALPAGECNT___20,000___________________________________ 1.8.5.1 Checking Parameter Values To check the value of a system parameter, enter the following command at the DCL prompt: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN> prompt, use the SHOW command to display the value of each system parameter. The value displayed in the Current column should equal or exceed the value of each parameter listed in Table 1-4. For example, the following command displays the value for the MAXBUF system parameter: SYSGEN> SHOW MAXBUF After you finish checking parameter values, use the EXIT command to return to DCL level. 1-10 Preparing for Installation Preparing for Installation 1.8.5.2 Calculating GBLPAGES and GBLSECTIONS Parameter Values The values for GBLPAGES and GBLSECTIONS in Table 1-4 indicate that you must have at least 6,500 unused global pages and 25 unused global sections available for the installation. To calculate the number of unused global pages and global sections on your system, perform these steps: 1. Use the DCL F$GETSYI lexical function to determine the number of free global pages and global sections: $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 2. If the number of unused global pages or global sections is less than the number specified in Table 1-4, you must increase the value using the AUTOGEN command procedure, as shown in Section 1.8.5.3. 1.8.5.3 Changing Parameter Values with AUTOGEN Use the AUTOGEN command procedure to change system parameters. To change system parameters with AUTOGEN: 1. Edit the following file: SYS$SYSTEM:MODPARAMS.DAT For example, to increase the setting for the GBLPAGES system parameter by 2000, add this line to the file: ADD_GBLPAGES = 2000 2. Run the AUTOGEN procedure to recalculate your system parameters and reboot the system. Enter the following command at the DCL prompt: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT When you specify REBOOT, AUTOGEN performs an automatic system shutdown and reboot. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect. Preparing for Installation 1-11 Preparing for Installation AUTOGEN automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK parameter on the AUTOGEN command line as well. For example: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT NOFEEDBACK For more information about using AUTOGEN, see the instructions on modifying system parameters in the Guide to Setting Up a VMS System. 1.9 Make Sure Rdb/VMS is Running Make sure Rdb/VMS is running before installing DECdecision. If Rdb/VMS is not running, the installation procedure cannot restore the DECdecision sample databases. To start Rdb/VMS, use the following DCL command: $ @SYS$STARTUP:RMONSTART.COM 1.10 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. If a system failure occurs at a critical point during the installation, some of the files could be corrupted. Therefore, you should back up your system disk before attempting any software installation. For more information on backing up your system disk, see the section on the Backup Utility in the Guide to Maintaining a VMS System. 1.11 Determining and Reporting Problems If you encounter a problem while using DECdecision, report it to Digital. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call Digital if your software contract or warranty agreement entitles you to telephone support. 1-12 Preparing for Installation Preparing for Installation o Submit a Software Performance Report (SPR). o Fill out and submit a Reader's Comments form if the problem has to do with the DECdecision documentation. There are Reader's Comments forms at the back of each manual. Use the form from the manual in which you found the error. Include the section number and page number. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of your warranty. If you encounter a problem during the warranty period, report the problem as indicated above or follow alternate instructions provided by Digital for reporting SPD nonconformance problems. 1.12 Pre-Installation Check List Table 1-5 summarizes the tasks you must perform before installing DECdecision. Check to make sure that you have performed all these tasks before proceeding with the installation. Table_1-5_Pre-Installation_Check_List_____________________ Task____________________________For_More_Information______ Check that you have the See Section 1.2 and prerequisite hardware and Section 1.3 software Register and load your license See Section 1.5 Check privileges and quotas of See Section 1.8.1 and the installing account Section 1.8.2 Check that you have enough See Section 1.8.3 disk space Check system parameters See Section 1.8.5 Make sure Rdb/VMS is running See Section 1.9 Back_up_your_system_disk________See_Section_1.10__________ Preparing for Installation 1-13 2 ________________________________________________________________ Installing DECdecision This chapter describes the procedure for installing DECdecision and running the Installation Verification Procedure (IVP). Before you begin installing DECdecision, make sure that your system meets the requirements outlined in Chapter 1. The full installation takes approximately 45 minutes on a VAX 3900 system. Your time may vary depending on the configuration of your system, the choices you make during the installation, and the type of media you use. 2.1 Installation Overview There are two varieties of DECdecision installation: o Installing DECdecision for the first time Appendix A shows a first-time installation. o Upgrading from a previous version of DECdecision Appendix B shows an installation upgrade from DECdecision Version 1.1 to Version 1.5. During each installation, DECdecision checks to see if your system has the correct version of the DECchart component. If the DECchart component is out of date or missing, then DECdecision installs the correct version. If the correct version of DECchart is already on the system, DECdecision does not replace it. Table 2-1 explains how the DECdecision installation deals with different versions of the DECchart component. Table 2-2 shows which save sets contain the files for the DECdecision and DECchart components. Installing DECdecision 2-1 Installing DECdecision Table_2-1_DECchart_Component_Installation_________________ Current DECchart Version_______________DECdecision_Installation_Action_____ None Installs DECchart Version 1.5. DECchart Version 1.0 Prints a message and asks if you or 1.1 want to proceed. If you answer YES, it installs DECchart Version 1.5. DECchart Version 1.5 Prints a message and asks if you want to re-install DECchart Version 1.5. However, should a higher version exist in the future, DECdecision will not replace it. (Currently DECchart Version 1.5 is ______________________the_highest_version.)_______________ Table_2-2_DECdecision_Save_Set_Contents___________________ Component___Save_Sets_____________________________________ DECdecision A,D,F DECchart____B,C,E_________________________________________ 2.2 Running the VMSINSTAL Command Procedure Use the VMSINSTAL command procedure to install DECdecision. For more information about VMSINSTAL, refer to the following books in your VMS documentation set: o VMS System Manager's Manual, in the VMS base documenta- tion set o Guide to Setting Up a VMS System, in the VMS system management subkit If VMSINSTAL detects a problem during the installation procedure, it notifies you and asks if you want to continue. To stop the installation and correct the problem, enter NO or press RETURN. After you have made the correction, you can restart the installation. 2-2 Installing DECdecision Installing DECdecision To stop the installation procedure at any time, press Ctrl/Y. The installation procedure deletes all the files it has created up to that point and exits. You can then restart the installation. Installing DECdecision 2-3 Installing DECdecision Follow these steps to install DECdecision: 1. Log in to the SYSTEM account. Log in at the operator's console terminal under the system manager's account, SYSTEM. 2. Notify the users. Send a message requesting that all users log out. Use the DCL REPLY command to inform users of the schedule for the installation. Use the SET LOGINS command to prevent others from logging in: $ REPLY/USER "Installation starting in 5 minutes. Please log out." $ SET LOGINS/INTERACTIVE=0 3. Invoke VMSINSTAL. Enter the following command line to run VMSINSTAL.COM: $ @SYS$UPDATE:VMSINSTAL DECISION015 ddcu: OPTIONS N where: o @SYS$UPDATE:VMSINSTAL invokes VMSINSTAL o DECISION015 is the save set name for the DECdecision software o ddcu: is the device specification for the distribu- tion medium, for example, MUA0: o OPTIONS N is an optional parameter indicating that you want to see the Release Notes question. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the Release Notes. Digital recommends that you review the Release Notes before proceeding with the installation. After you invoke VMSINSTAL, you see the following message: VAX/VMS Software Product Installation Procedure V5.4 It is 21-AUG-1991 at 09:17 Enter a question mark (?) at any time for help. 4. Answer the backup question. 2-4 Installing DECdecision Installing DECdecision The installation procedure asks if you have backed up your system disk: * Are you satisfied with the backup of your system disk [YES]? If you have not backed up your system disk, you should not continue with the installation until you do so. If you need to back up the system disk, enter NO. VMSINSTAL exits and returns you to the DCL prompt. Back up your system disk, and then start VMSINSTAL again. If you have already backed up the system disk, press RETURN to continue. 5. Mount the media. You receive instructions to mount the distribution medium on the device you specified when you invoked VMSINSTAL (MUA0: in this example): Please mount the first volume of the set on MUA0:. * Are you ready? Mount the distribution medium and enter YES to indicate that you are ready to continue. The following messages appear on your terminal: %MOUNT-I-MOUNTED, DECIS mounted on _MUA0: The following products will be processed: DECISION V1.5 Beginning installation of DECISION V1.5 at 09:17 %VMSINSTAL-I-RESTORE, Restoring product save set A... 6. Print and read the Release Notes. If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the four options for reviewing the Release Notes: Installing DECdecision 2-5 Installing DECdecision 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]: Review the Release Notes in case they contain any information about changes in the installation procedures. Selecting option 2 prints a copy of the Release Notes. You are prompted for a print queue: * Queue name [SYS$PRINT]: Press RETURN to print the Release Notes on SYS$PRINT, or type a different queue name and press RETURN. You receive a message similar to the following: Job 810 (queue SYS$PRINT, entry 1295) started on SYS$PRINT If you selected options 1 or 3, the Release Notes are displayed. 2-6 Installing DECdecision Installing DECdecision 7. Decide whether or not to continue. The installation procedure asks if you want to continue: * Do you want to continue the installation? [NO]? %VMSINSTAL-I-RELMOVED, The product's release notes have been moved to SYS$HELP. Enter YES to continue. Otherwise, press RETURN. In either case, the Release Notes are moved to the SYS$HELP directory. The Release Notes are contained in the following file, which you may read or print later: SYS$HELP:DECISION015.RELEASE_NOTES. You then see the following message: ************************************************************ * * * DECdecision V1.5 * * Integrated Decision Support Package * * * * Installation Procedure * * * ************************************************************ At this point, the installation procedure checks to make sure your system is running the minimum required version of VMS. If your system does not meet the minimum requirements, the installation procedure issues an error message and then exits. 8. Answer the license registration question. The installation procedure asks if you have registered a DECdecision product authorization key, using the License Management Facility (LMF): Product: DECDECISION-USER Producer: DEC Version: 1.5 Release Date: 30-AUG-1991 * Does this product have an authorization key registered and loaded? Installing DECdecision 2-7 Installing DECdecision You must have registered and loaded the product authorization key or the Installation Verification Procedure (IVP) will fail. Enter YES if your PAK is registered and loaded. If you enter NO, the installation procedure warns you that the IVP will fail. The installation then proceeds. See Section 1.5 for information about registering your product authorization key. 2-8 Installing DECdecision Installing DECdecision 9. Read messages. The following messages display: Checking user parameters Checking system parameters Testing dependent product versions %VMSINSTAL-I-RESTORE, Restoring product save set B ... At this point, the installation procedure checks to make sure your system is running the minimum required version of VMS DECwindows Motif. If your system does not meet the minimum requirements, the installation procedure issues the following error message and then exits: %VMSINSTAL-E-BADDW, This kit requires VMS DECwindows Motif V1.0 or later to install 10.Answer the DECchart upgrade question. DECdecision installs DECchart Version 1.5. The following messages display if your system has an earlier version of DECchart: This kit requires DECchart V1.5 or later ********************************************************** DECchart V1.5 will be installed since an earlier version exists on your system. ********************************************************** * Do you want to proceed [YES]? Press RETURN to continue the installation. Your message may vary depending on whether you have DECchart installed and what version it is. If you have no version of DECchart currently installed on your system, you see the following message: Installing DECdecision 2-9 Installing DECdecision This kit requires DECchart V1.5 or later ********************************************************** DECchart V1.5 will be installed since it does not exist on your system. ********************************************************** See Table 2-1 for a description of the ways DECdecision handles the DECchart installation. 2-10 Installing DECdecision Installing DECdecision 11.Create the library directories. This question differs depending on whether you are installing DECdecision for the first time or upgrading from a previous version of DECdecision. The installation procedure asks where you would like to place the library root directories. o First time installation: The DECdecision product creates a tree of library directories. A subdirectory is created for each component. * Where would you like to place the DECISION V1.5 library root [SYS$COMMON:[DECISION]]: Press RETURN to create the default library, or you can specify another directory. The following messages display: %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECISION]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECISION.BUILDER]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECISION.ECALC]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECISION.ACCESS]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DECISION$IVP]. o Upgrade or re-installation: The directory DECISION$LIBRARY currently exists on your system. * Would you like to place the DECISION V1.5 library root there [YES]? Press RETURN to use the default library, or you can specify another directory. The following messages display: %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DECISION$IVP]. %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.DECISION$IVP] already exists Installing DECdecision 2-11 Installing DECdecision 12.Decide whether or not to upgrade the default user database. You see this question only if you are upgrading or reinstalling DECdecision. The installation procedure asks if you want to replace the default user database: DECdecision has a default database. This is copied to new user's accounts when they first use DECdecision. This database is installed in DECISION$ACCESS_LIBRARY Your system already has a default user database. * Do you want to replace it [NO]? If you have never modified your default user database, enter YES to replace it. If you have made modifica- tions, press RETURN. 13.Decide whether or not to run the IVP. The installation procedure asks if you want to run the Installation Verification Procedure (IVP): * Do you want to run the IVP after the installation [YES]? The DECdecision IVP checks to be sure the installation is successful. Digital recommends that you run the IVP. Press RETURN. 14.Specify an IVP display device. You must specify a workstation on which to display the IVP: The DECdecision IVP requires that a display device be defined (using the SET DISPLAY command). Please enter the node name of the workstation on which to display the IVP. * Enter node name (or Return to not run IVP): You must specify the node name of a workstation on which security is set up to allow display of the IVP. To ensure that your display is set up correctly, go to the Session Manager Options menu and select the Security option. When the list of authorized users displays, add the Node and Username of the system on which you are installing DECdecision. 2-12 Installing DECdecision Installing DECdecision For example, if you are installing DECdecision from the SYSTEM account on workstation node MYNODE, then you must add MYNODE::SYSTEM to the security database. If you have SET HOST 0 from your own account to use the SYSTEM account, then you must add 0::SYSTEM to the security database. See the DECwindows User's Guide for details on the Session Manager's security database. If you do not have a workstation available, you may press RETURN and the IVP will not be run. See Chapter 3 for directions on running the IVP after the installation. 15.Decide whether or not to purge files. The installation procedure asks if you want to purge (delete) old versions of files replaced by this installation: * Do you want to purge files replaced by this installation [YES]? Purging is recommended. Press RETURN to purge the old files. However, if you need to keep files from the previous version, enter NO. 16.Decide whether or not to continue. The installation procedure displays a time estimate and then asks if you want to continue: To complete the installation on a standalone VAX 11/780 will take approximately: 30 minutes to install 11 minutes to run the IVP All required questions have been asked. You can terminate the installation procedure at this time. * Do you want to continue the installation [YES]? Press RETURN to continue the installation. 17.Check informational messages. The installation procedure displays a series of messages as it performs the following installation tasks: o Restores files Installing DECdecision 2-13 Installing DECdecision o Reminds you to edit SYSTARTUP_V5.COM o Creates the DECchart directories o Transfers files to their directories o Installs the DECquery databases 2-14 Installing DECdecision Installing DECdecision %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... ************************************************************* SYSTEM MANAGER: The following command line MUST be added to the system startup command file SYS$MANAGER:SYSTARTUP_V5.COM for all nodes that will be running DECdecision: $ @SYS$STARTUP:DECISION$STARTUP.COM The following command line should be added to the system shutdown command file SYS$MANAGER:SYSHUTDWN.COM for all nodes that will be running DECdecision: $ @SYS$MANAGER:DECISION$SHUTDWN.COM ************************************************************* %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.CHART$IVP]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSHLP.EXAMPLES.DECCHART]. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories. ****************************************************************** * * * Installing Sample Database... * * * ****************************************************************** * * * Installing Default User Database... * * * ****************************************************************** * * * Installing Public Folder Database... * * * ****************************************************************** Installing DECdecision 2-15 Installing DECdecision 18.Run the DECdecision IVP. The installation procedure runs the DECdecision Installation Verification Procedure: Executing IVP for: DECdecision V1.5 The IVP runs a Builder BLUEPRINT which will run each component and produce intermediate reports and a final chart of the results. The reports and chart are compared with the expected values to determine if the IVP has completed successfully. Starting DECdecision... Comparing the results of the BLUEPRINT with the expected results ******************************** DECdecision V1.5 IVP COMPLETED SUCCESSFULLY ******************************** IVP completed for: DECdecision V1.5 19.End the installation procedure. The installation procedure ends automatically with the following messages: Installation of DECISION V1.5 completed at 10:30 VMSINSTAL procedure done at 10:30 20.Make the system available to users. After the installation completes successfully, you should reset system logins to your system default (64 in this example). Then send a message to all users stating that the system is again available. Use the following DCL commands: $ SET LOGINS/INTERACTIVE=64 $ REPLY/USER "Installation complete. System is ready for use." 2-16 Installing DECdecision 3 ________________________________________________________________ Post-Installation Procedures This chapter describes tasks that you must complete after DECdecision is installed. 3.1 Editing System Startup and Shutdown Files After the installation is complete, you must edit the system startup and shutdown files for all nodes that will be running DECdecision. Add the following line to your system startup file, SYS$MANAGER:SYSTARTUP_V5.COM, after the line that invokes the network startup command procedure: $ @SYS$STARTUP:DECISION$STARTUP.COM DECISION$STARTUP.COM also contains the commands to start Rdb/VMS. It runs the command procedures SYS$STARTUP:RMONSTART.COM and SYS$STARTUP:SQL$STARTUP.COM. ________________________Note ________________________ If your network startup command procedure runs in batch mode, you may experience a problem starting the SQL portion of Rdb/VMS. SQL$STARTUP.COM contains commands that run the Network Control Program (NCP). If NCP is not yet available when SQL$STARTUP.COM runs, the SQL startup will fail. You can fix the problem by inserting a DCL WAIT command (for example, $ WAIT 00:01 inserts a 1 minute pause) into SYSTARTUP_V5.COM immediately before the line that invokes DECISION$STARTUP.COM. _____________________________________________________ Post-Installation Procedures 3-1 Post-Installation Procedures Add the following line to your system shutdown file, SYS$MANAGER:SYSHUTDWN.COM: $ @SYS$MANAGER:DECISION$SHUTDWN.COM This file also contains the commands to shut down your Rdb/VMS monitor. 3.2 Activating DECdecision on a VAXcluster To activate DECdecision on any type of VAXcluster, you must first install DECdecision on each system disk that is commonly shared among nodes in the cluster. Then you must perform the following procedure to start DECdecision, replace the DCL tables, and load the license on all other nodes in the cluster: $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER/USER=SYSTEM Remote Password: supply SYSTEM password here SYSMAN> DO LICENSE LOAD DECDECISION-USER SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE SYSMAN> DO @SYS$STARTUP:DECISION$STARTUP SYSMAN> EXIT ________________________Note ________________________ If you are upgrading from a previous version of DECdecision, you do not need to load your license. Your current license is still loaded. _____________________________________________________ 3.3 Revoking SCHEMA Privileges from Existing DECdecision Version 1.1 Databases If you are upgrading from a previous version of DECdecision, you must perform this task. If you are installing DECdecision Version 1.5 for the first time, skip this section. In Rdb/VMS Version 4.0, several SCHEMA privileges have been changed to be role-oriented. These SCHEMA privileges (DBADM, OPERATOR, SECURITY) now override the protection on individual tables. This change affects DECdecision databases since two of these privileges 3-2 Post-Installation Procedures Post-Installation Procedures (DBADM and OPERATOR) are set on all DECdecision Version 1.1 databases. All DECdecision Version 1.1 databases are defined with the following protection: Protection on Schema RDB$DBHANDLE (IDENTIFIER=[SYSTEM,MANAGER],ACCESS=SELECT+INSERT+UPDATE+DELETE+SHOW+ CREATETAB+ALTER+DROP+DBCTRL+OPERATOR+DBADM) (IDENTIFIER=[*,*],ACCESS=SELECT+INSERT+UPDATE+DELETE+SHOW+CREATETAB+ALTER+ DROP+OPERATOR+DBADM) Since the SCHEMA privileges of DBADM and OPERATOR override the protections on the individual tables, any user has access to the individual tables contained in a DECdecision Version 1.1 database. If not already done when Rdb/VMS Version 4.0 was installed, it is recommended that these privileges (DBADM, OPERATOR) be revoked on all existing DECdecision Version 1.1 databases. This includes: o DECISION$ACCESS_LIBRARY:DECISION$ACCESS_SYSDB.RDB o DECISION$ACCESS_LIBRARY:DECISION$ACCESS_DEFDB.RDB o Each user's individual DECISION$ACCESS_DB.RDB The following example illustrates the steps required to revoke the privileges on the Public folder database using SQL. $ MCR SQL$ SQL> DECLARE DATABASE FILENAME DECISION$ACCESS_LIBRARY:DECISION$ACCESS_SYSDB.RDB; SQL> REVOKE DBADM, OPERATOR ON SCHEMA RDB$DBHANDLE FROM [*,*]; SQL> COMMIT; SQL> EXIT; ________________________Note ________________________ The user executing these steps must have [MANAGER,SYSTEM] UIC. _____________________________________________________ Post-Installation Procedures 3-3 Post-Installation Procedures The following example illustrates the steps required to revoke the privileges on the Public folder database using RDO. $ MCR RDO RDO> DATA FILE DECISION$ACCESS_LIBRARY:DECISION$ACCESS_SYSDB.RDB RDO> CHANGE PROTECTION FOR DATABASE [*,*] ACCESS "NOOPERATOR+NOADMINISTRATOR". RDO> COMMIT; RDO> EXIT; 3.4 Updating the DECquery Examples Folder DECquery contains an Examples folder with sample tables to illustrate the many uses of DECquery. Some of these tables are also used in the Builder guided blueprints. If you are upgrading from a previous version of DECdecision, you must add five additional tables to the DECquery Examples folder. If you are installing DECdecision Version 1.5 for the first time, skip this section. Follow these steps to update the DECquery Examples folder: 1. Log in to the SYSTEM account 2. Enter the following command: $ @DECISION$ACCESS_LIBRARY:DECISION$ACCESS_PUBLISH.COM 3.5 User Account Requirements DECdecision users must have certain account privileges and quotas. The following two sections contain information about these requirements. 3.5.1 User Account Privileges To use DECdecision, an account must have at least the TMPMBX and NETMBX privileges. Use the VMS Authorize Utility to determine if users have the privileges they require. See Section 1.8.2 for more information. 3-4 Post-Installation Procedures Post-Installation Procedures 3.5.2 User Account Quotas To use DECdecision, an account must have sufficient quotas. Table 3-1 summarizes the minimum required user account quotas. Table_3-1_Minimum_User_Account_Quotas_____________________ Account_Quota____Value_______Description__________________ ASTLM 100 AST queue limit BIOLM 10 Buffered I/O limit BYTLM[1] 30,000 Buffered I/O byte count limit DIOLM 10 Direct I/O limit ENQLM 2000 Lock queue limit FILLM 100 Open file limit MAXDETACH[2] 0 Maximum number of detached processes PGFLQUO 20,000 Paging file limit PRCLM 1 Subprocess creation limit WSEXTENT 2048 Working set extent WSQUO 512 Working set quota [1]Each_DECdecision_component_run_simultaneously_uses_____ 3000 of the total BYTLM. Setting BYTLM to 30,000 allows a user to run eight components at one time, with the remaining BYTLYM available for other processes. If a user wants to run more components at one time, increase BYTLM accordingly. [2]Each DECdecision component runs as a detached process. A MAXDETACH of n allows n components to be run, or you can set it to 0 for an unlimited number. __________________________________________________________ Post-Installation Procedures 3-5 Post-Installation Procedures To avoid running out of processes, you should maintain the default MAXDETACH process quota of 0 (that is, infinite). Because DECdecision retains application processes for re-use you could run out of processes unless an infinite number are available. Use the VMS Authorize Utility to verify and change user account quotas. See Section 1.8.2 for more information. 3.6 Rebooting the System You are not required to reboot the system to activate DECdecision. However, you may choose to reboot your system after you have installed DECdecision, edited the system startup and shutdown files, and reset the system parameters (if necessary). A system reboot establishes any new parameter settings and verifies that DECdecision is ready for use and that the edits to the system startup command file are correct. 3.7 Running the Installation Verification Procedure Separately If you answered YES to the IVP question during the DECdecision installation, the Installation Verification Procedure ran automatically at the end of the installa- tion. You received a message indicating whether the IVP succeeded or failed. You can also run the IVP separately. The account from which you run the IVP must have the same privileges and account quotas required to install DECdecision. See Section 1.8 for more information. To run the IVP, use the following DCL command: $ @SYS$TEST:DECISION$IVP 3.8 Running DECdecision As part of the installation, DECdecision adds its name to the Session Manager and FileView Applications menus. You should inform all users after the installation that DECdecision is now available as an option on these menus. 3-6 Post-Installation Procedures Post-Installation Procedures ________________________Note ________________________ On clusters with a multiple system disk environment, the Applications menu is customized only for the disk or disks on which DECdecision is installed. _____________________________________________________ Post-Installation Procedures 3-7 Post-Installation Procedures Users may also enter the following commands at the DCL prompt to use DECdecision and its components: o INFORM/QUERY or INFORM/ACCESS o INFORM/CALC o INFORM/CHART o INFORM/BUILDER For a full list of the DECdecision DCL commands and qualifiers, see the DECdecision Overview, or enter the following DCL command: $ HELP DECdecision 3.9 Post-Installation Check List Table 3-2 summarizes the tasks you must perform after installing DECdecision. Check to make sure that you have performed all these tasks before making DECdecision available to users. Table_3-2_Post-Installation_Check_List____________________ Task____________________________For_More_Information______ Edit system startup and See Section 3.1 shutdown files Activate DECdecision on a See Section 3.2 VAXcluster Revoke SCHEMA privileges from See Section 3.3 existing DECdecision Version 1.1 databases Update the DECquery Examples See Section 3.4 folder Check privileges and quotas of See Section 3.5 the_user_accounts_________________________________________ 3-8 Post-Installation Procedures 4 ________________________________________________________________ Managing Your DECdecision Environment This chapter gives suggestions for ways to best manage your DECdecision environment. 4.1 Performance Considerations The major factors to consider when supporting many DECdecision users are physical memory size and system parameter settings. Several process and system parameters can affect DECdecision performance. This section describes parameters that you can modify to improve performance. The following sections discuss these performance topics: o Working set values o Global pages and global sections ________________________Note ________________________ The quotas suggested in the following sections are minimum values. If you frequently perform operations such as accessing large tables, joining large tables, or importing and exporting large amounts of data, larger quotas might be necessary to enhance performance. _____________________________________________________ For additional information on VMS performance, see the Guide to VMS Performance Management. For information on the parameters and quotas required to run VAX Rdb/VMS and for information on tuning your Rdb/VMS database system, see the VAX Rdb/VMS Installation Guide and the VAX Rdb/VMS Guide to Database Maintenance and Performance. Managing Your DECdecision Environment 4-1 Managing Your DECdecision Environment 4.1.1 Working Set Values DECdecision requires large user working sets to run optimally. As a result, you should consider setting the following process account parameters to the indicated values: o WSDEFAULT = 512 o WSQUOTA = 1024 o WSEXTENT = 2048 to 8192 The SYSGEN parameter WSMAX must at least equal the largest value of any user's WSEXTENT account parameter. Specify a large value for WSEXTENT to minimize paging on the system. 4.1.2 Global Pages and Global Sections When run locally (for example, as a standalone workstation or as a satellite node on a VAXcluster), each invocation of a DECdecision component requires 300 additional global pages and 1 global section. You should have sufficient unused global pages and global sections to allow for this. In addition, DECquery requires additional global pages and global sections at run time. This is due to the fact that Rdb/VMS allocates a certain amount of memory for each open database. The number of additional global pages and global sections required depends on the number of DECquery users. To estimate the total number of unused global pages needed, calculate the sum of the following values: 1. The number of DECquery users, multiplied by 100 2. The number of unused global pages required to install DECdecision: 6,500 3. If you are running DECdecision locally, the maximum number of components that will be running simultane- ously, multiplied by 300 To estimate the total number of unused global sections needed, calculate the sum of the following values: 1. The number of DECquery users, multiplied by 2 2. The number of unused global sections required to install DECdecision: 25 4-2 Managing Your DECdecision Environment Managing Your DECdecision Environment 3. If you are running DECdecision locally, the maximum number of components that will be running simultane- ously, multiplied by 1 For example, assume your workstation is a satellite node on a Local Area VAXcluster. DECdecision is installed on the boot node. You typically run the DECquery, Calc, and Chart components at the same time. Your workstation requires these minimum unused global page and global section values: o Global pages _ 1 DECquery user multiplied by 100 = 100 _ 6,500 _ 3 components running simultaneously multiplied by 300 = 900 Total: 100 + 6,500 + 900 = 7,500 o Global sections _ 1 DECquery user multiplied by 2 = 2 _ 25 _ 3 components running simultaneously multiplied by 1 = 3 Total: 2 + 25 + 3 = 30 See Section 1.8.5 for information on the minimum parameter values required to run DECdecision. 4.2 Managing DECquery Files and Databases DECquery is built on Rdb/VMS, Digital's relational database management system. The next three sections provide specific information on the following DECquery database management topics: o Using DECdecision with DATATRIEVE domains o Granting database access to users on other systems See the DECquery online help for valuable DECquery database management information in these areas: o DECquery objects and logical names Managing Your DECdecision Environment 4-3 Managing Your DECdecision Environment o Migrating a DECquery database to another system o Accessing large Rdb/VMS relations from within DECquery o Giving users access to information o Giving users access to data stored in IBM systems o Protecting data For more information about Rdb/VMS, see the Rdb/VMS Guide to Database Administration. 4.2.1 Using DECdecision with DATATRIEVE Domains To work with DATATRIEVE domains, DECquery requires that either the file SYS$SHARE:DTRSHR.EXE exist on the system or that a logical name be defined to point to the appropriate DTR shareable image. Some systems have multiple versions of DATATRIEVE running at the same time. On these systems, instead of DTRSHR.EXE, there might be files such as DTRSHRV4.EXE. In this case, you should place the following line in SYSTARTUP_V5.COM to make this choice permanent: $ DEFINE/SYSTEM/EXEC DTRSHR SYS$SHARE:DTRSHRV4.EXE If you change SYSTARTUP_V5.COM to include this line, DECdecision uses DTRSHRV4.EXE when DECquery users work with DATATRIEVE domains. 4.2.2 Granting Database Access to Users on Other Systems If users on other systems are allowed to access databases stored on your system, the account associated with RDBSERVER must have at least the minimum quotas recom- mended for DECdecision user accounts. These quotas are listed in Table 3-1. To find out which account is associated with RDBSERVER, log in to a privileged account such as SYSTEM, and enter the following commands: $ RUN SYS$SYSTEM:NCP NCP> SHOW OBJECT RDBSERVER 4-4 Managing Your DECdecision Environment Managing Your DECdecision Environment NCP displays information about the account associated with RDBSERVER. If NCP does not display the information, then the DECnet account is the account used for remote access requests. In this case, the DECnet account should have the quotas listed in Table 3-1. Enter EXIT to leave NCP. 4.3 DECdecision Fatal Errors If a DECdecision component encounters an unexpected problem or an internal fatal error, your session terminates. When this occurs, each of the components acts in the following manner: o DECquery displays an error message and creates the dump file DECISION$ACCESS_BUGCHK.DMP. o Calc creates the dump file DECISION$CALC_BUGCHK.DMP. o DECchart displays an error message and creates the dump file DECCHART.DMP. o Builder displays an error message and creates the dump file DECISION$BUILDER_BUGCHK.DMP. o The Control Component creates the dump file DECISION$CTL_BUGCHK.DMP. The bugcheck dump file is placed in your SYS$SCRATCH directory. If a bugcheck occurs, please submit to Digital a description of the problem, instructions on how to reproduce it, the associated data files (databases, spreadsheets, blueprints, and so on), and a copy of the bugcheck dump file. 4.4 Using Logical Names with DECdecision For all components running under DECdecision, you should define any logical names you need as JOB logicals (or GROUP or SYSTEM logicals). You will lose all your JOB logicals if the process that has started DECdecision is terminated. The JOB logicals lost include SYS$LOGIN and SYS$SCRATCH. Without SYS$SCRATCH, you cannot open a Builder blueprint, record a private macro, import, export, perform Copy Selection operations, or use the Draw Chart command within DECquery. Managing Your DECdecision Environment 4-5 Managing Your DECdecision Environment Deassigning the logical name DECW$USER_DEFAULTS may cause unexpected results in DECdecision. Do not deassign DECW$USER_DEFAULTS. 4-6 Managing Your DECdecision Environment A ________________________________________________________________ Sample DECdecision Installation This appendix shows a typical installation of DECdecision on a VMS Version 5.4 system. In the example, DECdecision also installs DECchart Version 1.5. Table 1-5 summarizes the tasks you must perform before installing DECdecision. Check to make sure that you have completed all these tasks before proceeding with the installation. Welcome to node MYNODE Username: SYSTEM Password: Welcome to VAX/VMS Version 5.4 on node MYNODE Last interactive login on Wednesday, 21-AUG-1991 08:32 Last non-interactive login on Wednesday, 21-AUG-1991 01:00 $ REPLY/USER "Installation starting in 5 minutes. Please log out." $ SET LOGINS/INTERACTIVE=0 $ @SYS$UPDATE:VMSINSTAL DECISION015 MUA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.4 It is 21-AUG-1991 at 09:17. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? Please mount the first volume of the set on MUA0:. * Are you ready? YES %MOUNT-I-MOUNTED, DECIS mounted on _MUA0: The following products will be processed: DECISION V1.5 Sample DECdecision Installation A-1 Sample DECdecision Installation Beginning installation of DECISION V1.5 at 09:17 %VMSINSTAL-I-RESTORE, Restoring product save set 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]: 2 * Queue name [SYS$PRINT]: Job 810 (queue SYS$PRINT, entry 1295) started on SYS$PRINT * Do you want to continue the installation [NO]? YES %VMSINSTAL-I-RELMOVED , The product's release notes have been moved to SYS$HELP. ************************************************************ * * * DECdecision V1.5 * * Integrated Decision Support Package * * * * Installation Procedure * * * ************************************************************ Product: DECDECISION-USER Producer: DEC Version: 1.5 Release Date: 30-AUG-1991 * Does this product have an authorization key registered and loaded? YES Checking user parameters Checking system parameters Testing dependent product versions %VMSINSTAL-I-RESTORE, Restoring product save set B ... This kit requires DECchart V1.5 or later ********************************************************** DECchart V1.5 will be installed since an earlier version exists on your system. A-2 Sample DECdecision Installation Sample DECdecision Installation ********************************************************** The DECdecision product creates a tree of library directories. A subdirectory is created for each component. * Where would you like to place the DECISION V1.5 library root [SYS$SYSCOMMON:[DECISION]]: %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECISION]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECISION.BUILDER]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECISION.ECALC]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[DECISION.ACCESS]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DECISION$IVP]. * Do you want to run the IVP after the installation [YES]? The DECdecision IVP requires that a display device be defined (using the SET DISPLAY command). Please enter the node name of the workstation on which to display the IVP. * Enter node name (or Return to not run IVP): MYNODE * Do you want to purge files replaced by this installation [YES]? To complete the installation on a standalone VAX 11/780 will take approximately: 30 minutes to install 11 minutes to run the IVP All required questions have been asked. You can terminate the installation procedure at this time. * Do you want to continue the installation [YES]? %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... *************************************************************************** SYSTEM MANAGER Sample DECdecision Installation A-3 Sample DECdecision Installation The following command lines MUST be added to the system startup command file SYS$MANAGER:SYSTARTUP_V5.COM for all nodes that will be running DECdecision $ @SYS$STARTUP:DECISION$STARTUP.COM The following command lines should be added to the system shutdown command file SYS$MANAGER:SYSHUTDWN.COM for all nodes that will be running DECdecision $ @SYS$MANAGER:DECISION$SHUTDOWN.COM *************************************************************************** %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.CHART$IVP]. %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSHLP.EXAMPLES.DECCHART]. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories. Executing IVP for: DECISION V1.5 ********************************************************************* * * * Installing Sample Database... * * * ********************************************************************* * * * Installing Default User Database... * * * ********************************************************************* * * * Installing Public Folder Database... * * * ********************************************************************* Executing IVP for: DECdecision V1.5 The IVP runs a Builder BLUEPRINT which will run each component and produce intermediate reports and a final chart of the results. The reports and chart are compared with the expected values to determine if the IVP has completed successfully. Starting DECdecision... Comparing the results of the BLUEPRINT with the expected results ******************************** A-4 Sample DECdecision Installation Sample DECdecision Installation DECdecision V1.5 IVP COMPLETED SUCCESSFULLY ******************************** IVP completed for: DECdecision V1.5 Installation of DECISION V1.5 completed at 10:30 VMSINSTAL procedure done at 10:30 $ SET LOGINS/INTERACTIVE=64 $ REPLY/USER "Installation complete. System is ready for use." Table 3-2 summarizes the tasks you must perform after installing DECdecision. Check to make sure that you have completed all these tasks before making DECdecision available to users. Sample DECdecision Installation A-5 B ________________________________________________________________ Sample DECdecision Upgrade from a Previous Version This appendix shows a typical upgrade of DECdecision from Version 1.1 to Version 1.5 on a VMS Version 5.4 system. In this example, DECdecision also upgrades to DECchart Version 1.5. Table 1-5 summarizes the tasks you must perform before installing DECdecision. Check to make sure that you have completed all these tasks before proceeding with the installation. Welcome to node MYNODE Username: SYSTEM Password: Welcome to VAX/VMS Version 5.4 on node MYNODE Last interactive login on Wednesday, 21-AUG-1991 08:32 Last non-interactive login on Wednesday, 21-AUG-1991 01:00 $ REPLY/USER "Installation starting in 5 minutes. Please log out." $ SET LOGINS/INTERACTIVE=0 $ @SYS$UPDATE:VMSINSTAL DECISION015 MUA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.4 It is 21-AUG-1991 at 09:17. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? Please mount the first volume of the set on MUA0:. * Are you ready? YES %MOUNT-I-MOUNTED, DECIS mounted on _MUA0: The following products will be processed: DECISION V1.5 Sample DECdecision Upgrade from a Previous Version B-1 Sample DECdecision Upgrade from a Previous Version Beginning installation of DECISION V1.5 at 09:17 %VMSINSTAL-I-RESTORE, Restoring product save set 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]: 2 * Queue name [SYS$PRINT]: Job 810 (queue SYS$PRINT, entry 1295) started on SYS$PRINT * Do you want to continue the installation [NO]? YES %VMSINSTAL-I-RELMOVED , The product's release notes have been moved to SYS$HELP. ************************************************************ * * * DECdecision V1.5 * * Integrated Decision Support Package * * * * Installation Procedure * * * ************************************************************ Product: DECDECISION-USER Producer: DEC Version: 1.5 Release Date: 30-AUG-1991 * Does this product have an authorization key registered and loaded? YES Checking user parameters Checking system parameters Testing dependent product versions %VMSINSTAL-I-RESTORE, Restoring product save set B ... This kit requires DECchart V1.5 or later ************************************************************ DECchart V1.5 will be installed since an earlier version exists on your system. B-2 Sample DECdecision Upgrade from a Previous Version Sample DECdecision Upgrade from a Previous Version ************************************************************ * Do you want to proceed [YES]? The directory DECISION$LIBRARY currently exists on your system. * Would you like to place the DECISION V1.5 library root there [YES]? %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DECISION$IVP]. %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.DECISION$IVP] already exists ************************************************************* DECdecision has a default database. This is copied to new user's accounts when they first use DECdecision. This database is installed in DECISION$ACCESS_LIBRARY ************************************************************* Your system has a default user database. * Do you want to replace it [NO]? * Do you want to run the IVP after the installation [YES]? The DECdecision IVP requires that a display device be defined (using the SET DISPLAY command). Please enter the node name of the workstation on which to display the IVP. * Enter node name (or Return to not run IVP): MYNODE * Do you want to purge files replaced by this installation [YES]? To complete the installation on a standalone VAX 11/780 will take approximately: 30 minutes to install 11 minutes to run the IVP All required questions have been asked. You can terminate the installation procedure at this time. * Do you want to continue the installation [YES]? %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... *************************************************************************** Sample DECdecision Upgrade from a Previous Version B-3 Sample DECdecision Upgrade from a Previous Version SYSTEM MANAGER The following command lines MUST be added to the system startup command file SYS$MANAGER:SYSTARTUP_V5.COM for all nodes that will be running DECdecision $ @SYS$STARTUP:DECISION$STARTUP.COM The following command lines should be added to the system shutdown command file SYS$MANAGER:SYSHUTDWN.COM for all nodes that will be running DECdecision $ @SYS$MANAGER:DECISION$SHUTDOWN.COM ************************************************************************* %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.CHART$IVP]. %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.CHART$IVP] already exists %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSHLP.EXAMPLES.DECCHART]. %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.EXAMPLES.DECCHART] already exists Deleting obsolete files %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories. ********************************************************************* * * * Installing Sample Database... * * * ********************************************************************* Executing IVP for: DECdecision V1.5 The IVP runs a Builder BLUEPRINT which will run each component and produce intermediate reports and a final chart of the results. The reports and chart are compared with the expected values to determine if the IVP has completed successfully. Starting DECdecision... Comparing the results of the BLUEPRINT with the expected results ******************************** DECdecision V1.5 IVP COMPLETED SUCCESSFULLY ******************************** B-4 Sample DECdecision Upgrade from a Previous Version Sample DECdecision Upgrade from a Previous Version IVP completed for: DECdecision V1.5 Installation of DECISION V1.5 completed at 10:30 VMSINSTAL procedure done at 10:30 $ SET LOGINS/INTERACTIVE=64 $ REPLY/USER "Installation complete. System is ready for use." Table 3-2 summarizes the tasks you must perform after installing DECdecision. Check to make sure that you have completed all these tasks before making DECdecision available to users. Sample DECdecision Upgrade from a Previous Version B-5 C ________________________________________________________________ DECdecision Files This appendix lists all the files that are transferred to your system during a first time DECdecision installation in which DECchart Version 1.5 is installed. The files are listed by directory. In DECW$SYSTEM_DEFAULTS: DECCHART$MOTIF_UID.UID DECISION$ACCESS_DEFAULTS.DAT DECISION$ACCESS_UID.UID DECISION$BUILDER_UID.UID DECISION$CT_UID.UID DECISION$DEFAULTS.DAT DECISION$ECALC.DAT DECISION$ESP_UID.UID DECISION$EVE_UID.UID In SYS$STARTUP: CHART$STARTUP.COM DECISION$STARTUP.COM In SYS$SYSTEM: DECCHART$MOTIF.EXE DECISION$ACCESS.EXE DECISION$BUILDER.EXE DECISION$CT.EXE DECISION$ECALC.EXE DECdecision Files C-1 DECdecision Files In SYS$HELP: DECISION$ACCESS_HELP.DECW$BOOK DECISION$BUILDER_HELP.DECW$BOOK DECISION$CHART.HLB DECISION$CT_HELP.DECW$BOOK DECISION$ECALC.DECW$BOOK DECISION015.RELEASE_NOTES TCV_CONVERT_MESSAGES.TXT In SYS$COMMON:[SYSHLP.EXAMPLES.DECCHART]: CHART$SAMPLE.CHART CHART$SAMPLE.CHART_STYLE CHART$SAMPLE.TABLE In SYS$LIBRARY: DECISION$BUILDER_SHR.EXE DECISION$DTIF_TO_DDIF.EXE DECISION$ESP_SECTION.TPU$SECTION DECISION$TABLEWGT_SHR.EXE DTIF$READ_ASCII_FIELD.EXE DTIF$READ_ASCII_TABULAR.EXE DTIF$READ_CALCGRD.EXE DTIF$READ_DIF.EXE DTIF$READ_WK1.EXE DTIF$READ_WK3.EXE DTIF$WRITE_ASCII_TABULAR.EXE DTIF$WRITE_WK1.EXE DTIF$WRITE_WK3.EXE ECALC$GRID_SHR.EXE ECALC$TPU_SHR.EXE TCV$SHR.EXE TPU$EXT_TABLEWGT.EXE In SYS$MANAGER: DECISION$SHUTDOWN.COM C-2 DECdecision Files DECdecision Files In SYS$MESSAGE: DTIF$READ_ASCII_FIELD_MESSAGES.EXE DTIF$READ_ASCII_TABULAR_MESSAGES.EXE DTIF$READ_CACLGRD_MESSAGES.EXE DTIF$READ_DIF_MESSAGES.EXE DTIF$READ_WK1_MESSAGES.EXE DTIF$READ_WK3_MESSAGES.EXE DTIF$WRITE_ASCII_TABULAR_MESSAGES.EXE DTIF$WRITE_WK1_MESSAGES.EXE DTIF$WRITE_WK3_MESSAGES.EXE ECALC$MESSAGES.EXE TCV$MSG.EXE DECdecision Files C-3 DECdecision Files In CDA$LIBRARY: CH_AREA100.CHART_STYLE CH_AREAGRID.CHART_STYLE CH_AREASIMPLE.CHART_STYLE CH_AREA_COL.CHART_STYLE CH_BAR100.CHART_STYLE CH_BARCLUSTER.CHART_STYLE CH_BARCLUSTERGRID.CHART_STYLE CH_BARCLUSTERVALUE.CHART_STYLE CH_BAROVERLAP.CHART_STYLE CH_BARSTACK.CHART_STYLE CH_COL100.CHART_STYLE CH_COLCLUSTER.CHART_STYLE CH_COLCLUSTERGRID.CHART_STYLE CH_COLCLUSTERVALUE.CHART_STYLE CH_COLOVERLAP.CHART_STYLE CH_COLSTACK.CHART_STYLE CH_COL_HILO.CHART_STYLE CH_COL_LINE.CHART_STYLE CH_COL_SCAT.CHART_STYLE CH_HILO.CHART_STYLE CH_HILOCLOSE.CHART_STYLE CH_HILOOPCL.CHART_STYLE CH_HILOOPEN.CHART_STYLE CH_HILO_LINE.CHART_STYLE CH_HISTO.CHART_STYLE CH_HISTOHGRID.CHART_STYLE CH_HISTOHVGRID.CHART_STYLE CH_HISTOVALUE.CHART_STYLE CH_LINE.CHART_STYLE CH_LINEHGRID.CHART_STYLE CH_LINEHVGRID.CHART_STYLE CH_LINELOG.CHART_STYLE CH_LINEMARKERS.CHART_STYLE CH_LINE_LINE.CHART_STYLE CH_LINE_SCAT.CHART_STYLE CH_PIE.CHART_STYLE CH_PIEALLEXP.CHART_STYLE CH_PIEONEEXP.CHART_STYLE CH_PIEVALUE.CHART_STYLE CH_SCATTER.CHART_STYLE CH_SCATTERDEPLOG.CHART_STYLE C-4 DECdecision Files DECdecision Files CH_SCATTERHVGRID.CHART_STYLE CH_SCATTERLINES.CHART_STYLE CH_SCATTERXYLOG.CHART_STYLE DECdecision Files C-5 DECdecision Files In DECISION$LIBRARY: ACCESS.DIR BUILDER.DIR ECALC.DIR In DECISION$ACCESS_LIBRARY: DECISION$ACCESS_CREDB.COM DECISION$ACCESS_DEFDB.RBR DECISION$ACCESS_DEFDB.RDB DECISION$ACCESS_DEFDB.SNP DECISION$ACCESS_PUBLISH.ACCESS$MACRO DECISION$ACCESS_PUBLISH.COM DECISION$ACCESS_SAMPLE.RBR DECISION$ACCESS_SAMPLE.RDB DECISION$ACCESS_SAMPLE.SNP DECISION$ACCESS_SYSDB.RDB DECISION$ACCESS_SYSDB.SNP DECISION$ACCESS_SYSDB.RBR In DECISION$BUILDER_LIBRARY: C-6 DECdecision Files DECdecision Files DECISION$APPEND.COM DECISION$BIG_DISCOUNT.DOC DECISION$BUILDER_SYSTBX.DAT DECISION$DECISION.BLUEPRINT DECISION$DECISION.DOC DECISION$DECISION_MORE.DOC DECISION$DECWRITE.BLUEPRINT DECISION$DECWRITE_GUIDE.DOC DECISION$EXTERNAL.BLUEPRINT DECISION$EXTERNAL.DOC DECISION$LIVELINK.DOC DECISION$LOOP.BLUEPRINT DECISION$LOOP.DOC DECISION$LOOP_MORE.DOC DECISION$REVENUE_BY_DIVISION.TABLE DECISION$SMALL_DISCOUNT.DOC DECISION$TUTORIAL.BLUEPRINT DECISION$TUTORIAL.DOC DECISION$TUTORIAL_MORE.DOC DECISION$USER_TOOL.BLUEPRINT DECISION$USER_TOOL.DOC DECISION$USER_TOOL_MORE.DOC DECISION$VARIABLES.BLUEPRINT DECISION$VARIABLES.DOC DECISION$VARIABLES_MORE.DOC DECISION$YEARLY_REVENUE.TABLE DECdecision Files C-7 DECdecision Files In DECISION$ECALC_LIBRARY: DECISION$INTEREST_TABLE.TABLE DECISION$MACRO_EXAMPLE.TPU DECISION$YEARLY_REV.TABLE In SYS$TEST: CHART.DIR DECISION$IVP.COM DECISION$IVP.DIR In SYS$COMMON:[SYSTEST.DECISION$IVP]: DECISION$ACCESS_REPORT.DDIF DECISION$CALC_REPORT.DDIF DECISION$CHART_RESULTS.CHART DECISION$COMPARE_FILES.COM DECISION$IVP.BLUEPRINT In SYS$COMMON:[VUE$LIBRARY.USER]: CHART$VUE.COM CHART$VUE_PROFILE.VUE$DAT DECISION$VUE.COM DECISION$VUE_PROFILE.VUE$DAT C-8 DECdecision Files ________________________________________________________________ Index A DATATRIEVE ___________________________ and DECdecision, 4-4 Access DCL commands granting remote, 4-4 for checking disk space, Account privileges, 3-4 1-8 Account quotas, 3-5 for running DECdecision, checking, 1-7 3-6 modifying, 1-7 for running the IVP, 3-6 for running VMSINSTAL, B__________________________ 2-4 Backing up system disk, for starting Rdb monitor, 1-12, 2-5 1-12 DECchart C__________________________ installing, 2-1 Checking the distribution upgrading, 2-1, 2-9 DECdecision kit, 1-2 activating on VAXcluster, Cluster 3-2 activating DECdecision DCL commands for running, on, 3-2 3-6 installing on, 1-5 directories, 1-4 Components required files, C-1 to C-8 VMS, 1-3 handling fatal errors, 4-5 D__________________________ logical names, 1-4 Databases registering license, 1-4 accessing IBM, 4-3 running, 3-6 accessing remote, 4-4 user account privileges, managing DECquery, 4-3 3-4 migrating to another user account quotas, 3-5 system, 4-3 using with DATATRIEVE, upgrading default user, 4-4 2-12 Index-1 DECdecision (Cont.) Granting remote database using with remote access, 4-4 databases, 4-4 DECquery H__________________________ updating Examples folder, Hardware 3-4 prerequisite, 1-2 Disk blocks displaying number of I__________________________ unused, 1-8 Improving performance, 4-1 required, 1-8, 1-9 Installation Distribution kit example, A-1 to A-5 contents of, 1-2 files installed, C-1 to list of files on, C-1 C-8 Dump files, 4-5 first time, 2-1 E kit, 1-2 ___________________________ overview, 2-1 Editing preparing for, 1-1 SYSHUTDWN.COM, 3-2 starting, 2-2 SYSTARTUP_V5.COM, 3-1 stopping, 2-3 Errors time needed, 2-1 handling fatal, 4-5 upgrading, 2-1, B-1 to B-5 F__________________________ Installation Verification Fatal errors, 4-5 Procedure Files DECdecision, 2-16 DECdecision, C-1 to C-8 running after dump, 4-5 installation, 3-6 managing DECquery, 4-3 running during purging old versions, installation, 2-12 2-13 Installing account requirements, 1-6 G__________________________ privileges, 1-6 Global pages quotas, 1-6 adjusting for run-time IVP use, 4-2 DECdecision, 2-16 checking, 1-11 running after required values, 1-9 installation, 3-6 Global sections running during adjusting for run-time installation, 2-12 use, 4-2 checking, 1-11 required values, 1-9 Index-2 Preparing for installation L__________________________ (Cont.) Labels check list, 1-13 on distribution media, Prerequisite hardware, 1-2 1-2 Prerequisite software, 1-3 Library directories, 2-11 Privileges License required for installing, loading on VAXcluster, 1-6 3-2 required for using, 3-4 registering, 1-4, 2-7 Problems License Management Facility reporting, 1-12 , 1-4 Product Authorization Key Logical names, 1-4, 4-5 loading on VAXcluster, 3-2 M__________________________ registering, 1-4 Media Q labels, 1-2 ___________________________ mounting, 2-5 Quotas installation account, 1-6 O__________________________ user account, 3-5 Operating system R required components, 1-3 ___________________________ Rdb/VMS P__________________________ starting before PAK installation, 1-12 loading on VAXcluster, Rebooting system, 3-6 3-2 Release notes, 2-5 registering, 1-4, 2-7 Remote access Parameters granting, 4-4 adjusting for run-time Reporting problems, 1-12 use, 4-2 Required disk space changing, 1-11 system, 1-8 checking, 1-10 user, 1-9 system, 1-9 Required hardware, 1-2 Performance considerations, Required operating system 4-1 to 4-3 components, 1-3 global pages, 4-2 Required privileges, 1-6 global sections, 4-2 Required software, 1-3 working set, 4-2 Running DECdecision, 3-6 Post-installation check list, 3-8 Preparing for installation, 1-1 Index-3 S__________________________ T__________________________ Sample files, 1-4 Time needed to install, 2-1 Sample installation, A-1 Tuning system, 4-1 to A-5 Sample upgrade, B-1 to B-5 U__________________________ Shutdown file Upgrade procedure, 2-1 editing system, 3-2 example, B-1 to B-5 Software User account prerequisite, 1-3 privileges, 3-4 Starting the installation, quotas, 3-5 2-2 Startup file V editing system, 3-1 ___________________________ Stopping the installation, VAXcluster 2-3 activating DECdecision, SYSGEN 3-2 changing parameters, 1-11 installing on, 1-5 checking values, 1-10 loading license on, 3-2 minimum values, 1-9 VMS components required, SYSHUTDWN.COM 1-3 editing, 3-2 VMSINSTAL procedure, 2-4 SYSTARTUP_V5.COM to 2-16 editing, 3-1 command line, 2-4 System problem detection, 2-2 editing shutdown file, starting the installation 3-2 , 2-2 editing startup file, 3-1 stopping the installation rebooting, 3-6 , 2-3 tuning, 4-1 to 4-3 time needed to install, System disk 2-1 backing up, 1-12, 2-5 System parameters W__________________________ adjusting for run-time Working set, 4-2 use, 4-2 WSDEFAULT value, 4-2 changing, 1-11 WSEXTENT value, 4-2 minimum values, 1-9 WSMAX value, 4-2 on VAXclusters, 1-5 WSQUOTA value, 4-2 Index-4