Nonstop Database, HiRDB Version 9 Installation and Design Guide

[Contents][Index][Back][Next]

7.2.7 Example of registering in the transaction manager

Organization of this subsection
(1) OpenTP1
(2) TPBroker for C++
(3) TUXEDO
(4) WebLogic Server
(5) TP1/EE

(1) OpenTP1

To register HiRDB in OpenTP1, use OpenTP1's trnlnkrm command. The following shows examples of trnlnkrm command specification:

(a) Dynamic registration
 
trnlnkrm -a HiRDB_DB_SERVER -s pdtxa_switch -o /HiRDB/client/lib/libzclty.sl
 

Explanation:
-a: Specifies the RM name.
-s: Specifies the RM switch name (name of the XA switch structure). The RM switch name depends on the registration method (dynamic or static).
-o: Specifies the RM-related object name (shared library's file name).
(b) Static registration
 
trnlnkrm -a HiRDB_DB_SERVER -s pdtxa_switch_y -o /HiRDB/client/lib/libzclty.sl
 

Explanation:
-a: Specifies the RM name.
-s: Specifies the RM switch name (name of the XA switch structure). The RM switch name depends on the registration method (dynamic or static).
-o: Specifies the RM-related object name (shared library's file name).

(2) TPBroker for C++

To register HiRDB in TPBroker for C++, use TPBroker for C++'s tslnkrm command. The following shows examples of tslnkrm command specification:

(a) Dynamic registration
 
tslnkrm -a HiRDB_DB_SERVER_1 -s pdtxa_switch -o '/HiRDB/client/lib/libzcltyk.sl'
-r -m
tslnkrm -a HiRDB_DB_SERVER_2 -s pdtxa_switch -o '/HiRDB/client/lib/libzcltyk.sl'
-r -m
 

Explanation:
-a: Specifies the RM name.
-s: Specifies the RM switch name (name of the XA switch structure). The RM switch name depends on the registration method (dynamic or static).
-o: Specifies the RM-related object name (shared library's file name).
-r: Indicates dynamic registration.
-m: Enables OTS daemon operation with multi-thread.
(b) Static registration
 
tslnkrm -a HiRDB_DB_SERVER_1 -s pdtxa_switch_y -o '/HiRDB/client/lib/libzcltyk.sl'
-r -m
tslnkrm -a HiRDB_DB_SERVER_2 -s pdtxa_switch_y -o '/HiRDB/client/lib/libzcltyk.sl'
-r -m
 

Explanation:
-a: Specifies the RM name.
-s: Specifies the RM switch name (name of the XA switch structure). The RM switch name depends on the registration method (dynamic or static).
-o: Specifies the RM-related object name (shared library's file name).
-r: Indicates static registration.
-m: Enables OTS daemon operation with multi-thread.

(3) TUXEDO

Use the $TUXDIR/udataobj/RM file to register HiRDB in TUXEDO. $TUXDIR indicates the absolute path name of the directory that contains the TUXEDO system software. The following shows examples of RM file specification:

(a) Dynamic registration
 
HiRDB_DB_SERVER:pdtxa_switch:-L/HiRDB/client/lib -lzcltys
 
(b) Static registration
 
HiRDB_DB_SERVER:pdtxa_switch_y:-L/HiRDB/client/lib -lzcltys
 

(4) WebLogic Server

Register HiRDB using the driver class name and the provider for the WebLogic Server JDBC connection pool. An example specification follows:

(a) Static registration
 
Driver-class-name:JP.co.Hitachi.soft.HiRDB.JDBC.JdbhXADataSource
Property(key=value):user=authorization-identifier
                   password=password
                   XAOpenString=name-defined-by-transaction-data-source
                   dataSourceName=name-specified-by-JDBC-connection-pool
                   Description=name-defined-by-transaction-data-source
 

Explanation
When HiRDB is registered, the following JDBC driver package name and driver class must be specified:
  • Package-name: JP.co.Hitachi.soft.HiRDB.JDBC
  • Driver-class-name: JdbhXADataSource

(5) TP1/EE

To register HiRDB in TP1/EE, use TP1/EE's eetrnmkobj command. The following shows examples of eetrnmkobj command specification:

(a) Dynamic registration
 
eetrnmkobj -r HiRDB_DB_SERVER -o seigyo -s pdtxa_switch     \
-O /HiRDB/client/lib/libzcltyk.sl -i /HiRDB/include
 

Explanation:
-r: Specifies the RM name.
-o: Specifies the name of the resource manager linkage object.
-s: Specifies the RM switch name (name of the XA switch structure). The RM switch name depends on the registration method (dynamic or static).
-O: Specifies the RM-related object name (shared library's file name).
-i: Specifies the HiRDB-provided header path.
(b) Static registration
 
eetrnmkobj -r HiRDB_DB_SERVER -o seigyo -s pdtxa_switch_y   \
-O /HiRDB/client/lib/libzcltyk.sl -i /HiRDB/include
 

Explanation:
-r: Specifies the RM name.
-o: Specifies the name of the resource manager linkage object.
-s: Specifies the RM switch name (name of the XA switch structure). The RM switch name depends on the registration method (dynamic or static).
-O: Specifies the RM-related object name (shared library's file name).
-i: Specifies the HiRDB-provided header path.