Readme Text for the DECdtm-XA V2.1 SDK Kit This is the readme file for the DECdtm-XA V2.1 SDK Kit. To install the V2.1 SDK, download the DECDTMXA021.EXE file onto an OpenVMS Alpha system and expand this self-extracting image file by entering the following: $RUN DECDTMXA021.EXE After that, use the "$Product" command to install the expanded .pcsi file. For additional information, refer to the following DECdtm-XA SDK website. www.openvms.compaq.com/commercial/decdtm 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 high while the added capability of the SDK V2.1 is shipped with OpenVMS V7.3-2. No installation is neccessary when the corresponding version is used. However, the SDK is needed when a higher version is used. 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 DECdtm-XA V2.0, 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. The 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 to V2.0. So, it is neccessary to remove the previously installed V2.0 SDK before installing V2.1. When upgrading the base OpenVMS V7.3-1 to use DECdtm-XA V2.1, no removal is required. The DECdtm-XA V2.1 provides one major 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 a OpenVMS Cluster, providing that the "Gateway Domain" log file is on a cluster accessable disk. The DECdtm-XA V2.1 SDK is totally compatable with the V2.0 release. No application changes are required to use V2.1. All the docuemtation of V2.0 also apply to V2.1 with two minor alterations. The following are the two differences: 1) Domain log file creation - In V2.0, the XGCP command "Create_Log/Gateway_Name=" will create a gateway log file in the SYS$JOURNAL: directory with the name of "SYSTEM$.DDTM$XG_JOURNAL". In V2.1, the file name created will be ".DDTM$XG_JOURNAL". The prefix "SYSTME$" is not added. Since this file name is being used as part of the "xa_open" string, it is important to be aware of this differences. 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 fixed to be, SYS$JOURNAL:DECDTM_XG.DDTM$XG_TRACE. All traces will be logged to this file when the system logical, SYS$DECDTM_XG_TRACE, is defined to "Yes". For example: "$Define/sys SYS$DECDTM_XG_TRACE Yes" 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: - Set the default directory to the location where the PCSI file is. - Enter the following: $Product Install DECDTMXA - 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 $ ==============================================================================