Contents

Preface
Preface	Preface
Chapter 1
1	DCOM for OpenVMS FT2 Release Notes
1.1	Contents of the DCOM for OpenVMS Field Test 2 Kit
1.2	Prerequisites
1.3	Release Notes
1.3.1	Upgrading from DCOM for OpenVMS FT1 to DCOM for OpenVMS FT2
1.3.2	DCOM for OpenVMS and DECnet-Plus on OpenVMS Alpha
1.3.3	OpenVMS Registry Consumption of Nonpaged Pool
1.3.4	MIDL -w Switch
1.3.5	DCOM$RPCSS Process Resource Exhaustion
1.3.6	DECwindows Motif Required to Run DCOM for OpenVMS
1.3.7	Running DCOM for OpenVMS on OpenVMS Version 7.2 Systems
1.3.8	System Requirements for Installing DCOM for OpenVMS
1.3.9	OpenVMS DCE Privacy Option
1.3.10	MIDL compiler treats wchar_t literals as char
1.3.11	RPC Server Unavailable Failure (800706BA)
1.3.12	Remote Activation of an In-Process Server
Part 1
Part 1	DCOM for OpenVMS
Chapter 2
2	Overview of DCOM for OpenVMS
2.1	What is COM?
2.1.1	Suggested Reading
2.2	Overview of DCOM for OpenVMS
2.3	Using DCOM for OpenVMS
2.3.1	Developing New Applications
2.3.2	Wrappering Existing Applications
2.4	What is the OpenVMS MIDL Compiler?
2.5	How DCOM for OpenVMS uses the OpenVMS Registry
Chapter 3
3	Installing the DCOM for OpenVMS Kit
3.1	Preinstallation Checklist
3.1.1	Installing OpenVMS UCX
3.1.2	Configuring OpenVMS UCX
3.1.3	Installing the OpenVMS Registry
3.1.4	Installing OpenVMS DCE (OpenVMS Version 7.1 systems only)
3.1.5	Configuring OpenVMS DCE (OpenVMS Version 7.1 systems only)
3.1.6	Starting the OpenVMS Registry Server (OpenVMS Version 7.1 systems only)
3.1.7	Startup Order for Services
3.2	Installing DCOM for OpenVMS
3.2.1	DCOM for OpenVMS Postinstallation Procedures
Chapter 4
4	Configuring DCOM for OpenVMS
4.1	Pre-Configuration Checklist
4.2	What is DCOM$SETUP?
4.2.1	DCOM$SETUP Conventions and Requirements
4.3	Running DCOM$SETUP
4.3.1	Starting and Shutting Down the DCOM$RPCSS Process
4.3.2	Using DCOMCNFG
4.3.2.1	Example: Registering an Application
4.4	Registering In-process Servers: OpenVMS DCOM$REGSVR32 Utility
4.5	Configuring Windows NT and OpenVMS Systems to Interoperate
4.5.1	Configuring the OpenVMS System
4.5.2	Configuring the Windows NT System
4.5.3	Configuring an Application on Windows NT
Chapter 5
5	Developing a DCOM for OpenVMS Application
5.1	Creating a COM Application
5.1.1	Step 1: Generate Unique Identifiers
5.1.2	Step 2: Build an Application Using the MIDL Compiler
5.1.2.1	Running the MIDL Compiler
5.1.2.2	Running the MIDL Compiler with DCOM$RUNSHRLIB
5.1.2.3	Required MIDL Switches
5.1.2.4	Required Include Directories
5.1.2.5	Required Header File
5.1.3	Step 3: Compile the COM Application
5.1.3.1	Required Macro Definitions
5.1.3.2	Required Include Directories
5.1.3.3	Required Header Files
5.1.3.4	Required C++ Qualifiers
5.1.3.5	Required C Qualifiers
5.1.4	Step 4: Link the COM Application
5.1.4.1	Linking the Client and the Out-of-Process Component
5.1.4.2	Linking the In-Process Component Shareable Image
5.1.4.2.1	Creating a Symbol Vector
5.1.4.3	Linking the Proxy/Stub Shareable Image
5.1.4.3.1	Creating a Symbol Vector
5.1.5	Required OpenVMS Registry Keys
5.1.5.1	HKEY_CLASSES_ROOT\CLSID
5.1.5.1.1	Component CLSIDs
5.1.5.1.2	Proxy/Stub CLSIDs
5.1.5.2	HKEY_CLASSES_ROOT\CLSID Interface
Part 2
Part 2	OpenVMS Registry
Chapter 6
6	Introduction
6.1	What is the Registry?
6.1.1	Suggested Reading
6.2	OpenVMS Registry Concepts
6.3	OpenVMS Registry Security
6.3.1	OpenVMS Security model
6.3.2	Windows NT Security model
6.3.3	OpenVMS Registry and Windows NT Security: Windows NT Connectable Registry
6.4	OpenVMS Registry Structure
6.4.1	OpenVMS Registry Keys and Value Names
6.4.2	Key Item Codes
6.4.3	Value Item Codes
Chapter 7
7	OpenVMS Registry System Services
Command 1	$REGISTRY
Command 2	$REGISTRYW
Chapter 8
8	OpenVMS Registry Server Management
8.1	Managing the OpenVMS Registry Server from the Command Line
8.2	OpenVMS Registry Server Management Utility Syntax
Command 3	CREATE DATABASE
Command 4	CREATE KEY
Command 5	CREATE SNAPSHOT
Command 6	CREATE VALUE
Command 7	DELETE KEY
Command 8	DELETE VALUE
Command 9	LIST KEY
Command 10	LIST VALUE
Command 11	MODIFY KEY
Command 12	MODIFY VALUE
Command 13	MODIFY TREE
Command 14	SHOW
Command 15	START MONITORING
Command 16	STOP
Command 17	ZERO COUNTERS
Part 3
Part 3	Appendix Section
Appendix A
Appendix A	MIDL Compiler Options
A.1	Mode
A.2	Input
A.3	Output File Generation
A.4	Output File Names
A.5	C Compiler and Preprocessor Options
A.6	Environment
A.7	Error and Warning Messages
A.8	Optimization
A.9	Miscellaneous
Appendix B
Appendix B	Cookbook Examples: Building a Sample Application under OpenVMS
B.1	DCOM Example (Sample1)
B.1.1	OpenVMS Instructions
B.1.1.1	Building the Application under OpenVMS
B.1.1.2	Registering the Application under OpenVMS
B.1.1.3	Running the Application Under OpenVMS As An Out-of-process Server
B.1.1.4	Running the Application Under OpenVMS and Specifying a Remote Server
B.1.1.5	Running the Application under OpenVMS as an In-process Server
B.1.2	Windows NT Instructions
B.1.2.1	Bulding the Application on Windows NT
B.1.2.2	Registering the Application on Windows NT
B.1.2.3	Running the Application on Windows NT
B.2	Automation Example (Dispatch_Sample1)
B.2.1	OpenVMS Instructions
B.2.1.1	Building the Application under OpenVMS
B.2.1.2	Registering the Application under OpenVMS
B.2.1.3	Running the Application Under OpenVMS As An Out-of-process Server
B.2.1.4	Running the Application Under OpenVMS and Specifying a Remote Server
B.2.1.5	Running the Application under OpenVMS as an In-process Server
B.2.2	Windows NT Instructions
B.2.2.1	Bulding the Application on Windows NT
B.2.2.2	Registering the Application on Windows NT
B.2.2.3	Running the Application on Windows NT
Appendix C
Appendix C	Lists of Differences, APIs, and Interfaces
C.1	Differences between DCOM for OpenVMS and Microsoft DCOM
C.2	APIs
C.3	Interfaces
Appendix D
Appendix D	List of files installed by DCOM and REGISTRYV71
D.1	Files Installed by DCOM
D.2	Files Installed by REGISTRYV71
Appendix E
Appendix E	Glossary
Index
Index
Examples
3-1	Sample OpenVMS Registry Installation
3-2	Sample DCOM for OpenVMS Installation
4-1	Registering a component using the DCOM$REGSVR32 utility
4-2	Unregistering a component using the DCOM$REGSVR32 utility
Tables
4-1	DCOM$REGSVR32 Command Line Options
6-1	OpenVMS Registry operations
6-2	Minimum, Maximum, and Default Values
6-3	OpenVMS Registry Key Item Codes
6-4	OpenVMS Registry Value Item Codes
7-1	Item Descriptor Fields
7-2	Descriptor Fields
7-3	Valid Function Codes
7-4	Item Code Summary
8-1	OpenVMS Registry Server Management Utility Commands