Readme Text for the DECdtm/XA V2.1 SDK Kit The DECdtm-XA SDK contains a new interface that allows a Transaction Manager (TM) to coordinate transactions performed by a Resource Manager(RM). Both V2.0 and V2.1 SDKs are layered on top of the current DECdtm Product shipped with VAX/VMS and Alpha/VMS V7.2. Currently, the functionality of the SDK V2.0 is shipped with OpenVMS V7.3-1 or higher while the added capability of the SDK V2.1 is shipped with OpenVMS V7.3-2. No installation is necessary when the corresponding version is used. However, the SDK is needed when upgrading to a higher version. With the added XA support to the existing DECdtm product, DECdtm/XA V2.0 enables an XA-compliant RM (such as Oracle/XA) to participate in a global transaction coordinated by DECdtm. Hence, DECdtm-compliant RMs such as ACMS can now manage transactions that involve Oracle/Rdb, RMS Journaling, and Oracle/XA. In addition, with the DECdtm/XA SDK, a DECdtm-compliant RM (such as Oracle/Rdb or RMS Journaling) can be coordinated by an XA-compliant transaction processing system such as BEA Tuxedo. DECdtm/XA V2.1 is an enhanced version of the V2.0 release. It offers all the functionality of V2.0 and is a replacement for V2.0. Thus you must remove a previously installed V2.0 SDK before installing V2.1. When upgrading DECdtm/XA that was included on the base OpenVMS V7.3-1 to DECdtm/XA V2.1, no removal is required. DECdtm/XA V2.1 provides one major new capability over the V2.0 release. This is the ability to provide cluster-wide transaction recovery support. With the design of the new DECdtm/XA Gateway server, transactions managed by the gateway server of one node can be recovered by another gateway server running on another node within an OpenVMS Cluster, provided that the "Gateway Domain" log file is on a cluster-wide accessable disk. The DECdtm/XA V2.1 SDK is compatible with applications using the V2.0 release. All applications will continue to work with V2.1 but will operate in the V2.0's non-cluster recovery mode of V2.0. For backwards compatibility, domain log files that use the V2.0 naming conventions will not have V2.1 cluster-wide recovery support. New domains created that do not use the V2.0 naming convention will have the cluster-wide recovery support of V2.1. All V2.0 documentation isalso valid for V2.1 with two minor changes as shown below: 1) Domain log file creation: In V2.0, the XGCP command "Create_Log/Gateway_Name= "creates a gateway log file in the SYS$JOURNAL: directory with the name "SYSTEM$.DDTM$XG_JOURNAL". In V2.1, the filename created is ".DDTM$XG_JOURNAL". The prefix "SYSTEM$" is not added. Since this file name is used as part of the "xa_open" string, it is important to be aware of this difference. Otherwise the xa_open call from the TM or application will fail. 2) DECdtm Gateway trace setup: In V2.0, the gateway trace log is turned on by defining a system logical, SYS$DECDTM_XG_TRACE, pointing to the filespec of the trace log file in which the trace information is logged. For V2.1, the name and location of this log file is SYS$JOURNAL:DECDTM_XG.DDTM$XG_TRACE. All traces are logged to this file when the system logical, SYS$DECDTM_XG_TRACE, is defined. For example: $Define/sys SYS$DECDTM_XG_TRACE "Yes" This is also for V2.0 backwards compatibility. Software Requirement: This SDK operates with OpenVMS V7.2 or higher. Kit Content: Readme.txt - This read me file. COMPAQ-AXPVMS-DECDTMXA-V0201--1.PCSI - Product kit for Alpha VMS. The following describes how to install the SDK. Install: 1. Set the default directory to the location where the PCSI file is. 2. Enter the following: $Product Install DECDTMXA 3. Answer the questions from the Product utility. Sample Installation Output: ============================================================================== $ Product Install DECDTMXA The following product has been selected: COMPAQ AXPVMS DECDTMXA V2.1 Layered Product Do you want to continue? [YES] Yes Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. COMPAQ AXPVMS DECDTMXA V2.1: OpenVMS DECdtm XA © Compaq Corporation 2001. All rights reserved. Compaq Computer Corporation This product does not require a PAK. Do you want the defaults for all options? [YES] No DEC AXPVMS VMS V7.2 [Installed] * Configuration options for this referenced product cannot * be changed now because the product is already installed. * (You can use PRODUCT RECONFIGURE later to change options.) Do you want to review the options? [NO] Yes COMPAQ AXPVMS DECDTMXA V2.1: OpenVMS DECdtm XA DEC AXPVMS VMS V7.2 [Installed] Are you satisfied with these options? [YES] Execution phase starting ... The following product will be installed to destination: COMPAQ AXPVMS DECDTMXA V2.1 Portion done: 0%...10%...20%...30%...40%...50%...90%...100% The following product has been installed: COMPAQ AXPVMS DECDTMXA V2.1 Layered Product COMPAQ AXPVMS DECDTMXA V2.1: OpenVMS DECdtm XA Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: @sys$startup:ddtm$xa_startup.com Insert the following lines in SYS$MANAGER:SYSHUTDWN.COM: @sys$startup:ddtm$xa_shutdown.com This kit includes an installation verification program. For confirmation that the product is operable after installation, Compaq recommends that the user perform the following tasks: - Use the XGCP utility to create a log with the same name as the local OpenVMS node. - Run the installation verification programs: $ RUN SYS$TEST:DECDTM_IVP.EXE $ RUN SYS$TEST:DECDTM_XG_IVP.EXE - Use the XGCP utility to stop and restart the DECdtm XA Gateway server. $ ============================================================================== Post installation step: The DECdtm/XA SDK contains startup and shutdown command files that need to run at system startup and shutdown time. Make sure to add the lines to the system's startup and shutdown command files as instructed above. If this is the first installation of the DECdtm/XA SDK, you must create a Gateway log file before using the DECdtm/XA Gateway. Use the XGCP utility to create this log. Refer to the OpenVMS DECdtm XA Interface User's Guide for details on how to use the utility. Use the following command to invoke the XGCP utility: $Run Sys$System:XGCP.EXE To use DECdtm/XA without rebooting the system, you must manually invoke the DDTM$XA_STARTUP.COM command file before starting any applications or running the Installation Verification Program (IVP). Removing the product: To remove the product, first invoke the shutdown command file, by entering @sys$startup:ddtm$xa_shutdown.com. You can then proceed to remove the product using the Product utility as follows: $Product Remove DECDTMXA Sample Removal Output: ============================================================================== $Product Remove DECDTMXA The following product has been selected: COMPAQ AXPVMS DECDTMXA V2.1 Layered Product Do you want to continue? [YES] The following product will be removed from destination: COMPAQ AXPVMS DECDTMXA V2.1 Portion done: 0%...40%...50%...60%...70%...80%...100% The following product has been removed: COMPAQ AXPVMS DECDTMXA V2.1 Layered Product $ ==============================================================================