8.2.7 Example of registering in the transaction manager

Organization of this subsection
(1) OpenTP1
(2) TPBroker
(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

To register HiRDB in TPBroker, use TPBroker'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's 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.