Document revision date: 19 July 1999

Contents

Preface
Preface	Preface
Chapter 1
1	COM for OpenVMS Release Notes
1.1	Release Notes
1.1.1	Upgrading from COM Version 1.0 for OpenVMS to COM Version 1.1 for OpenVMS
1.1.2	DCOM$RPCSS Process Resource Exhaustion
1.1.3	Floating Point Restriction When Passed by Value Through the IDispatch Interface
1.1.4	DECwindows Motif® Required to Run COM for OpenVMS
1.1.5	MIDL -w Switch
1.1.6	MIDL compiler treats wchar_t literals as char
1.1.7	Remote Activation of an In-Process Server
1.1.8	COM for OpenVMS Security: COM Version 1.0 for OpenVMS and COM Version 1.1 for OpenVMS
1.1.9	DCOM$CNFG Utility and Disabling Applications: Possible Unintended Side Effects
1.1.10	Threading Model Supported by COM for OpenVMS
1.1.11	Change to COM for OpenVMS Service Control Manager Startup and Shutdown
1.1.12	CoQueryProxyBlanket() and CoQueryClientBlanket() Do Not Return Valid Principal Name Strings
1.1.13	Previously Registered Applications that Use Logical Names for the Local Server Path
1.1.14	SAFEARRAY Limitation
1.1.15	COM Version 1.0 for OpenVMS and COM Version 1.1 for OpenVMS Not Supported in the Same Cluster
1.1.16	You Must Repopulate the OpenVMS Registry for COM Version 1.1 for OpenVMS
1.1.17	SP4 with Enhanced NTLM Enabled is Not Supported
1.1.18	Trusted-Domain Authentication Support Patch Kit
1.1.19	IGNORE_EXTAUTH Support Patch Kit
1.1.20	DCOM$RPCSS Stalls on Restart
1.1.21	Using COM for OpenVMS between Two OpenVMS Systems
1.1.22	Specific Error Messages
1.1.22.1	RPC Cannot Support Failure (800706E4)
1.1.22.2	RPC Server Unavailable Failure (800706BA)
1.1.22.3	RPC WHO_ARE_YOU Failure (EE1282FA)
1.1.22.4	RPC PROTOCOL Failure (800706C0)
Chapter 2
2	OpenVMS Registry Release Notes
2.1	Release Notes
2.1.1	No Key Change Notifications When a Key's Attributes are Modified
2.1.2	Database Searches Limited
2.1.3	Key Access Policy
2.1.4	OpenVMS Registry Maximum Data Size Restrictions
2.1.5	REG$_EXQUOTA Errors
2.1.6	OpenVMS Registry Maximum Database Size Restrictions
Part 1
Part 1	COM for OpenVMS
Chapter 3
3	Overview of COM for OpenVMS
3.1	What is COM?
3.1.1	Suggested Reading
3.2	Overview of COM for OpenVMS
3.2.1	How COM for OpenVMS Uses the OpenVMS Registry
3.3	Using COM for OpenVMS
3.3.1	Developing New Applications
3.3.2	Encapsulating Existing Applications
3.4	The OpenVMS MIDL Compiler
Chapter 4
4	Installing the COM for OpenVMS Kit
4.1	Contents of the COM Version 1.1 for OpenVMS Kit
4.2	Prerequisites
4.3	Supported COM for OpenVMS Installations
4.4	Installing COM for OpenVMS on an OpenVMS Standalone System
4.5	Upgrading from COM Version 1.0 for OpenVMS on an OpenVMS Standalone System
4.6	Installing COM for OpenVMS on an OpenVMS Cluster
4.7	Upgrading COM for OpenVMS in an OpenVMS Cluster
4.8	OpenVMS External Authentication
4.8.1	LOGINOUT.EXE Use of External Authentication
4.8.2	DCE Integrated Login Restriction
4.9	Understanding the COM for OpenVMS Environment
4.9.1	COM for OpenVMS Service Control Manager (SCM)
4.9.2	OpenVMS Registry Server
4.9.3	Advanced Server for OpenVMS Server
4.9.4	ACME Server
4.9.5	RPC Endpoint Mapper
4.9.6	RPC and SSPI/NTLM Layers
4.9.7	OpenVMS Events
4.10	Installing COM for OpenVMS
4.11	COM for OpenVMS Postinstallation Procedures
4.12	Starting COM for OpenVMS (COM for OpenVMS Service Control Manager)
4.12.1	Starting COM for OpenVMS Automatically after a Reboot
4.13	Shutting Down COM for OpenVMS (COM for OpenVMS Service Control Manager)
4.13.1	Suppressing the DCOM$SHUTDOWN Confirmation Request
Chapter 5
5	COM for OpenVMS Utilities for Application Development and Deployment
5.1	DCOM$SETUP Utility
5.2	Running DCOM$SETUP
5.2.1	Creating and Configuring DCOM$RPCSS Accounts
5.2.2	Starting and Stopping the COM Server (DCOM$RPCSS Process)
5.2.3	Registering an Application
5.3	Running DCOM$CNFG
5.3.1	The DCOM$CNFG Application List Submenu
5.3.2	Registry Value Permissions Submenus
5.3.3	Registry Key Permissions Submenus
5.3.4	Application Identity Submenu
5.3.5	The DCOM$CNFG System-wide Default Properties Submenu
5.3.6	System-wide Default Security Submenu
5.4	Configuring Authentication across Windows NT Domains
5.5	Registering In-Process Servers: DCOM$REGSVR32 Utility
Chapter 6
6	Developing a COM for OpenVMS Application
6.1	Step 1: Generate Unique Identifiers
6.2	Step 2: Build an Application Using the MIDL Compiler
6.2.1	Running the MIDL Compiler
6.2.2	Running the MIDL Compiler with DCOM$RUNSHRLIB
6.2.3	Required MIDL Switches
6.2.4	Required Include Directories
6.2.5	Required Header File
6.3	Step 3: Compile the COM Application
6.3.1	Required Macro Definitions
6.3.2	Required Include Directories
6.3.3	Required Header File: VMS_DCOM.H
6.3.4	Required C++ Qualifiers
6.3.5	Required C Qualifiers
6.4	Step 4: Link the COM Application
6.4.1	Linking the Client and the Out-of-Process Component
6.4.2	Linking the In-Process Component Shareable Image
6.4.2.1	Creating a Symbol Vector
6.4.3	Linking the Proxy/Stub Shareable Image
6.4.3.1	Creating a Symbol Vector
6.5	Required OpenVMS Registry Entries
6.5.1	HKEY_CLASSES_ROOT\CLSID
6.5.1.1	Component CLSIDs
6.5.1.2	Proxy/Stub CLSIDs
6.5.2	HKEY_CLASSES_ROOT\Interface
6.6	Converting OpenVMS and Windows Error Codes to Text
Command 1	NTA$VMSGetMessage
Part 2
Part 2	OpenVMS Registry
Chapter 7
7	Overview of OpenVMS Registry
7.1	What is the Registry?
7.1.1	Suggested Reading
7.2	OpenVMS Registry Concepts and Definitions
7.2.1	Keys, Subkeys, and Values
7.2.1.1	Key and Value Volatility
7.2.1.2	Key Write-through and Write-behind
7.2.1.3	Linking a Key to Other Keys and Values
7.2.1.4	Rules for Creating OpenVMS Registry Keys and Value Names
7.2.2	Class
7.2.3	Hive
7.3	OpenVMS Registry Structure
7.4	Reading and Writing to the OpenVMS Registry
7.4.1	$REGISTRY System Services
7.4.2	REG$CP Server Management Utility
7.5	OpenVMS Registry Security
7.5.1	OpenVMS Security Model
7.5.1.1	Granting OpenVMS Registry Access Rights Using the AUTHORIZE Utility
7.5.2	Windows NT Security Model
7.6	Controlling the OpenVMS Registry Server Operations
7.6.1	Defining Maximum Reply Age/Age Checker Interval Settings
7.6.2	Defining the Database Log Cleaner Interval/Initial Log File Size Settings
7.6.3	Defining Default File Quota/File Quota Interval Settings
7.6.4	Defining the Scan Interval Setting
7.6.5	Defining the Log Registry Value Error Setting
7.6.6	Defining the Operator Communications Interval Setting
7.6.7	Defining the Process Time Limit Setting
7.6.8	Defining the Reply Log Cleaner Interval Setting
7.6.9	Defining Snapshot Interval/Snapshot Location/Snapshot Versions Settings
7.6.10	Defining the Write Retry Interval Setting
Chapter 8
8	OpenVMS Registry System Management
8.1	Installing the OpenVMS Registry
8.2	Configuring the OpenVMS Registry: the REG$CONFIG Configuration Utility
8.2.1	Configuring OpenVMS Registry Values
8.3	Starting the OpenVMS Registry
8.3.1	Starting the OpenVMS Registry Manually
8.4	Shutting Down the OpenVMS Registry
8.5	OpenVMS Registry Server Commands
Command 2	SHOW SERVER REGISTRY_SERVER
Command 3	SET SERVER REGISTRY_SERVER
8.6	OpenVMS Registry Failover in a Cluster
8.6.1	Changing the Priority of OpenVMS Registry Server Processes
8.7	Connecting to the OpenVMS Registry from a Windows NT System
8.8	OpenVMS Registry Quotas
8.9	OpenVMS Registry Security
8.10	Backing Up and Restoring the OpenVMS Registry Database
8.11	Using the OpenVMS Registry in an OpenVMS Alpha Mixed-Version Cluster
8.12	Internationalization and Unicode Support
Chapter 9
9	OpenVMS Registry Server Management
9.1	Managing the OpenVMS Registry Server from the Command Line
9.2	Backing Up and Restoring the OpenVMS Registry Database
9.2.1	Creating a Snapshot of the OpenVMS Registry Database
9.2.2	Restoring a Snapshot of the OpenVMS Registry Database
9.3	OpenVMS Registry Server Management Utility Syntax
Command 4	CREATE DATABASE
Command 5	CREATE KEY
Command 6	CREATE SNAPSHOT
Command 7	CREATE VALUE
Command 8	DELETE KEY
Command 9	DELETE VALUE
Command 10	EXPORT
Command 11	IMPORT
Command 12	LIST KEY
Command 13	LIST VALUE
Command 14	MODIFY KEY
Command 15	MODIFY VALUE
Command 16	MODIFY TREE
Command 17	SEARCH KEY
Command 18	SEARCH VALUE
Command 19	SHOW
Command 20	START MONITORING
Command 21	STOP
Command 22	ZERO COUNTERS
Chapter 10
10	OpenVMS Registry System Services
Command 23	$REGISTRY and $REGISTRYW
Part 3
Part 3	OpenVMS Events
Chapter 11
11	OpenVMS Events
11.1	What are Events?
11.1.1	Suggested Reading
11.2	Overview of OpenVMS Events
11.2.1	Viewing OpenVMS Events Using Windows NT Event Viewer
11.2.2	Viewing OpenVMS Events Using Advanced Server for OpenVMS Event Viewer
11.2.3	Event Logging on OpenVMS Only
Command 24	NTA$EVENTW
11.3	Writing Your Own Events
11.4	Troubleshooting OpenVMS Events
Part 4
Part 4	Authentication
Chapter 12
12	Authentication
12.1	What is Authentication?
12.2	Acquiring Windows NT Credentials Using NTA$LOGON
12.2.1	NTA$LOGON Optional Qualifiers
12.2.2	Examples of Using NTA$LOGON to Acquire Windows NT Credentials
12.3	The Authentication and Credential Management (ACM) Authority
12.3.1	Windows NT Authentication on OpenVMS
12.3.2	Authenticating a Windows NT User; Granting Windows NT Credentials to an OpenVMS Process
12.3.3	Managing the ACME_SERVER Process (ACME Server Commands)
12.3.4	Configuring the MSV1_0 ACME Agent
Part 5
Part 5	Appendixes
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

	privacy and legal statement
6539PRO_CONTENTS.HTML