Sun GlassFish Message Queue 4.4 Developer's Guide for C Clients

ProcedureTo Set Up Tuxedo as a Distributed Transaction Manager

  1. Install Tuxedo.

    See Tuxedo documentation for instructions.

  2. Set up the following environment variables:

    Environment Variable 

    Description 

    LD_LIBRARY_PATH

    Modify to include Message Queue C-API runtime library path and TUXDIR/lib path

    TUXDIR

    Tuxedo install root 

    PATH

    modify to include $TUXDIR/bin and compiler path

    TUXCONFIG

    TUXCONFIG filename path

    TLOGDEVICE

    Tuxedo transaction log filename path 

    MQ_HOME

    Message Queue install root 

    MQ_LOG_FILE

    Message Queue C-API runtime log file name 

    MQ_LOG_FILE_APPEND_PID

    Set so that Message Queue C-API runtime log file name will be auto-appended with the Tuxedo server process id 

  3. Build the Tuxedo transaction monitor server (TMS).

    1. Add the following entry to the $TUXDIR/udataobj/RM file:

      # SUN_MQ:sun_mq_xa_switch:-lmqcrt

    2. Build the TMS executable using buildtms:

      # buildtms -o $TUXDIR/bin/<exe-name> -r SUN_MQ

  4. Configure the Tuxedo servers.

    # tmloadcf config-file

    where config-file is the Tuxedo UBBCONFIG file.