8.2.7 Example of registering in the transaction manager
(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.