Order Number: AA--RMWWB--TE
This document contains the release notes for HP Distributed Computing Environment (DCE) for OpenVMS VAX and OpenVMS Alpha.
Revision/Update Information: This is a new manual.
Operating System:
OpenVMS VAX Version 7.2 or higher
OpenVMS Alpha Version 7.2 or higher
Software Version: HP DCE for OpenVMS Version 3.1
Hewlett-Packard Company
Palo Alto, California
© 2004 Hewlett-Packard Development Company, L.P.
Microsoft, MSDOS, Windows, and Windows NT are trademarks of Microsoft Corporation in the U.S. and/or other countries.
Intel, Intel Inside, Itanium, and Pentium are trademarks of Intel Corporation in the U.S. and/or other countries.
UNIX is a trademark of The Open Group in the U.S. and/or other countries.
Confidential computer software. Valid license from HP and/or its subsidiaries required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendors standard commercial license.
Neither HP nor any of its subsidiaries shall be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.
The OpenVMS documentation set is available on CD-ROM.
This document was prepared using VAX DOCUMENT, Version V3.3-1b.
Contents |
Version 3.1 of HP DCE for OpenVMS VAX and OpenVMS Alpha replaces the Compaq DCE for OpenVMS VAX and OpenVMS Alpha Version 3.0. Version 3.1 is a complete kit that does not require a previous version of DCE for OpenVMS for installation. Version 3.1 can be installed on a new system or can be installed as an update to a previous version of DCE for OpenVMS.
HP DCE for OpenVMS Version 3.1 supports OpenVMS Version 7.2, 7.3. It is implicit that, DCE is not supported on unsupported Operating System versions. See Section 1.1 for new features and Section 16 for important restrictions and known problems. |
Version 3.1 of HP DCE for OpenVMS VAX and OpenVMS Alpha consists of the following services:
HP DCE for OpenVMS VAX and OpenVMS Alpha Version 3.1 is an enhanced version of its previous Version 3.0. All the new features of Compaq DCE for OpenVMS Version 3.0 described in Section 1.2 are also applicable to DCE for OpenVMS Version 3.1.
Version 3.1 of HP DCE for OpenVMS VAX and OpenVMS Alpha includes the following new features.
$ dtscp set decnet time source true $ dtscp set decnet time source false $ dtscp show decnet time source $ dtscp show decnet local server $ dtscp show all |
dcecp> directory modify <dir name> -upgrade -tree (or) $ dcecp -c directory modify <dir name> -upgrade -tree |
$ DEFINE/SYSTEM CDSCLERK_TRY_PE_SITE TRUE |
Compaq DCE for OpenVMS VAX and OpenVMS Alpha Version 3.0 is based on The Open Group’s R1.2.2 version of DCE. Full documentation for features common to OSF DCE R1.2.2 and Compaq DCE for OpenVMS Version 3.0 is available in the R1.2.2 documentation. (For more information on these new features, see the Compaq DCE for OpenVMS VAX and OpenVMS Alpha Product Guide, unless otherwise stated.)
This version adds the following new features to DCE:
$ dcecp -c help |
$ dtscp show clock resolution $ dtscp show time provider timeouts detected $ dtscp show local server not in group $ dtscp show servers not in group |
Null Time ProviderThis functionality can be accessed via the Modify Configuration Menu.
NTP Time Provider
HP DCE for OpenVMS has four kits available:
Note that the right to use the Runtime Services Kit is included as part of the OpenVMS license. The other kits each require a separate license.
The following sections list the contents of each of these kits.
2.1 Runtime Services Kit
The Runtime Services provide the basic services required for DCE applications to function. The Runtime Services Kit contains the following:
The Application Developer's Kit is used by developers to build DCE applications. The Application Developer's Kit contains the following:
The CDS Server provides the naming services necessary for DCE clients to locate DCE server applications. The CDS Server Kit includes the following:
The Global Directory Agent (GDA) lets you link multiple CDS namespaces using the Internet Domain Name System (DNS), X.500, or LDAP.
The Checkpoint migration tool should be used to migrate
the checkpoint file present in the DCE$LOCAL:[VAR.DIRECTORY.CDS]
directory when upgrading the DCE for OpenVMS Version 1.5
to Version 3.1 of DCE and before starting DCE for OpenVMS
Version 3.1.
2.4 Security Server Kit
The Security Server provides security services necessary for authenticated RPC calls between DCE client and server applications to function. The Security Server Kit includes the following:
The Product Guide, Reference Guide, Installation and Configuration Guides
of Compaq DCE for OpenVMS Version 3.0 are applicable for HP DCE for
OpenVMS Version 3.1 as well.
4 Installation/Configuration Prerequisites
VMS73_RPC-V0200 : RPC Kit for OpenVMS Alpha V7.3 VMS731_RPC-V0200 : RPC Kit for OpenVMS Alpha V7.3-1 VMS732_RPC-V0100 : RPC Kit for OpenVMS Alpha V7.3-2 VMS73_RPC-V0100 : RPC Kit for OpenVMS VAX V7.3 |
For example, if you are installing DCE for OpenVMS Version 3.1 product
on OpenVMS Version 7.3-1 for Alpha, you would need to install ‘‘VMS731_
RPC_V0200’’.
4.1 DCE Upgrade and Configuration
If you are installing a new version of HP DCE for OpenVMS VAX and OpenVMS Alpha over an existing version, you do not have to reconfigure DCE after the installation.
For DCE for OpenVMS Version 1.5, the proper shutdown order should be as follows:
$ @SYS$MANAGER:DCE$SETUP CLEAN |
$ @SYS$MANAGER:DCE$RPC_SHUTDOWN |
If you are running a DCE Version 3.0 for OpenVMS, then simply performing the first command will shut down both DCE and RPC.
As of OpenVMS Version 7.2, DCE RPC is supplied as part of the OpenVMS operating system, and may be running (RPC Only configuration) without a full DCE kit installed. In this situation, you only need to perform the second command listed above to shut down RPC.
Install the corresponding RPC patch kit on your system, if you are running OpenVMS Version 7.3 and above.
HP DCE for OpenVMS VAX and OpenVMS Alpha Version 3.1 must be installed by running the DCE$INSTALL.COM procedure. Do not install the product by invoking the POLYCENTER Software Installation utility (PCSI) directly. DCE$INSTALL.COM calls PCSI and performs several preinstallation and postinstallation tasks. To install DCE, run the DCE$INSTALL.COM procedure as follows:
$ @ddcu:DCE$INSTALL.COM [help] ! optional PCSI help |
See the DCE for OpenVMS VAX and OpenVMS Alpha Installation and Configuration Guide for more information.
Make sure that you run the DCE$INSTALL.COM from a valid directory. Errors may occur during the installation that leaves the default directory invalid.
When you upgrade the DCE for OpenVMS Version 1.5 to Version 3.1, you might need to migrate the CDS checkpoint files that are present in the DCE$LOCAL:[VAR.DIRECTORY.CDS] directory before starting DCE for OpenVMS Version 3.1. Please refer the Section 20 for details on ‘‘CDS Checkpoint Migration during the DCE Upgrade to DCE Version 3.1 from Version 1.5’’. |
After the installation, enter the following command to start HP DCE for OpenVMS Version 3.1.
$ @SYS$MANAGER:DCE$SETUP START |
After DCE upgrade to Version 3.1 from Version 1.5, you might see following message in dce$cdsclerk.out file. CDS server principal hosts/HOSTNAME/self is not a member of group subsys/dce/cds-server. Please refer the Section 20 for details on ‘‘SELF principal not a member of cds-server, on an upgraded system ’’. |
If you are installing DCE for OpenVMS Version 3.1 for the first time, you need to follow the below procedure.
As of OpenVMS Version 7.2, DCE RPC is supplied as part of the OpenVMS operating system, and may be running (RPC Only configuration) without a full DCE kit installed. In this situation, you only need to perform the following command to shut down RPC.
$ @SYS$MANAGER:DCE$RPC_SHUTDOWN CLEAN |
Install the corresponding RPC patch kit on your system, if you are running OpenVMS Version 7.3 and above.
HP DCE for OpenVMS VAX and OpenVMS Alpha Version 3.1 must be installed by running the DCE$INSTALL.COM procedure. Do not install the product by invoking the POLYCENTER Software Installation utility (PCSI) directly. DCE$INSTALL.COM calls PCSI and performs several preinstallation and postinstallation tasks. To install DCE, run the DCE$INSTALL.COM procedure as follows:
$ @ddcu:DCE$INSTALL.COM [help] ! optional PCSI help |
See the DCE for OpenVMS VAX and OpenVMS Alpha Installation and Configuration Guide for more information.
You must configure DCE before starting it. Enter the following command for DCE configuration:
$ @SYS$MANAGER:DCE$SETUP CONFIGURE |
A chapter on troubleshooting is part of the DCE for OpenVMS VAX and OpenVMS Alpha Product Guide. This chapter includes the following sections:
To define foreign commands, have the system manager add the following to your SYLOGIN.COM after the installation:
$ If F$SEARCH("SYS$MANAGER:DCE$DEFINE_REQUIRED_COMMANDS.COM")- .NES. "" THEN @SYS$MANAGER:DCE$DEFINE_REQUIRED_COMMANDS.COM $ If F$SEARCH("SYS$COMMON:[DCE$LIBRARY]DCE$DEFINE_OPTIONAL_COMMANDS.COM")- .NES. "" THEN @SYS$COMMON:[DCE$LIBRARY]DCE$DEFINE_OPTIONAL_COMMANDS.COM |
The DCE daemons require a number of system resources for each concurrent DCE client or server process. The default number of resources allocated to the daemons is based on a maximum of 70 concurrent users (servers and clients) running on a node. If you are running more than 70 DCE users on a node, you must do the following:
$ DEFINE/SYSTEM DCE$MAX_USERS 80 |
The Application Developer’s Kit provides support for building DCE applications using DCE Services. It provides Application Programming Interfaces (APIs) to RPC communication services, security services, and CDS name services via the RPC Name Services Interface (NSI). The Application Developer’s Kit contains the IDL compiler and Runtime support. The header files and IDL files for developing applications are installed in the following directory:
SYS$COMMON:[DCE$LIBRARY] |
DCE applications must also be linked with the following shareable image:
SYS$LIBRARY:DCE$LIB_SHR.EXE |
This image provides the entry points and global symbol definitions for the DCE API services.
A link options file, SYS$COMMON:[DCE$LIBRARY]DCE.OPT, is also provided. It is recommended that this options file be included when linking your DCE applications. For example:
$ LINK PROG,DCE:DCE/OPT |
Linking applications in this way makes your build procedures more portable between OpenVMS VAX and OpenVMS Alpha. It also prevents link environment changes from requiring changes to command files.
To help you port a Microsoft RPC application to the DCE format, a shareable image called SYS$LIBRARY:MSRPC_MAPPING_ SHR.EXE can be used to link with the RPC application. This new image provides entry points that map a subset of Microsoft RPC calls to their DCE equivalents. To identify which APIs have been mapped, see the MSRPC_MAPPING.H file. This file must be included in the RPC application.
Next | Contents |