Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

OpenVMS Connectivity Developer Guide


Begin Index

Contents (summary)
Preface Preface
Chapter 1 COM for OpenVMS Release Notes
Chapter 2 OpenVMS Registry Release Notes
Part 1 COM for OpenVMS
Chapter 3 Overview of COM for OpenVMS
Chapter 4 Installing the COM for OpenVMS Kit
Chapter 5 COM for OpenVMS Utilities for Application Development and Deployment
Chapter 6 Developing a COM for OpenVMS Application
Part 2 OpenVMS Registry
Chapter 7 Overview of OpenVMS Registry
Chapter 8 OpenVMS Registry System Management
Chapter 9 OpenVMS Registry Server Management
Chapter 10 OpenVMS Registry System Services
Part 3 OpenVMS Events
Chapter 11 OpenVMS Events
Part 4 Authentication
Chapter 12 Authentication
Part 5 Appendixes
Appendix A MIDL Compiler Options
Appendix B Troubleshooting
Appendix C Cookbook Examples: Building a Sample Application on OpenVMS
Appendix D Upgrading to COM Version 1.1 for OpenVMS from COM Version 1.0 for OpenVMS
Appendix E Lists of Differences, APIs, and Interfaces
Appendix F List of Files Installed by COM for OpenVMS
Appendix G Discount Coupons for COM Books
Appendix H Glossary
Appendix I Acronyms
  Index
  Figures
  Examples
  Tables


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


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6539PRO_CONTENTS.HTML