______________________________________________ DEC OPS5 Installation Guide for VMS Systems Order Number: AA-EZ20E-TE MAY 1992 MAY 1992 MAY 1992 This document contains instructions for installing DEC OPS5 on the VMS operating system. It also explains how to read the online release notes before or after installing the product. This document applies to DEC OPS5 Version 4.0 and all maintenance updates throughout that version. This revised manual Revision/Update Information: Revision/Update Information: Revision/Update Information: supersedes the ___ ____ ____________ VAX OPS5 Installation (Order Number _____ Guide AA-EZ20E-TE). VMS Version 5.4-2 Operating System & Version: Operating System & Version: Operating System & Version: or higher and VMS DECwindows Motif Version 1.0 for the DEC OPS5 Development Environment; VMS Version 5.2-1 or higher for the DEC OPS5 compiler and run-time system. DEC OPS5 Version 4.0 Software Version: Software Version: Software Version: Digital Equipment Corporation Digital Equipment Corporation Digital Equipment Corporation Maynard, Massachusetts Maynard, Massachusetts Maynard, Massachusetts ________________________________________________________________ First Printing, September 1985 First Printing, September 1985 First Printing, September 1985 Revised, May 1986 Revised, May 1986 Revised, May 1986 Revised, February 1988 Revised, February 1988 Revised, February 1988 Revised, May 1989 Revised, May 1989 Revised, May 1989 Revised, May 1992 Revised, May 1992 Revised, May 1992 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 1985, 1986, 1988, 1989, 1992. All Rights Reserved. Printed in U.S.A. The postpaid Reader's Comments form at the end of this guide requests your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: CDD, DEC, DECnet, DEC OPS5, DEC OSF/1, DECwindows, RA, Rdb/VMS, RX02, TK, ULTRIX, VAX, VAX Ada, VAX BASIC, VAX C, VAX DOCUMENT, VAX FORTRAN, VAX OPS5, VAX Pascal, VMS, and the Digital logo. Motif and OSF/1 are registered trademarks of Open Software Foundation, Inc. PostScript is a registered trademark of Adobe Systems, Inc. S1844 This document is available on CDROM. This document was prepared using VAX DOCUMENT, Version 2.0. ________________________________________________________________ Contents Contents Contents Preface Preface Preface .................................................. v 1 Preparing for DEC OPS5 Installation 1 Preparing for DEC OPS5 Installation 1 Preparing for DEC OPS5 Installation 1.1 Required Operating System Components............ 1-1 1.2 Prerequisite Hardware........................... 1-2 1.3 Prerequisite and Optional Software.............. 1-2 1.4 License Registration............................ 1-3 1.5 Installation Procedure Requirements............. 1-4 1.5.1 Privileges and Disk Space .................... 1-4 1.5.2 System Parameters ............................ 1-5 1.5.2.1 Checking System Parameter Values........... 1-5 1.5.2.2 Calculating the Values for GBLPAGES and GBLSECTIONS ............................... 1-6 1.5.2.3 Changing System Parameter Values with AUTOGEN.................................... 1-6 1.5.3 VMSINSTAL Requirements ....................... 1-7 1.5.4 Backing Up Your System Disk .................. 1-8 2 Installing DEC OPS5 2 Installing DEC OPS5 2 Installing DEC OPS5 2.1 The Installation Procedure...................... 2-1 2.2 Error Recovery.................................. 2-9 3 After Installing DEC OPS5 3 After Installing DEC OPS5 3 After Installing DEC OPS5 3.1 Running the Installation Verification Procedure Separately...................................... 3-1 3.2 Editing the System Files........................ 3-1 3.3 VAXcluster Considerations....................... 3-2 3.4 User Account Requirements....................... 3-2 3.4.1 Privileges ................................... 3-2 iii 3.4.2 User Account Quotas .......................... 3-3 3.4.3 Installing DEC OPS5 as a Shared Image ........ 3-3 3.5 Determining and Reporting Problems.............. 3-3 A Sample Installation A Sample Installation A Sample Installation A.1 Full Development Kit............................ A-1 B Files and Logical Names Installed on Your System B Files and Logical Names Installed on Your System B Files and Logical Names Installed on Your System B.1 File Names...................................... B-1 B.2 Logical Names................................... B-4 Index Index Index Tables Tables Tables 1-1 Prerequisite and Optional Software ........... 1-2 1-2 Disk Space Requirements ...................... 1-4 1-3 Minimum Required System Parameter Values ..... 1-5 3-1 User Account Quotas for Using DEC OPS5 ....... 3-3 B-1 Installed DEC OPS5 Files ..................... B-1 B-2 Logical Names ................................ B-4 iv ________________________________________________________________ Preface Preface Preface Purpose of This Guide Purpose of This Guide Purpose of This Guide This guide describes how to install DEC OPS5 on VAX processors that are running the VMS operating system. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall DEC OPS5 for any other reason. At the back of this document is a Reader's Comment form. If you have any comments about this document, fill out the form and mail it; your comments will be considered for the next revision of the installation guide. Intended Audience Intended Audience Intended Audience The audience for this guide is the system manager who installs DEC OPS5 software. Structure of this Document Structure of this Document Structure of this Document This guide is organized as follows: o Chapter 1 describes the operating system and hardware requirements for DEC OPS5 installation and related procedures that you complete before installing DEC OPS5. o Chapter 2 describes the step-by-step instructions for the installation. o Chapter 3 describes actions and considerations after the installation. o Appendix A contains sample listings for DEC OPS5 installa- tion. v o Appendix B contains the files and logical names installed on your system. Manuals in the DEC OPS5 Documentation Set Manuals in the DEC OPS5 Documentation Set Manuals in the DEC OPS5 Documentation Set In addition to this guide, the DEC OPS5 documentation set includes the following manuals: o _____ __ ___ ____ Guide to DEC OPS5 o ___ ____ _____________ ___ _________ _____ DEC OPS5 Compatibility and Migration Guide Related Manuals Related Manuals Related Manuals o ___ __________ _____ ____________ _____ VMS DECwindows Motif Installation Guide o ___ _______ ___ _______ ___ ____________ ______ VMS Version 5.4 Upgrade and Installation Manual o ___ _______ ___ _______ ___ ____________ __________ VMS Version 5.2 Upgrade and Installation Procedures o by Thomas Cooper and Nancy __________ ___________ ____ ____ Rule-based Programming with OPS5 Wogrin. This text describes the public-domain OPS5 language and previous versions of Digital Equipment Corporation's implementation of OPS5, up to VAX OPS5 Version 3.0. Although it does not provide information on the many new features of Digital's extended implementation, DEC OPS5 Version 4.0, Digital continues to recommend this text for its explanation of the rule-based programming paradigm and as a tutorial on application design methodology for rule-based systems. To order this text in the U.S. and Canada, contact: Morgan Kaufmann Publishers 2929 Campus Drive, Suite 260 San Mateo, CA 94403 U.S.A. Telephone: (800) 745-7323 (orders only) FAX: (415) 578-0672 To order this text in the United Kingdom and Europe, contact: Morgan Kaufmann-UK 27 Palmeira Mansions Church Road Hove, East Sussex BN3 2FA UK Telephone: (0273) 207-259 FAX: (0273) 205-612 vi To order this text in Japan/Korea, contact: Morgan Kaufmann-Japan Wada Bldg. 102, 2-5-21 Takadanobaba Shinjuku-ku, Tokyo 160 Japan Telephone/FAX: (03) 3205-4651 Conventions Conventions Conventions The following conventions are used in this guide: ________________________________________________________________ ________________________________________________________________ Convention Meaning Convention Meaning Convention Meaning UPPERCASE characters VMS DCL commands and qualifiers and the names of DEC OPS5 declarations, statements, actions, functions, commands, and support routines are printed in uppercase characters. However, you can enter them in uppercase, lowercase, or a combination of the two because DEC OPS5 converts lowercase characters to uppercase and the VMS system is case insensitive. lowercase characters The arguments you must specify with VMS DCL commands and DEC OPS5 operators, declarations, statements, actions, and commands are printed in lowercase characters. However, you can enter them in lowercase, uppercase, or a combination of the two because DEC OPS5 converts lowercase characters to uppercase and because the VMS system is case insensitive. On VMS systems, you can specify functions and RTL routines in uppercase, lowercase, or a combination of the two because the VMS system is case insensitive. $ In interactive examples, user input is @SYS$UPDATE:VMSINSTAL @SYS$UPDATE:VMSINSTAL @SYS$UPDATE:VMSINSTAL printed in bold. vii ________________________________________________________________ ________________________________________________________________ Convention Meaning Convention Meaning Convention Meaning $ The dollar sign is used to indicate the DCL prompt. This prompt may be different on your system. In procedures, a sequence such as indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. In procedures, a key name is shown enclosed to indicate that you press a key on the keyboard. . Vertical ellipsis in an example means . that information not directly related to . the example has been omitted. file-spec, . . . Horizontal ellipsis indicates that additional parameters, values, or information can be entered. [logical-name] Brackets indicate that the enclosed item is optional. (Brackets are not, however, optional in the syntax of a directory name in a file specification or in the syntax of a substring specification in an ________________________________________________________________ assignment statement.) viii 1 1 1 ________________________________________________________________ Preparing for DEC OPS5 Installation Preparing for DEC OPS5 Installation Preparing for DEC OPS5 Installation This chapter discusses the preparations and requirements necessary for installing DEC OPS5. They are: o Required operating system components (see Section 1.1) o Prerequisite hardware (see Section 1.2) o Prerequisite and optional software (see Section 1.3) o License registration (see Section 1.4) o Installation procedure requirements (see Section 1.5) This manual applies to Version 4.0 of DEC OPS5 and all subsequent maintenance releases up to the next major product release. Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Digital Equipment Corporation representative. DEC OPS5 provides online release notes. Digital strongly recommends that you read the release notes before proceeding with the installation. For information on accessing the online release notes, see Section 2.1. 1.1 Required Operating System Components 1.1 Required Operating System Components 1.1 Required Operating System Components The VMS operating system comes with a variety of support options, or classes. Classes include such features as networking and RMS journaling. For a complete list of the required classes, see the Software Support Addendum (SSA), which comes with the Software Product Description (SPD). Preparing for DEC OPS5 Installation 1-1 1-1 1-1 1.2 Prerequisite Hardware 1.2 Prerequisite Hardware 1.2 Prerequisite Hardware For a complete list of hardware, see the Software Support Addendum (SSA), which comes with the Software Product Description (SPD). 1.3 Prerequisite and Optional Software 1.3 Prerequisite and Optional Software 1.3 Prerequisite and Optional Software Table 1-1 provides information on the software you must have installed on your system before installing DEC OPS5. The table also includes information about optional software that you can use together with DEC OPS5. The Software Support Addendum (SSA) contains a complete list of prerequisite and optional software and their required version numbers. ________________________________________________________________ Table 1-1 Prerequisite and Optional Software Table 1-1 Prerequisite and Optional Software Table 1-1 Prerequisite and Optional Software ________________________________________________________________ Prerequisite Products Purpose Prerequisite Products Purpose Prerequisite Products Purpose VMS (see the SSA for For the DEC OPS5 compiler and run- version numbers) time system VMS DECwindows Motif For the DEC OPS5 Development Compute Server (see the Environment SSA for version numbers) VAX Rdb/VMS software For DEC OPS5 SQL support (see the SSA for version ________________________________________________________________ numbers) If VMS DECwindows Motif is present on your system, you will be asked during installation if you want to install the DEC OPS5 Development Environment. If VMS DECwindows Motif is not present, you can still proceed with the installation, but the Development Environment will not be installed. You can install VMS DECwindows later, but you will have to reinstall DEC OPS5 to use the Development Environment. If VAX Rdb/VMS software is present on your system, you will be asked during installation if you want to install the SQL support. If VAX Rdb/VMS software is not present, you can still proceed with the installation, but the SQL support will not be installed. You can install VAX Rdb/VMS later, but you will have to reinstall DEC OPS5 to use the SQL support. Preparing for DEC OPS5 Installation 1-2 1-2 1-2 1.4 License Registration 1.4 License Registration 1.4 License Registration If you are installing DEC OPS5 Version 4.0 on a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. If you are installing an update of DEC OPS5 but lack a service contract, call your Digital representative for instructions on how to get an Update License. If you are installing prerequisite or optional software along with DEC OPS5, review the PAK status and install the PAKs for any prerequisite or optional software before you install DEC OPS5. You must register and load your license for DEC OPS5 before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software. To register a license under VMS, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to register: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. If you plan to use DEC OPS5 on more than one node in a VAXcluster, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.3. For complete information on using LMF, see the ___ _______ VMS License . __________ _______ ______ Management Utility Manual Preparing for DEC OPS5 Installation 1-3 1-3 1-3 1.5 Installation Procedure Requirements 1.5 Installation Procedure Requirements 1.5 Installation Procedure Requirements This section and those that follow discuss various requirements for installing DEC OPS5. The installation takes approximately 2 to 20 minutes, depending on your type of media and your system configuration. Installing DEC OPS5 and running the Installation Verification Procedure (IVP) on a standalone VAXstation 3100 system takes 14 minutes. 1.5.1 Privileges and Disk Space 1.5.1 Privileges and Disk Space 1.5.1 Privileges and Disk Space To install DEC OPS5, you must be logged into an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV Note that VMSINSTAL turns off BYPASS privilege at the start of the installation. DEC OPS5's requirements for free disk storage space are different during installation and after installation. Table 1-2 summarizes the storage requirements. ________________________________________________________________ Table 1-2 Disk Space Requirements Table 1-2 Disk Space Requirements Table 1-2 Disk Space Requirements Blocks During Blocks After Blocks During Blocks After Blocks During Blocks After ________________________________________________________________ Kit Installation Installation Kit Installation Installation Kit Installation Installation Base system DEC OPS5 6181 Blocks 3250 Blocks V4.0 Development Environment 1752 Blocks 1453 Blocks SQL Support 112 Blocks 48 Blocks Example Files 566 Blocks 566 Blocks ________________________________________________________________ Total for DEC OPS5 V4.0 8611 Blocks 5317 Blocks To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: SHOW DEVICE SYS$SYSDEVICE SHOW DEVICE SYS$SYSDEVICE SHOW DEVICE SYS$SYSDEVICE $ Preparing for DEC OPS5 Installation 1-4 1-4 1-4 1.5.2 System Parameters 1.5.2 System Parameters 1.5.2 System Parameters Installing DEC OPS5 requires certain system parameter settings. Table 1-3 lists the minimum required system parameter values for the installation. ________________________________________________________________ Table 1-3 Minimum Required System Parameter Values Table 1-3 Minimum Required System Parameter Values Table 1-3 Minimum Required System Parameter Values ________________________________________________________________ System parameter Minimum Value System parameter Minimum Value System parameter Minimum Value GBLPAGES+ + 371 ++ _ n GBLSECTIONS+ + 6 _ n ________________________________________________________________ +The values listed for these system parameters represent the number of free global pages and global sections required for the installation, not the total number you need to run your system and other software. ++ = value you are currently using. _ n ________________________________________________________________ The following sections show you how to: o Check system parameter values o Calculate values for the GBLPAGES and GBLSECTIONS system parameters o Change parameter values with the VMS AUTOGEN command procedure 1.5.2.1 Checking System Parameter Values 1.5.2.1 Checking System Parameter Values 1.5.2.1 Checking System Parameter Values To check the values of your system parameters, enter the following command at the DCL prompt to invoke the System Generation Utility (SYSGEN): RUN SYS$SYSTEM:SYSGEN RUN SYS$SYSTEM:SYSGEN RUN SYS$SYSTEM:SYSGEN $ SYSGEN> At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The values displayed should equal or exceed the value of each system parameter listed in Table 1-3. The following example displays the value for the WSMAX system parameter: SHOW GBLPAGES SHOW GBLPAGES SHOW GBLPAGES SYSGEN> After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level. Preparing for DEC OPS5 Installation 1-5 1-5 1-5 1.5.2.2 Calculating the Values for GBLPAGES and GBLSECTIONS 1.5.2.2 Calculating the Values for GBLPAGES and GBLSECTIONS 1.5.2.2 Calculating the Values for GBLPAGES and GBLSECTIONS To install and run DEC OPS5, you must have sufficient free global pages and global sections. You must first find out how many free global pages and sections you have on your system. Then use AUTOGEN if you need to increase the GLBPAGES and GBLSECTIONS system parameters. If you are installing DEC OPS5 on a VMS Version 5.2 or later system, you can use the WRITE command with the F$GETSYI lexical function to find the number of free global pages and global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT): WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES") $ 15848 WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") $ 24 If the values displayed by the system are greater than the values in Table 1-3, you do not need to increase the values for these parameters. If the value of free global pages or global sections is less than the value in Table 1-3, you must increase the system parameter setting. Section 1.5.2.3 describes the procedures for increasing these values using AUTOGEN. 1.5.2.3 Changing System Parameter Values with AUTOGEN 1.5.2.3 Changing System Parameter Values with AUTOGEN 1.5.2.3 Changing System Parameter Values with AUTOGEN Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file: SYS$SYSTEM:MODPARAMS.DAT Use an editor to access the file. To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value. To add a new parameter, add a line to the file that includes both the name of the parameter and its value. For example: WSMAX = 1024 Preparing for DEC OPS5 Installation 1-6 1-6 1-6 To modify incremental parameters such as GBLPAGES and GBLSECTS, use ADD_. The following example increases the global page setting by 2000: ADD_GBLPAGES = 2000 Note that when you set the page file quota, do not use a value that exceeds the amount of page file space available on the system. After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. Enter the following command at the DCL prompt: @SYS$UPDATE:AUTOGEN GETDATA REBOOT @SYS$UPDATE:AUTOGEN GETDATA REBOOT @SYS$UPDATE:AUTOGEN GETDATA REBOOT $ When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect. The AUTOGEN Utility 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 qualifier on the AUTOGEN command line. For more information about using AUTOGEN, see the VMS System Management Subkit. 1.5.3 VMSINSTAL Requirements 1.5.3 VMSINSTAL Requirements 1.5.3 VMSINSTAL Requirements When you invoke VMSINSTAL, it checks the following: o Whether you have set your default device and directory to SYS$UPDATE o Whether you are logged into a privileged account o Whether you have adequate quotas for installation o Whether DECnet is running o Whether any users are logged into the system Note that VMSINSTAL requires that the installation account have a minimum of the following quotas: ASTLM = 24 BIOLM = 18 BYTLM = 18,000 Preparing for DEC OPS5 Installation 1-7 1-7 1-7 DIOLM = 18 ENQLM = 30 FILLM = 20 If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter to continue. To stop YES YES YES the installation process and correct the situation, enter or press Return. Then correct the problem and restart the NO NO NO installation. 1.5.4 Backing Up Your System Disk 1.5.4 Backing Up Your System Disk 1.5.4 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. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the VMS System Management Subkit. Preparing for DEC OPS5 Installation 1-8 1-8 1-8 2 2 2 ________________________________________________________________ Installing DEC OPS5 Installing DEC OPS5 Installing DEC OPS5 This chapter explains how to install DEC OPS5. The installation procedure section (see Section 2.1) contains a step-by-step description of the installation procedure. Error recovery (see Section 2.2) information is also provided. 2.1 The Installation Procedure 2.1 The Installation Procedure 2.1 The Installation Procedure The DEC OPS5 installation procedure consists of a series of questions and informational messages. See Appendix A for a sample installation. To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again. 1. Invoke VMSINSTAL. Invoke VMSINSTAL. Invoke VMSINSTAL. @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N $ To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. The following list defines the elements of the VMSINSTAL command procedure: saveset-name saveset-name saveset-name The installation name for the component. For DEC OPS5, use the following installation name: OPS040 OPS040 OPS040 device-name device-name device-name The name of the device on which you plan to mount the media. For example, MUA0: is the device name for a tape drive. It is not necessary to use the console drive for this installation. Installing DEC OPS5 2-1 2-1 2-1 However, if you do use the console drive, you should replace any media you removed once the installation is complete. OPTIONS N OPTIONS N OPTIONS N An optional parameter that indicates that you want to see the question on release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation in case they contain additional information about the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N. Note that there are several other options you can select when you invoke VMSINSTAL. o Auto_answer option (A): Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system). o Get saveset option (G): Lets you store product save sets temporarily on a magnetic tape or in a disk directory. o File log option (L): Logs all activity to the terminal during installation. o Alternate root option (R): Lets you install the product to a system root other than that of the running system. See the VMS documentation on software installation in the VMS System Management Subkit for detailed information on these options. If you specify more than one option, separate the options with commas (OPTIONS A,N). The following example invokes VMSINSTAL to install DEC OPS5 from tape drive MUA0: and shows the system response. This example uses the OPTIONS N release note parameter. @SYS$UPDATE:VMSINSTAL OPS040 MUA0: OPTIONS N @SYS$UPDATE:VMSINSTAL OPS040 MUA0: OPTIONS N @SYS$UPDATE:VMSINSTAL OPS040 MUA0: OPTIONS N $ VAX/VMS Software Product Installation Procedure V5.4 It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. Installing DEC OPS5 2-2 2-2 2-2 If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation. 2. Confirm system backup. Confirm system backup. Confirm system backup. * Are you satisfied with the backup of your system disk [YES]? VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, enter to discontinue NO NO NO the installation. After you back up your system disk, you can restart the installation. 3. Mount the media. Mount the media. Mount the media. Please mount the first volume of the set on MUA0:. YES YES YES * Are you ready? %MOUNT-I-MOUNTED, OPS040 MOUNTED ON _$$MUA0: (NODE 1) The following products will be processed: OPS5 V4.0 Beginning installation of OPS5 V4.0 at 20:01 %VMSINSTAL-I-RESTORE, Restoring product saveset A... You should now mount the first distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL then asks you if you are ready to continue with the installation. If you respond YES to indicate that you are ready, VMSINSTAL displays a message that the media containing DEC OPS5 has been mounted on the specified device and that the installation has begun. If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO NO NO in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/Y. Installing DEC OPS5 2-3 2-3 2-3 4. Select a release notes option. Select a release notes option. Select a release notes option. Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the four options for reviewing the release notes. If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C. If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: You can press Return to send the file to the default output print device, or you can enter another queue name. If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. Select option 4 if you have already reviewed the release notes and are restarting the installation. Next, VMSINSTAL displays the following question: YES YES YES * Do you want to continue the installation [N]?: %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. To continue the installation, enter . Otherwise, press YES YES YES Return. In either case, the release notes are copied to a file in the SYS$HELP directory: SYS$HELP:OPS$040.RELEASE_NOTES Installing DEC OPS5 2-4 2-4 2-4 After the installation, you can enter the following command to find out where the release notes are located through the Help facility: HELP OPS5 RELEASE_NOTES HELP OPS5 RELEASE_NOTES HELP OPS5 RELEASE_NOTES $ ___________________________ ___________________________ Note Note Note The name of the release notes file installed by VMSINSTAL consists of the current product name and version number. Do not delete release notes for previous versions of DEC OPS5. ___________________________________________________________ 5. Choose the level of capability you want to install. DEC OPS5 has an optional DECwindows Motif based windowing Development Environment. You can use DEC OPS5 without the Development Environment from DCL via a terminal or terminal emulator. Please indicate the level of capability that you want to install: 1. full capability (including Development Environment) 2. reduced capability (without Development Environment) * Enter the number of the level of capability to install [1]: If you select option 1, DEC OPS5 with the Development Environment installs. If you select option 2, DEC OPS5 installs without the Development Environment. To install the DEC OPS5 Development Environment you must have the VMS DECwindows Motif Compute Server and the VMS DECwindows Motif Device Support component installed during and after the DEC OPS5 installation. If you want to use the DEC OPS5 Development Environment later, you must install the VMS DECwindows Motif software and then reinstall the DEC OPS5 software. 6. Install examples, if desired. Install examples, if desired. Install examples, if desired. The procedure displays the following question: * Do you want to install OPS5 example files [YES]? Installing DEC OPS5 2-5 2-5 2-5 If you want to install DEC OPS5 examples, enter . Y Y Y In which directory are example files to be installed [SYS$COMMON:[VAXOPS]]: You can press Return to send the examples to the default directory or you can enter another directory name. 7. Install Structured Query Language (SQL) support, if desired. Install Structured Query Language (SQL) support, if desired. Install Structured Query Language (SQL) support, if desired. To use the DEC OPS5 SQL support, you must have VAX Rdb/VMS software installed during and after the DEC OPS5 installa- tion. If VAX Rdb/VMS is installed, you will be asked the following question: * Do you want SQL support for DEC OPS5 [YES]? If you want SQL support installed, enter . YES YES YES If you do not want SQL support installed, answer . NO NO NO If you want to use the DEC OPS5 SQL support in the future, you must install the VAX Rdb/VMS software and then reinstall the DEC OPS5 software. 8. Respond to license registration queries. Respond to license registration queries. Respond to license registration queries. Product: OPS5 or OPS5-COMPILER Producer: DEC Version: V4.0 Release Date: 1-APR-1992 * Does this product have an authorization key registered and loaded? If you have a DEC OPS5 Development Environment license, the product license name is . OPS5 OPS5 OPS5 If you have DEC OPS5 without the Development Environment, the product license name or will work. OPS5 OPS5-COMPILER OPS5 OPS5-COMPILER OPS5 OPS5-COMPILER The installation procedure displays license information about your product and then asks if you have registered and loaded your Product Authorization Key (PAK). If you have not registered and loaded your PAK, you should answer NO to this question. You have to register and load your PAK to successfully complete the installation. If you have not done so, you should stop the installation, register and load your PAK, and then restart the installation. Installing DEC OPS5 2-6 2-6 2-6 9. Choose the Installation Verification Procedure (IVP) option. Choose the Installation Verification Procedure (IVP) option. Choose the Installation Verification Procedure (IVP) option. * Do you want to run the IVP after the installation [YES]? The installation procedure now asks if you want to run the IVP. The IVP for DEC OPS5 checks to be sure that the installation is successful. It is recommended that you run the IVP. After DEC OPS5 is installed, you can run the IVP indepen- dently to verify that the software is available on your system. You might need to run the IVP after a system failure to make sure that users can access DEC OPS5. 10. Choose the installation directory. Choose the installation directory. Choose the installation directory. * In which directory is DEC OPS5 to be installed [SYS$COMMON:[VAXOPS]]: You can press Return to install the DEC OPS5 software in the default directory, SYS$COMMON:[VAXOPS]. Or enter the directory where you want to install DEC OPS5. The directory can reside on the system disk or any other disk that is permanently mounted. 11. Purge files. Purge files. Purge files. * Do you want to purge files replaced by this installation [YES]? You have the option to purge files from previous versions of DEC OPS5 that are superseded by this installation. Purging is recommended; however, if you need to keep files from the previous version, enter in response to the question. NO NO NO 12. Read informational messages. Read informational messages. Read informational messages. At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you chose to have files purged, that work is done now. The following messages are displayed: Installing DEC OPS5 2-7 2-7 2-7 %OPS-I-ASKED_ALL, No more questions will be asked. Depending on your processor type and system load, installation will take between 2 and 16 minutes. %OPS-I-INSTLCOMP, Installing the OPS5 compiler... %OPS-I-INSTLRTS, Installing the OPS5 run-time system... %OPS-I-ODELINK, Linking the development environment... %OPS-I-REMINDER, Include @SYS$STARTUP:OPS$STARTUP.COM in your system startup procedure. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Executing DEC OPS5 startup procedure... 13. Observe the installation Verification Procedure (IVP). Observe the installation Verification Procedure (IVP). Observe the installation Verification Procedure (IVP). If you chose to run the IVP, VMSINSTAL runs it now. When the IVP runs successfully, you see the following display: Executing DEC OPS5 startup procedure... %OPSCOMP-I-ENDCOMPILE, End of compilation 12-Jun-1992 10:46:20.31 %OPSCOMP-I-LINESREAD, Compiled 0 lines %OPSCOMP-I-NOERRORS, No errors detected %OPSCOMP-I-TIMEUSED, Time used was 0.23 seconds Beginning of DEC OPS5 V4.0 Installation Verification Procedure COMPILING THE OPS5 VALIDATION TEST . . . %OPS5IVP-S-PASSED, Test passed Successfully completed DEC OPS5 V4.0 Installation Verification Procedure 14. End the installation procedure. End the installation procedure. End the installation procedure. Installation of DEC OPS5 V4.0 completed at 10:50 VMSINSTAL procedure done at 10:50 The previous messages indicate that the entire installation procedure is complete. Installing DEC OPS5 2-8 2-8 2-8 You can now log out of the privileged account: LOGOUT LOGOUT LOGOUT $ SYSTEM logged out at 12-Jun-1992 10:57:19.44 Note that VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you will continue using the system manager's account and you want to restore these symbols, you should log out and log in again. 2.2 Error Recovery 2.2 Error Recovery 2.2 Error Recovery If errors occur during the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of DEC OPS5 V4.0 has failed. If the IVP fails, you see these messages: The DEC OPS5 V4.0 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for DEC OPS5 V4.0 has failed. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o A prerequisite software version is incorrect. o Quotas necessary for successful installation are insuffi- cient. o System parameter values for successful installation are insufficient. o The VMS help library is currently in use. o The product license has not been registered and loaded. For descriptions of the error messages generated by these conditions, see the VMS documentation on system messages, recovery procedures, and VMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. For information on installation requirements, see Chapter 1. Installing DEC OPS5 2-9 2-9 2-9 3 3 3 ________________________________________________________________ After Installing DEC OPS5 After Installing DEC OPS5 After Installing DEC OPS5 The following tasks take place after installing DEC OPS5: o Running the installation verification procedure separately (see Section 3.1) o Editing the system startup file (see Section 3.2) o Making the product usable on a VAXcluster (see Section 3.3) o Setting user account quotas (see Section 3.4) o Reporting problems (see Section 3.5) 3.1 Running the Installation Verification Procedure Separately 3.1 Running the Installation Verification Procedure Separately 3.1 Running the Installation Verification Procedure Separately You usually run the Installation Verification Procedure (IVP) during installation. Should system problems occur, run the IVP separately to ensure the integrity of installed files. To run the IVP, enter the following command: @SYS$TEST:OPS$IVP.COM @SYS$TEST:OPS$IVP.COM @SYS$TEST:OPS$IVP.COM $ 3.2 Editing the System Files 3.2 Editing the System Files 3.2 Editing the System Files You must edit the system startup file to provide for automatic startup of DEC OPS5 when your system is rebooted. Add the command line that starts DEC OPS5 to the system startup file, SYS$MANAGER:SYSTARTUP_V5.COM. The following example shows the DEC OPS5 startup command line: @SYS$STARTUP:OPS$STARTUP.COM @SYS$STARTUP:OPS$STARTUP.COM @SYS$STARTUP:OPS$STARTUP.COM $ After Installing DEC OPS5 3-1 3-1 3-1 3.3 VAXcluster Considerations 3.3 VAXcluster Considerations 3.3 VAXcluster Considerations If you want to run DEC OPS5 on multiple nodes of a VAXcluster, first check to see that you have the appropriate software license. Then, follow these steps after installing DEC OPS5: 1. Issue the LICENSE LOAD command to activate the license on each node in the cluster on which DEC OPS5 is to be executed, as described in the . ___ _______ __________ _______ ______ VMS License Management Utility Manual 2. Run SYS$STARTUP:OPS$STARTUP.COM on each node that has a soft- ware license, and edit each system's SYS$MANAGER:SYSTARTUP_ V5.COM to include the following command line: @SYS$STARTUP:OPS$STARTUP @SYS$STARTUP:OPS$STARTUP @SYS$STARTUP:OPS$STARTUP $ 3. Replace the version of the DCL tables that is installed on each node that has a software license. To do this, perform the following steps: a. Log in to a node on the cluster. b. Run INSTALL and enter the following command at the INSTALL> prompt: REPLACE SYS$LIBRARY:DCLTABLES.EXE REPLACE SYS$LIBRARY:DCLTABLES.EXE REPLACE SYS$LIBRARY:DCLTABLES.EXE INSTALL> c. Repeat steps a and b for each node that has a software license. 3.4 User Account Requirements 3.4 User Account Requirements 3.4 User Account Requirements To work with DEC OPS5, user accounts on your system must have certain privileges and quotas. The next two sections contain information on these requirements. 3.4.1 Privileges 3.4.1 Privileges 3.4.1 Privileges To use DEC OPS5, each account must have at least the TMPMBX and NETMBX privileges. Use the VMS Authorize Utility to determine whether users have the privileges they require. After Installing DEC OPS5 3-2 3-2 3-2 3.4.2 User Account Quotas 3.4.2 User Account Quotas 3.4.2 User Account Quotas To use DEC OPS5, you must make sure that the appropriate user accounts have sufficient quotas. Table 3-1 summarizes the required user account quotas. ________________________________________________________________ Table 3-1 User Account Quotas for Using DEC OPS5 Table 3-1 User Account Quotas for Using DEC OPS5 Table 3-1 User Account Quotas for Using DEC OPS5 Account Account Account ________________________________________________________________ Quota Value Quota Value Quota Value ASTLM 150 BIOLM 100 BYTLM 64000 DIOLM 50 ENQLM 1000 FILLM 100 ________________________________________________________________ JTQUOTA 8192 3.4.3 Installing DEC OPS5 as a Shared Image 3.4.3 Installing DEC OPS5 as a Shared Image 3.4.3 Installing DEC OPS5 as a Shared Image To reduce system overhead and memory requirements, the following images are automatically installed as shared images: o OPSINTERP.EXE o OPS5.EXE o OPS$ENV.EXE o OPS$MSG.EXE o OPS$SQL_RTL.EXE (if you installed SQL support) 3.5 Determining and Reporting Problems 3.5 Determining and Reporting Problems 3.5 Determining and Reporting Problems If you encounter a problem while using DEC OPS5, 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. o Submit a Software Performance Report (SPR). After Installing DEC OPS5 3-3 3-3 3-3 o Fill out and submit a Reader's Comment form if the problem concerns the DEC OPS5 documentation. There is a Reader's Comment form at the back of each manual. Use the form from the manual in which you found the error. Include the section and page number. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of 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. After Installing DEC OPS5 3-4 3-4 3-4 A A A ________________________________________________________________ Sample Installation Sample Installation Sample Installation This appendix contains a sample installation of DEC OPS5. This sample was run on a system that had no previous version of DEC OPS5 installed. The system did not have VAX Rdb/VMS installed. Depending on which layered products your system includes, you might see additional messages and questions when you install your software. The sample installation assumes that no users are logged on to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation. See Section A.1 to see the sample installation. A.1 Full Development Kit A.1 Full Development Kit A.1 Full Development Kit This section contains a sample installation for the DEC OPS5 full development kit. SYSTEM SYSTEM SYSTEM Username: Password: Welcome to VAX/VMS version V5.4 on node NODE1 Last interactive login on Monday, 4-MAY-1992 10:13 Last noninteractive login on Tuesday, 5-MAY-1992 6:40 SET DEFAULT SYS$UPDATE SET DEFAULT SYS$UPDATE SET DEFAULT SYS$UPDATE $ @VMSINSTAL OPS040 MUA0: OPTIONS N @VMSINSTAL OPS040 MUA0: OPTIONS N @VMSINSTAL OPS040 MUA0: OPTIONS N $ VAX/VMS Software Product Installation Procedure V5.4 It is 5-MAY-1992 at 10:34. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: Sample Installation A-1 A-1 A-1 OPS V4.0 Beginning installation of OPS V4.0 at 10:34 %VMSINSTAL-I-RESTORE, Restoring product saveset A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: LN03_2F3 LN03_2F3 LN03_2F3 * Queue name [SYS$PRINT]: Job OPS$040 (queue LN03_2F3, entry 68) started on LN03_2F3 YES YES YES * Do you want to continue the installation? Installing OPS5 V4.0 %OPS-I-NOSQL, VAX Rdb/VMS V3.1 (or later) is not installed on this system. It will not be possible to link applications which use OPS SQL actions without VAX Rdb/VMS software being present during the DEC OPS5 installation. If you wish to use OPS SQL actions in the future, DEC OPS5 will have to be reinstalled after installing VAX Rdb/VMS. DEC OPS5 may be purchased with a full capability license (OPS5) that includes use of the OPS5 Development Environment, or with a reduced capability license (OPS5-COMPILER) that authorizes use of the compiler only. * Please indicate the level of capability that you want to install: 1. full capability (including Development Environment) 2. reduced capability (without Development Environment) 1 1 1 * Enter the number of the level of capability to install [1]: Product: OPS5 Producer: DEC Version: 4.0 Release Date: 1-APR-1992 * Does this product have an authorization key registered and loaded [YES]? YES * Do you want to run the IVP after the installation [YES]? YES Sample Installation A-2 A-2 A-2 * In which directory is DEC OPS5 to be installed [SYS$COMMON:[VAXOPS]]: * In which directory are example files to be installed [SYS$COMMON:[VAXOPS.EXAMPLES]]: %VMSINSTAL-I-SYSDIR, This product creates system disk directory SYS$COMMON:[VAXOPS.EXAMPLES]. * Do you want to purge files replaced by this installation [YES]? %OPS-I-ASKED_ALL, No more questions will be asked. Depending on your processor type and system load, installation will take between 2 and 16 minutes. %OPS-I-INSTLCOMP, Installing the OPS5 compiler... %OPS-I-INSTLRTS, Installing the OPS5 run-time system... %OPS-I-ODELINK, Linking the development environment... %OPS-I-REMINDER, Include @SYS$STARTUP:OPS$STARTUP.COM in your system startup procedure. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Executing DEC OPS5 startup procedure... Beginning of DEC OPS5 V4.0 Installation Verification Procedure COMPILING THE OPS5 VALIDATION TEST %OPSCOMP-I-ENDCOMPILE, End of compilation 5-MAY-1992 10:40:07.72 %OPSCOMP-I-LINESREAD, Compiled 1121 lines %OPSCOMP-I-NOERRORS, No errors detected %OPSCOMP-I-TIMEUSED, Time used was 21.41 seconds TEST REFRACTION %OPS5IVP-S-PASSED, Test passed TEST THAT THINGS CAN BE REMOVED FROM THE CONFLICT SET CORRECTLY %OPS5IVP-S-PASSED, Test passed TEST RULES WITH NO VARIABLES AND MORE THAN ONE CE %OPS5IVP-S-PASSED, Test passed TEST SPECIAL CASE %OPS5IVP-S-PASSED, Test passed TEST SORTING OF TIME TAGS %OPS5IVP-S-PASSED, Test passed TEST RECENCY %OPS5IVP-S-PASSED, Test passed Sample Installation A-3 A-3 A-3 TEST MEA STRATEGY %OPS5IVP-S-PASSED, Test passed TEST MATCHING SYMBOLIC ATOMS FOR EQUALITY %OPS5IVP-S-PASSED, Test passed TEST '^' IN LHS %OPS5IVP-S-PASSED, Test passed TEST MATCHING SYMBOLIC ATOMS FOR INEQUALITY %OPS5IVP-S-PASSED, Test passed TEST MATCHING SYMBOLIC ATOMS FOR TYPE EQUALITY %OPS5IVP-S-PASSED, Test passed TEST MATCHING NUMERIC ATOMS FOR EQUALITY %OPS5IVP-S-PASSED, Test passed TEST MATCHING NUMERIC ATOMS FOR INEQUALITY %OPS5IVP-S-PASSED, Test passed TEST MATCHING NUMERIC ATOMS FOR TYPE EQUALITY %OPS5IVP-S-PASSED, Test passed TEST MATCHING NUMERIC ATOMS USING LESS-THAN PREDICATE %OPS5IVP-S-PASSED, Test passed TEST MATCHING NUMERIC ATOMS USING LESS-OR-EQUAL PREDICATE %OPS5IVP-S-PASSED, Test passed TEST MATCHING NUMERIC ATOMS USING GREATER-OR-EQUAL PREDICATE %OPS5IVP-S-PASSED, Test passed TEST MATCHING NUMERIC ATOMS USING GREATER-THAN PREDICATE %OPS5IVP-S-PASSED, Test passed TEST THAT NO NUMERIC TESTS ALLOW SYMBOLIC ARGUMENTS %OPS5IVP-S-PASSED, Test passed TEST CONJUNCTIONS { } %OPS5IVP-S-PASSED, Test passed Sample Installation A-4 A-4 A-4 TEST DISJUNCTIONS << >> %OPS5IVP-S-PASSED, Test passed TEST EQUALITY FOR VARIABLES THAT OCCUR IN ONLY ONE CE %OPS5IVP-S-PASSED, Test passed TEST INEQUALITY FOR VARIABLES THAT OCCUR IN ONLY ONE CE %OPS5IVP-S-PASSED, Test passed TEST TYPE EQUALITY FOR VARIABLES THAT OCCUR IN ONLY ONE CE %OPS5IVP-S-PASSED, Test passed TEST LESS-THAN PREDICATE FOR VARIABLES THAT OCCUR IN ONLY ONE CE %OPS5IVP-S-PASSED, Test passed TEST LESS-OR-EQUAL PREDICATE FOR VARIABLES THAT OCCUR IN ONLY ONE CE %OPS5IVP-S-PASSED, Test passed TEST GREATER-OR-EQUAL PREDICATE FOR VARIABLES THAT OCCUR IN ONLY ONE CE %OPS5IVP-S-PASSED, Test passed TEST GREATER-THAN PREDICATE FOR VARIABLES THAT OCCUR IN ONLY ONE CE %OPS5IVP-S-PASSED, Test passed TEST EQUALITY OF VARIABLES OCCURRING IN MORE THAN ONE CE %OPS5IVP-S-PASSED, Test passed TEST INEQUALITY OF VARIABLES OCCURRING IN MORE THAN ONE CE %OPS5IVP-S-PASSED, Test passed TEST TYPE EQUALITY OF VARIABLES OCCURRING IN MORE THAN ONE CE %OPS5IVP-S-PASSED, Test passed TEST LESS-THAN PREDICATE FOR VARIABLES OCCURRING IN MORE THAN ONE CE %OPS5IVP-S-PASSED, Test passed TEST LESS-OR-EQUAL PREDICATE FOR VARIABLES OCCURRING IN MORE THAN ONE CE %OPS5IVP-S-PASSED, Test passed TEST GREATER-OR-EQUAL PREDICATE FOR VARIABLES OCCURRING IN MORE THAN ONE CE %OPS5IVP-S-PASSED, Test passed Sample Installation A-5 A-5 A-5 TEST GREATER-THAN PREDICATE FOR VARIABLES OCCURRING IN MORE THAN ONE CE %OPS5IVP-S-PASSED, Test passed TEST MEMORIES -- CAN INSTANTIATIONS BE DELETED PROPERLY %OPS5IVP-S-PASSED, Test passed TEST MAKE AND ALL ITS POSSIBLE ARGUMENTS %OPS5IVP-S-PASSED, Test passed TEST 2-INPUT NODES FOR NEGATED CES %OPS5IVP-S-PASSED, Test passed TEST REMOVE %OPS5IVP-S-PASSED, Test passed TEST MODIFY %OPS5IVP-S-PASSED, Test passed TEST BIND %OPS5IVP-S-PASSED, Test passed TEST HALT %OPS5IVP-S-PASSED, Test passed TEST CBIND %OPS5IVP-S-PASSED, Test passed TEST DEFAULT FILES FOR I/O %OPS5IVP-S-PASSED, Test passed TEST EXPLICIT FILES FOR I/O %OPS5IVP-S-PASSED, Test passed ROUGH TEST OF TABTO AND RJUST %OPS5IVP-S-PASSED, Test passed Successfully completed DEC OPS5 V4.0 Installation Verification Procedure Installation of OPS V4.0 completed at 10:49 VMSINSTAL procedure done at 10:49 LO LO LO $ SYSTEM logged out at 5-MAY-1992 10:57:19.44 Sample Installation A-6 A-6 A-6 B B B ________________________________________________________________ Files and Logical Names Installed on Your System Files and Logical Names Installed on Your System Files and Logical Names Installed on Your System The DEC OPS5 installation procedure installs a number of files on your system and defines some logical names. Section B.1 lists the files created on your system. Section B.2 lists the logical names that are added to the system logical name table. B.1 File Names B.1 File Names B.1 File Names Table B-1 contains the names of all files created on your system when DEC OPS5 is installed. ________________________________________________________________ Table B-1 Installed DEC OPS5 Files Table B-1 Installed DEC OPS5 Files Table B-1 Installed DEC OPS5 Files ________________________________________________________________ Directory File Description Directory File Description Directory File Description OPS$LIBRARY BLI32OPS5.REQ Obsolescent BLISS header file OPS$LIBRARY OPS$CE_VAR_ Migration tool FILTER.EXE OPS$LIBRARY OPS$ENV.EXE DEC OPS5 Development Environment image OPS$LIBRARY OPS$QUOTE_FILTER.EXE Migration tool OPS$LIBRARY OPS5.EXE DEC OPS5 compiler OPS$LIBRARY OPSDEF.ADA Obsolescent language specific header file OPS$LIBRARY OPSDEF.BAS Obsolescent language specific header file OPS$LIBRARY OPSDEF.FOR Obsolescent language specific header file (continued on next page) Files and Logical Names Installed on Your System B-1 B-1 B-1 ________________________________________________________________ Table B-1 (Cont.) Installed DEC OPS5 Files Table B-1 (Cont.) Installed DEC OPS5 Files Table B-1 (Cont.) Installed DEC OPS5 Files ________________________________________________________________ Directory File Description Directory File Description Directory File Description OPS$LIBRARY OPSDEF.H Obsolescent language specific header file OPS$LIBRARY OPSDEF.PAS Obsolescent language specific header file OPS$LIBRARY OPSINTERP.EXE DEC OPS5 sharable run-time library OPS$LIBRARY OPSINTERP.HLB Command Online Help OPS$LIBRARY OPSINTERP.OLB DEC OPS5 run-time library OPS$LIBRARY OPSINTERP.OPT Linker options file OPS$LIBRARY OPS_IVP_EXTERNAL.BLI Installation verification source OPS$LIBRARY OPS_IVP_EXTERNAL.OBJ Installation verification object OPS$LIBRARY OPS_IVP_MAIN.OPS Installation verification source OPS$LIBRARY OPS_RTL_FOR_NAS.OLB NAS lower case entry point library OPS$LIBRARY VAXCRTL.OPT C run-time library options file SYS$HELP HELPLIB.HLB updated SYS$HELP OPSO40.RELEASE_NOTES Release notes SYS$LIBRARY DCLTABLES.EXE updated SYS$LIBRARY OPS_RTL.ADA Language specific header files SYS$LIBRARY OPS_RTL.BAS Language specific header files SYS$LIBRARY OPS_RTL.FOR Language specific header files SYS$LIBRARY OPS_RTL.H Language specific header files (continued on next page) Files and Logical Names Installed on Your System B-2 B-2 B-2 ________________________________________________________________ Table B-1 (Cont.) Installed DEC OPS5 Files Table B-1 (Cont.) Installed DEC OPS5 Files Table B-1 (Cont.) Installed DEC OPS5 Files ________________________________________________________________ Directory File Description Directory File Description Directory File Description SYS$LIBRARY OPS_RTL.PAS Language specific header files SYS$LIBRARY OPS_RTL.PLI Language specific header files SYS$LIBRARY OPS_RTL.R32 Language specific header files SYS$MESSAGE OPS$MSG.EXE Message file SYS$STARTUP OPS$STARTUP.COM System initialization procedure SYS$TEST OPS$IVP.COM Installation Verification Procedure OPS$EXAMPLES CALLIN_C.C Example files OPS$EXAMPLES CALLIN_COBOL.COB Example files OPS$EXAMPLES CALLIN_OPS.OPS Example files OPS$EXAMPLES FARMER_V3.OPS Example files OPS$EXAMPLES FARMER_V4.OPS Example files OPS$EXAMPLES HANOI_V3.OPS Example files OPS$EXAMPLES HANOI_V4.OPS Example files OPS$EXAMPLES KIWI.OPS Example files OPS$EXAMPLES KIWIBUILD.COM Example files OPS$EXAMPLES KIWIMOTIF.C Example files OPS$EXAMPLES KIWIMOTIF.H Example files OPS$EXAMPLES KIWIMOTIF.OPT Example files OPS$EXAMPLES KIWIMOTIF.UIL Example files OPS$EXAMPLES KIWIMOTIF_GLUE.C Example files OPS$EXAMPLES KIWIMOTIF_RULES.OPS Example files OPS$EXAMPLES KIWISQL.OPS Example files (continued on next page) Files and Logical Names Installed on Your System B-3 B-3 B-3 ________________________________________________________________ Table B-1 (Cont.) Installed DEC OPS5 Files Table B-1 (Cont.) Installed DEC OPS5 Files Table B-1 (Cont.) Installed DEC OPS5 Files ________________________________________________________________ Directory File Description Directory File Description Directory File Description OPS$EXAMPLES KIWISQL.OPT Example files OPS$EXAMPLES KIWISQL.SQL Example files OPS$EXAMPLES MAKE_KWM_FOR_VMS.MMS Example files OPS$EXAMPLES TOURNEY_V3.OPS Example files OPS$EXAMPLES TOURNEY_V4.OPS Example files ________________________________________________________________ ________________________________________________________________ Development Environment Only Development Environment Only Development Environment Only OPS$LIBRARY OPS$EDITOR.TPU TPU customizations OPS$LIBRARY OPS$EDITOR_ Customized TPU utilities CALLUSER.EXE library OPS$LIBRARY OPS$EDIT_FILE.COM Editor startup OPS$LIBRARY OPS$ENV.DECW$BOOK Online Help OPS$LIBRARY OPS$ENV.UID User interface description file OPS$LIBRARY OPS$RUN_IMAGE.COM Image information procedure ________________________________________________________________ ________________________________________________________________ SQL Support Only SQL Support Only SQL Support Only ________________________________________________________________ OPS$LIBRARY OPS$SQL_RTL.EXE Shared library for SQL B.2 Logical Names B.2 Logical Names B.2 Logical Names Table B-2 lists the logical names entered into the system logical name table when DEC OPS5 is installed. These names are stored in the product's startup file. They are automatically entered into the system logical name table whenever the system reboots or whenever the software is invoked. Files and Logical Names Installed on Your System B-4 B-4 B-4 ________________________________________________________________ Table B-2 Logical Names Table B-2 Logical Names Table B-2 Logical Names ________________________________________________________________ Logical Name Default Value Description Logical Name Default Value Description Logical Name Default Value Description OPS5SHR OPS$LIBRARY:OPS5 Compiler OPSINTERP OPS$LIBRARY:OPSINTERP Run-time system shareable image, object library, and options file OPS$LIBRARY SYS$COMMON:[VAXOPS] Directory containing OPS files OPS$MSG SYS$MESSAGE:OPS$MSG Run-time system message file OPS$SQL_RTL OPS$LIBRARY:OPS$SQL_RTL SQL support RTL shareable image OPS$EXAMPLES SYS$COMMON:[VAXOPS.EXAMPLES] Directory containing OPS ________________________________________________________________ Examples Files and Logical Names Installed on Your System B-5 B-5 B-5 ________________________________________________________________ Index Index Index A A A DEC OPS5 software __________________________ Documentation set Authorization key (cont'd) License PAK list of manuals in, ___ See AUTOGEN command procedure vi changing system related manuals, vi parameters with, installing examples, 2-5 1-6 installing shared images Automatic startup , 3-3 providing, 3-1 installing without the Development __________________________ B B B Environment, 2-5 optional software for, Backups, 1-8, 2-3 1-2 Bill of materials, 1-1 prerequisites for, 1-2 __________________________ C C C product license name, 2-6 Conventions, vii providing automatic D D D startup, 3-1 __________________________ running on VAXcluster, DEC OPS5 software 3-2 choosing installation Device-name, 2-1 directory, 2-7 Disk Development Environment backing up, 1-8, 2-3 installing, 2-5 requirements (table), installing later, 1-2 1-4 prerequisites for, Disk space 1-2 free, how to determine, product license name, 1-4 2-6 Documentation set Index-1 Index-1 Index-1 Installation (cont'd) __________________________ E E E stopping, 2-1 time, 1-4 Errors Installation Verification ___ ____ See also Troubleshooting Procedure conditions leading to, 2-9 IVP ___ See installation, 2-9 IVP Examples failure, 2-9 installing, 2-5 licenses and, 1-3 messages, 2-9 __________________________ F F F running, 2-7 running separately, 3-1 Files successful message, 2-8 editing, 3-1 when to run, 2-7 list of DEC OPS5 (table) L L L , B-1 __________________________ list of Development License Environment (table), registering, 1-3 B-4 registering on several list of SQL (table), B-4 nodes, 1-3 purging, 2-7 LICENSE LOAD command, 3-2 __________________________ G G G License Management Facility GBLPAGES LMF ___ See calculating values for, License PAK 1-6 how to get, 1-3 GBLSECTIONS optional software and, calculating values for, 1-3 1-6 prerequisite software __________________________ H H H and, 1-3 registering, 1-3 Hardware registering on several prerequisites (list), nodes, 1-3 1-2 when to register, 1-3 I I I License Product __________________________ Authorization Key Installation License PAK ___ See aborting, 2-1 LMF device-name, 2-1 installing on newly installation name, 2-1 licensed node, 1-3 length, 1-4 using, 1-3 saveset-name, 2-1 starting, 2-1 Index-2 Index-2 Index-2 Logical names __________________________ R R R list of DEC OPS5 (table) , B-4 Reader's comment form, 3-4 __________________________ M M M Release notes displaying, 2-4 Media how to get, 2-2 mounting, 2-3 location, 2-4 Messages OPTIONS N, 2-2 error, 2-9 printing, 2-4 informational, 2-7 installation complete, __________________________ S S S 2-8 IVP, 2-9 Sample installation, A-1 successful, 2-8 Shared image DEC OPS5, 3-3 __________________________ N N N Software operating system, 1-2 Nodes prerequisites (table), running DEC OPS5 on, 3-2 1-2 __________________________ O O O required, 1-2 required classes, 1-1 OPTIONS N parameter required version numbers release notes and, 2-2 , 1-2 P P P Software Performance __________________________ Report PAK SPR ___ See License PAK Software Product ___ See Privileges, 3-2 Description Problems SPD ___ See determining, 3-3 Software Support Addendum reporting, 3-3 SSA ___ See Product license name SPD DEC OPS5 compiler, 2-6 reporting nonconformance DEC OPS5 Development problems, 3-4 Environment, 2-6 SPR __________________________ Q Q Q reporting problems, 3-3 SQL Quotas installing later, 1-2 user account, 3-3 installing support for, 2-6 prerequisite, 1-2 Index-3 Index-3 Index-3 VMS DECwindows Motif SSA hardware prerequisites software prerequisite, 1-2 and, 1-2 VMSINSTAL command Structured Query Language procedure ___ See SQL invoking, 2-1 SYS$HELP parameter release notes and, 2-4 alternate root option System failure, 2-7 , 2-2 System parameters auto_answer option, adding, 1-6 2-2 calculating values for, file log option, 2-2 1-6 get saveset option, changing values with 2-2 AUTOGEN, 1-6 release notes option, checking, 1-5 2-2 minimum required (table) quota requirements, 1-7 , 1-5 VMS software modifying, 1-7 prerequisite, 1-2 System startup files editing, 3-1 __________________________ W W W __________________________ T T T Warranty, 3-4 Tape mounting, 2-3 Troubleshooting of error conditions, 2-9 __________________________ U U U User accounts privileges, 3-2 quotas, 3-3 quotas (table), 3-3 requirements, 3-2 __________________________ V V V VAXcluster DEC OPS5 and, 3-2 LICENSE LOAD command and, 3-2 VAX Rdb/VMS software prerequisite, 1-2 SQL support and, 2-6 Index-4 Index-4 Index-4