OpenVMS Connectivity Developer Guide

Contents

Preface
Preface	Preface
Chapter 1
1	COM for OpenVMS Release Notes
1.1	Release Notes
1.1.1	OpenVMS Registry Databases from COM for OpenVMS Field Test Versions Incompatible with COM Version 1.0 for OpenVMS
1.1.2	COM for OpenVMS and DECnet-Plus on OpenVMS Alpha
1.1.3	System Requirements for Installing COM for OpenVMS
1.1.4	DCOM$RPCSS Process Resource Exhaustion
1.1.5	Floating Point Restriction When Passed Through the IDispatch Interface
1.1.6	DECwindows Motif® Required to Run COM for OpenVMS
1.1.7	MIDL -w Switch
1.1.8	MIDL compiler treats wchar_t literals as char
1.1.9	RPC Server Unavailable Failure (800706BA)
1.1.10	Remote Activation of an In-Process Server
1.1.11	COM for OpenVMS Security
1.1.11.1	Summary of security implementation differences
1.1.11.2	Controlling access to OpenVMS Registry keys
1.1.12	Events Logging with COM Version 1.0 for OpenVMS
1.1.13	Granting COM Application Access to the OpenVMS Registry
1.1.14	DCOM$CNFG Utility and Disabling Applications: Possible Unintended Side Effects
1.1.15	Threading Model Supported by COM for OpenVMS
1.1.16	RPC Cannot Support Failure (800706E4)
1.1.17	Client Application May ACCVIO After Multiple Rundowns
Chapter 2
2	OpenVMS Registry Release Notes
2.1	Release Notes
2.1.1	Database Quota Restrictions Result in Irreversible Create Key Failures
2.1.2	No Key Change Notifications When a Key's Attributes are Modified
2.1.3	Error Specifying a Value with a Data Type of "NONE"
2.1.4	SYS$REGISTRY Logical Must be Defined
2.1.5	Unavailability of OpenVMS Registry Server Results in Timeout Error
2.1.6	Database Searches Limited
2.1.7	OpenVMS Registry Databases Created by Field Test Versions
2.1.8	%REG-E-NOMSG Error Messages
2.1.9	Notification Failure During OpenVMS Registry Restart or Failover
2.1.10	List Key Command Terminates on ACCESSDENIED Status
2.1.11	$REGISTRY Does Not Set the Event Flag on an Error
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.0 for OpenVMS Kit
4.2	Prerequisites
4.3	Preinstallation
4.3.1	Configuring DIGITAL TCP/IP Services for OpenVMS
4.3.2	Starting DIGITAL TCP/IP Services for OpenVMS
4.3.3	Configuring OpenVMS UCX
4.3.4	Starting OpenVMS UCX
4.4	Installing COM for OpenVMS
4.5	Starting COM for OpenVMS Automatically after a Reboot
4.6	COM for OpenVMS Postinstallation Procedures
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	Starting and Stopping the COM Server (DCOM$RPCSS Process)
5.2.2	Registering an Application
5.3	Running DCOM$CNFG
5.3.1	The DCOM$CNFG Application List Submenu
5.3.2	The DCOM$CNFG System-wide Default Properties Submenu
5.4	Configuring Windows NT and OpenVMS Systems to Interoperate
5.4.1	Configuring the OpenVMS System
5.4.2	Configuring the Windows NT System
5.4.3	Configuring an Application on Windows NT
5.5	Registering In-Process Servers: DCOM$REGSVR32 Utility
Chapter 6
6	Developing a COM for OpenVMS Application
6.1	Creating a COM Application
6.2	Step 1: Generate Unique Identifiers
6.3	Step 2: Build an Application Using the MIDL Compiler
6.3.1	Running the MIDL Compiler
6.3.2	Running the MIDL Compiler with DCOM$RUNSHRLIB
6.3.3	Required MIDL Switches
6.3.4	Required Include Directories
6.3.5	Required Header File
6.4	Step 3: Compile the COM Application
6.4.1	Required Macro Definitions
6.4.2	Required Include Directories
6.4.3	Required Header File: VMS_DCOM.H
6.4.4	Required C++ Qualifiers
6.4.5	Required C Qualifiers
6.5	Step 4: Link the COM Application
6.5.1	Linking the Client and the Out-of-Process Component
6.5.2	Linking the In-Process Component Shareable Image
6.5.2.1	Creating a Symbol Vector
6.5.3	Linking the Proxy/Stub Shareable Image
6.5.3.1	Creating a Symbol Vector
6.6	Required OpenVMS Registry Entries
6.6.1	HKEY_CLASSES_ROOT\CLSID
6.6.1.1	Component CLSIDs
6.6.1.2	Proxy/Stub CLSIDs
6.6.2	HKEY_CLASSES_ROOT\Interface
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
8.3	Starting the OpenVMS Registry
8.3.1	Starting the OpenVMS Registry Automatically on Reboot
8.3.2	Products that Require the OpenVMS Registry Start the Server
8.3.3	Starting the OpenVMS Registry Manually
8.3.4	Preventing the OpenVMS Registry from Starting Automatically
8.3.5	OpenVMS Registry Server Minimum Process Values
8.4	Shutting Down the OpenVMS Registry
8.5	OpenVMS Registry Failover in a Cluster
8.5.1	Changing the Priority of OpenVMS Registry Server Processes
8.6	Connecting to the OpenVMS Registry from a Windows NT System
8.7	OpenVMS Registry Quotas
8.8	OpenVMS Registry Security
8.9	Backing up and Restoring the OpenVMS Registry
8.10	Using the OpenVMS Registry in an Alpha Mixed-Version Cluster
8.11	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 1	CREATE DATABASE
Command 2	CREATE KEY
Command 3	CREATE SNAPSHOT
Command 4	CREATE VALUE
Command 5	DELETE KEY
Command 6	DELETE VALUE
Command 7	LIST KEY
Command 8	LIST VALUE
Command 9	MODIFY KEY
Command 10	MODIFY VALUE
Command 11	MODIFY TREE
Command 12	SEARCH KEY
Command 13	SEARCH VALUE
Command 14	SHOW
Command 15	START MONITORING
Command 16	STOP
Command 17	ZERO COUNTERS
Chapter 10
10	OpenVMS Registry System Services
Command 18	$REGISTRY and $REGISTRYW
Part 3
Part 3	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
Appendix B
Appendix B	Cookbook Examples: Building a Sample Application on OpenVMS
B.1	COM Example (Sample1)
B.1.1	OpenVMS Instructions
B.1.1.1	Building the Application on OpenVMS
B.1.1.2	Registering the Application on OpenVMS
B.1.1.3	Running the Application on OpenVMS as an Out-of-Process Server
B.1.1.4	Running the Application on OpenVMS and Specifying a Remote Server
B.1.1.5	Running the Application on OpenVMS as an In-Process Server
B.1.2	Windows NT Instructions
B.1.2.1	Building 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 on OpenVMS
B.2.1.2	Registering the Application on OpenVMS
B.2.1.3	Running the Application on OpenVMS as an Out-of-process Server
B.2.1.4	Running the Application on OpenVMS and Specifying a Remote Server
B.2.1.5	Running the Application on OpenVMS as an In-Process Server
B.2.2	Windows NT Instructions
B.2.2.1	Building 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	Upgrading to COM Version 1.0 for OpenVMS from Field Test Versions
C.1	Migrating from Earlier Versions of COM for OpenVMS
C.1.1	COM for OpenVMS Field Test Versions are Incompatible with OpenVMS Version 7.2
C.1.2	Upgrading from Any Field Test Version of COM for OpenVMS to COM Version 1.0 for OpenVMS
C.1.3	Nameless Structures and Variant Args
Appendix D
Appendix D	Lists of Differences, APIs, and Interfaces
D.1	Differences between COM for OpenVMS and Microsoft COM
D.1.1	Service Control Manager (SCM)
D.1.2	Server application stack size
D.2	APIs
D.3	Interfaces
Appendix E
Appendix E	List of files installed by COM for OpenVMS
E.1	Files Installed by COM for OpenVMS
Appendix F
Appendix F	Discount Coupons for COM Books
Appendix G
Appendix G	Glossary