____________________________________________________ COM for OpenVMS Installation Guide January 1999 This document contains instructions on installing COM Version 1.0 for OpenVMS. Revision/Update Information: This is a new manual. Software Version: OpenVMS Alpha Version 7.2 Microsoft Windows NT 4.0 SP3 Compaq Computer Corporation Houston, Texas ________________________________________________________________ January 1999 Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor. Compaq conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community. (c© Compaq Computer Corporation 1998. All rights reserved. This product includes software licensed from Microsoft Corporation. Copyright © Microsoft Corporation, 1991-1997. All rights reserved. This product includes software licensed from Bristol Technology, Inc. Copyright © Bristol Technology, Inc, 1990-1997. All rights reserved. The following are trademarks of Compaq Computer Corporation: Alpha, Compaq, DECdirect, DIGITAL, DIGITAL UNIX, OpenVMS, POLYCENTER, VAX, VAXcluster, VMS, and the Compaq logo. The following are third-party trademarks: Adobe, Display POSTSCRIPT, and POSTSCRIPT are registered trademarks of Adobe Systems Incorporated. Apple, Mac, Macintosh, and Power Macintosh are registered trademarks of Apple Computer, Inc. AT&T is a registered trademark of the American Telephone and Telegraph Company. BITSTREAM is a registered trademark of Bitstream, Inc. Compaq is a registered trademark of Compaq Computer Corporation. Microsoft, MS, MS-DOS, Win32, Windows, and Windows NT are registered trademarks, and NT and Windows 95 are trademarks of Microsoft Corporation. Motif, OSF, OSF/1, and OSF/Motif are registered trademarks of The Open Group. Unicode is a registered trademark of Unicode, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd. Wind/U is a registered trademark of Bristol Technology, Inc. All other trademarks and registered trademarks are the property of their respective holders. The Compaq OpenVMS documentation set is available on CD-ROM. 15-DEC-1998 13:02:35.28 _________________________________________________________________ Contents Preface................................................... v 1 Installing the COM for OpenVMS Kit 1.1 Contents of the COM Version 1.0 for OpenVMS Kit........................................... 1-1 1.2 Prerequisites................................. 1-2 1.3 Preinstallation............................... 1-2 1.3.1 Configuring DIGITAL TCP/IP Services for OpenVMS................................... 1-2 1.3.2 Starting DIGITAL TCP/IP Services for OpenVMS................................... 1-3 1.3.3 Configuring OpenVMS UCX................... 1-3 1.3.4 Starting OpenVMS UCX...................... 1-3 1.4 Installing COM for OpenVMS.................... 1-4 1.5 Starting COM for OpenVMS Automatically after a Reboot........................................ 1-5 1.6 COM for OpenVMS Postinstallation Procedures... 1-6 Index Examples 1-1 Sample COM for OpenVMS Installation....... 1-5 iii _________________________________________________________________ Preface Related Documents For additional information on the Open Systems Software Group (OSSG) products and services, access the Compaq OpenVMS World Wide Web site with the following address: www.compaq.com/openvms Reader's Comments Compaq welcomes your comments on this manual. Print or edit the online form SYS$HELP:OPENVMSDOC_ COMMENTS.TXT and send us your comments by: Internet openvmsdoc@zko.mts.dec.com Fax 603 884-0120, Attention: OSSG Documentation, ZKO3-4/U08 Mail OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 How To Order Additional Documentation Use the following World Wide Web address to order additional documentation: www.openvms.digital.com:81/ If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825). v Conventions In this manual, any reference to OpenVMS is synonymous with Compaq OpenVMS. VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references to OpenVMS Clusters or clusters in this document are synonymous with VMSclusters. In this manual, every use of DECwindows and DECwindows Motif refers to DECwindows Motif for OpenVMS software. The following conventions are also used in this manual: Ctrl/x A sequence such as Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button. PF1 x A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button. In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets, rather than a box. . . . A horizontal ellipsis in examples indicates one of the following possibilities: o Additional optional arguments in a statement have been omitted. o The preceding item or items can be repeated one or more times. o Additional parameters, values, or other information can be entered. vi . A vertical ellipsis indicates the omission . of items from a code example or command . format; the items are omitted because they are not important to the topic being discussed. ( ) In command format descriptions, parentheses indicate that you must enclose the options in parentheses if you choose more than one. [ ] In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.) [|] In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options. { } In command format descriptions, braces indicate required elements; you must choose one of the options listed. text style This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason. In the HTML version of this document, this convention appears as italic text. italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER=name), and in command parameters in text (where dd represents the predefined code for the device type). vii UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege. Monospace type indicates code examples and Monospace type interactive screen displays. In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example. - A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line. numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes-binary, octal, or hexadecimal-are explicitly indicated. viii 1 _________________________________________________________________ Installing the COM for OpenVMS Kit This chapter provides a list of the contents of the COM for OpenVMS kit, a list of prerequsite software, and a preinstallation requirements. It also describes how to install COM for OpenVMS, and includes postinstallation instructions. 1.1 Contents of the COM Version 1.0 for OpenVMS Kit COM Version 1.0 for OpenVMS is an unauthenticated implementation-that is, COM Version 1.0 for OpenVMS makes no security checks to authenticate or validate client requests within a server. Do not use COM Version 1.0 for OpenVMS in an environment that requires secure COM. COM Version 1.1 for OpenVMS will implement NTLM authentication and will authenticate requests between a COM client and a COM server. For more information about COM for OpenVMS security, see the security section of the Release Notes (Chapter 1) in the OpenVMS Connectivity Developer Guide. The COM Version 1.0 for OpenVMS contains the following: o Software - COM for OpenVMS Run-Time libraries - COM for OpenVMS MIDL compiler and header files - COM for OpenVMS configuration utilities o Documentation - OpenVMS Connectivity Developer Guide (in PostScript, HTML, and PDF formats) Installing the COM for OpenVMS Kit 1-1 Installing the COM for OpenVMS Kit 1.2 Prerequisites 1.2 Prerequisites The following software is required: o For OpenVMS systems - OpenVMS Version 7.2 or higher - DEC C Version 5.6 or higher and DEC C++ Version 5.6 or higher (for COM for OpenVMS application development) - OpenVMS UCX Version 4.1-12 ECO2 or higher or DIGITAL TCP/IP Services for OpenVMS Version 5.0 o For Windows[R] NT[TM] systems - Windows NT 4.0 with Service Pack 3 installed - Microsoft[R] Visual C++ (for Windows NT client development and information on MIDL compiler.) See the Microsoft website for compiler version requirements. - TCP/IP enabled (needed for OpenVMS connectivity) 1.3 Preinstallation Before you install COM for OpenVMS, you must configure and start TCP/IP services. The following sections describe how to configure and start OpenVMS UCX and DIGITAL TCP/IP Services for OpenVMS. If your system is running DIGITAL TCP/IP Services for OpenVMS, you need to read Section 1.3.1 and Section 1.3.2 only. If your system is running OpenVMS UCX, you need to read Section 1.3.3 and Section 1.3.4 only. 1.3.1 Configuring DIGITAL TCP/IP Services for OpenVMS If your OpenVMS system is running OpenVMS Version 7.2 and DIGITAL TCP/IP Services for OpenVMS Version 5.0, you do not need to configure DIGITAL TCP/IP Services for OpenVMS to work with OpenVMS DCE/RPC. The system automatically checks and adjusts the parameters as necessary. 1-2 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.3 Preinstallation 1.3.2 Starting DIGITAL TCP/IP Services for OpenVMS Use the following command to start DIGITAL TCP/IP Services for OpenVMS: $ @SYS$STARTUP:TCPIP$STARTUP 1.3.3 Configuring OpenVMS UCX If your OpenVMS system is running OpenVMS Version 7.2 and OpenVMS UCX Version 4.1-12 or higher, you must configure UCX values for OpenVMS DCE/RPC. When OpenVMS DCE/RPC starts, it checks that it has the required UCX parameters. If the values are correct, OpenVMS DCE/RPC starts. If the values are not correct, OpenVMS DCE/RPC displays the command needed to fix the problem, and asks whether you want to continue OpenVMS DCE/RPC startup. The UCX commands to set the required OpenVMS DCE/RPC parameters are as follows: $ UCX SET PROTOCOL TCP /NODELAY $ UCX SET CONFIGURATION PROTOCOL TCP /NODELAY $ UCX SET PROTOCOL TCP /NOLOOPBACK $ UCX SET CONFIGURATION PROTOCOL TCP /NOLOOPBACK $ UCX SET COMMUNICATION/LARGE=(MAXIMUM:200) $ UCX SET CONFIGURATION COMMUNICATION/LARGE=(MAXIMUM:200) $ UCX SET COMMUNICATION/SMALL=(MAXIMUM:600) $ UCX SET CONFIGURATION COMMUNICATION/SMALL=(MAXIMUM:600) $ UCX SET COMMUNICATION /DEVICE_SOCKETS=250 $ UCX SET CONFIGURATION COMMUNICATION/DEVICE_SOCKETS=250 1.3.4 Starting OpenVMS UCX Use the following command to start OpenVMS UCX Version 4.1-12 or higher: $ @SYS$STARTUP:UCX$STARTUP Installing the COM for OpenVMS Kit 1-3 Installing the COM for OpenVMS Kit 1.4 Installing COM for OpenVMS 1.4 Installing COM for OpenVMS The COM for OpenVMS installation kit contains a single POLYCENTER Software Installation file. The name of the kit is DEC-AXPVMS-DCOM-V0100--1.PCSI. You must install the COM for OpenVMS files on an OpenVMS Alpha Version 7.2 system. To install COM for OpenVMS, invoke the POLYCENTER Software Installation utility using the following command: $ PRODUCT INSTALL /SOURCE=device:[user] DCOM For device:[user], specify the device name and directory location of the kit. ________________ MIDL compiler license ________________ The COM for OpenVMS MIDL compiler requires a license. Compaq provides the DCOM-MIDL PAK separately from the COM for OpenVMS kit. ______________________________________________________ Example 1-1 shows a sample installation. 1-4 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.4 Installing COM for OpenVMS Example 1-1 Sample COM for OpenVMS Installation $ PRODUCT INSTALL /SOURCE=device:[user] DCOM The following product has been selected: DEC AXPVMS DCOM V1.0 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DCOM V1.0 Copyright (c© Compaq Computer Corporation 1998. All rights reserved. Do you want the defaults for all options? [YES] The following requirements must be met prior to installing OpenVMS DCOM - You must be running OpenVMS Alpha V7.2 or later - You must be running UCX V4.1-12 ECO2 or later - You must be running OpenVMS DCE RPC - In order to use the DCOM MIDL compiler you must install the DCOM-MIDL License PAK Do you want to continue? [YES] Do you want to review the options? [NO] Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DCOM V1.0 DISK$COSMOS_SYS:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...80%...90%...100% The following product has been installed: DEC AXPVMS DCOM V1.0 Layered Product $ 1.5 Starting COM for OpenVMS Automatically after a Reboot Compaq recommends that you modify the SYS$MANAGER:SYLOGICALS.COM command file to control COM for OpenVMS startup. Installing the COM for OpenVMS Kit 1-5 Installing the COM for OpenVMS Kit 1.5 Starting COM for OpenVMS Automatically after a Reboot OpenVMS Version 7.2 includes a revised SYLOGICALS.TEMPLATE file that includes new startup commands for COM for OpenVMS and related components. Review the "Coordinated Startup" section of this template file and add the appropriate information to your existing startup files. To have COM for OpenVMS start automatically when the system boots, copy the following line to your SYLOGICALS.COM file, uncomment the line, and make sure it is set to TRUE: $ DEFINE/SYSTEM DCOM$TO_BE_STARTED TRUE If you do not set COM for OpenVMS to start automatically when the system boots, you must use the following command to start COM for OpenVMS: $ @SYS$STARTUP:DCOM$STARTUP 1.6 COM for OpenVMS Postinstallation Procedures After you install the COM for OpenVMS kit, do the following: 1. Verify that the OpenVMS Registry is running. (See the OpenVMS Registry System Management chapter in the OpenVMS Connectivity Developer Guide or OpenVMS System Manager Manual.) 2. Populate the OpenVMS Registry using the DCOM$SETUP utility, option 3. (See the DCOM$SETUP utility section (Chapter 5) in the OpenVMS Connectivity Developer Guide.) 3. Create the DCOM$GUEST account using the DCOM$SETUP utility, option 7. (See the DCOM$SETUP utility section (Chapter 5) in the OpenVMS Connectivity Developer Guide.) 4. Start COM for OpenVMS using the DCOM$SETUP utility, option 4. (See the DCOM$SETUP utility section (Chapter 5) in the OpenVMS Connectivity Developer Guide.) 5. If you want COM for OpenVMS to start automatically when the system reboots, modify the $ DEFINE/SYSTEM DCOM$TO_BE_STARTED line in the SYLOGICALS.COM file. (See Section 1.5.) 1-6 Installing the COM for OpenVMS Kit _________________________________________________________________ Index D______________________________ DCOM$TO_BE_STARTED logical, 1-5 M______________________________ Modifying the SYLOGICALS file for COM for OpenVMS, 1-5 Index-1