Table of Contents
This chapter describes how to configure Tmax environment and use MultipleRM server.
Since a MultipleRM server supports multiple RMs, it cannot use the existing configuration that only allows a single RM per server group. To support MultipleRM, add 'MTMAX' and 'STMAX' to the SVGTYPE item and add the SVGLIST and RMID fields.
MTMAX is a group of STMAX server groups. The servers that belong to MTMAX become MultipleRM servers, and so they can use RMs of the STMAXs specified in the SVGLIST.
For example, if Tibero and Oracle must run in the same process and be included in a single transaction, add Tibero and Oracle to the STMAX server groups. To enable MultipleRM, create a MTMAX server group, add the STMAX server groups to SVGLIST, and then add a server that beongs to the MTMAX server group to SERVER.
The following is an example of the previous environment configuration.
*SVRGROUP
svg_s1 NODENAME = hahehihol,
DBNAME = ORACLE,
OPENINFO="Oracle_Xa+SqlNet=KOR04+Acc=P/scott/tiger+SesTm=60",
TMSNAME = tms_ora,
SVGTYPE = STMAX
svg_s2 NODENAME = hahehihol,
DBNAME = TIBERO,
OPENINFO ="TIBERO_XA:user=scott,pwd=tiger, sestm=60,db=kor01_tibero",
TMSNAME = tms_tbr,
SVGTYPE = STMAX
svgm1 NODENAME = hahehihol,
SVGLIST = "svg_s1,svg_s2",
SVGTYPE = MTMAX
The following is the required STMAX configuration items.
| Item | Description |
|---|---|
| NODENAME | Node name. |
| DBNAME | RM name. Currently only 'TIBERO' and 'ORACLE' are supported. |
| OPENINFO | OPENINFO of STMAX. STMAX is a group of XA servers. |
| TMSNAME | TMS process name that manages the server group's database. |
| SVGTYPE | Must be set to 'STMAX'. |
| RMID | Identifier used to distinguish between STMAXs of a single MTMAX that use the same RM. Not needed if different RMs are used. In the previous example, RMID is not set because all STMAXs use different RMs. For more information about the RMID configuration, refer to Section 3.2.2, “Environment Configuration ”. |
The following are the required MTMAX configuration items.
MultipleRM server can be used similar to TCS and UCS servers. Except for some functions that are used in TCS and UCS, all APIs can be used on MultipleRM server and the program structure is the same.
Program components can vary according to the server type as in the following.
TCS, UCS server
To build TCS and UCS:
User Code + libsvr(ucs) + db_stub(nodb) library
MultipleRM server
To configure MultipleRM:
User Code + libsvr(ucs) + libnodb