Readme Text for the DECdtm-XA 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). This SDK is layered on top of the current DECdtm Product shipped with 
VAX/VMS and Alpha/VMS V7.2. The functionality of this SDK is currently 
scheduled to ship with OpenVMS V7.3.  Once incorporated into OpenVMS, you will no 
longer need to install the SDK.

    With the added XA support to the existing DECdtm product, DECdtm XA 
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, 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.

  Software Requirement:

    This SDK operates with OpenVMS V7.2 or higher.


  Kit Content:

  Readme.txt 	  			-  This read me file.
  COMPAQ-AXPVMS-DECDTMXA-V0200--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.0            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.0: 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.0: 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.0            <SYS$COMMON:>

    Portion done: 0%...10%...20%...30%...40%...50%...90%...100%

    The following product has been installed:
        COMPAQ AXPVMS DECDTMXA V2.0            Layered Product

    COMPAQ AXPVMS DECDTMXA V2.0: 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.0            Layered Product

    Do you want to continue? [YES]

    The following product will be removed from destination:
        COMPAQ AXPVMS DECDTMXA V2.0            <SYS$COMMON:>

    Portion done: 0%...40%...50%...60%...70%...80%...100%

    The following product has been removed:
        COMPAQ AXPVMS DECDTMXA V2.0            Layered Product
    $
  
==============================================================================