Provides the information required to build an Oracle RM switch module.
Restriction: This topic applies only when the Enterprise Server feature is enabled.
We support Oracle RM switch modules for both Oracle 18 and Oracle 19 databases.
- Source Code
- The Oracle RM switch module COBOL source file,
ESORAXA.CBL is located by default in the
%ProgramFiles(x86)%\Micro Focus\Visual COBOL\src\enterpriseserver\xa directory.
Note: If you prefer to supply user credentials programatically rather than in the xa_open string, instructions for doing so are
provided in the COBOL source file in the
Customization section.
- Building the Switch Module
-
- Method 1
-
- Start a
Visual COBOL command prompt, 32-bit or 64-bit depending on the application, running as an administrator.
- Change to the
%ProgramFiles(x86)%\Micro Focus\Visual COBOL\src\enterpriseserver\xa directory (default location).
- Enter
build
switch-module
Where
switch-module is either
ora18 for Oracle 18 databases, or
ora19 for Oracle 19 databases.
- Method 2
-
- Start a
Visual COBOL command prompt, 32-bit or 64-bit depending on the application.
- Copy all files from the
%ProgramFiles(x86)%\Micro Focus\Visual COBOL\src\enterpriseserver\xa directory (default location) to any location where you have WRITE permission.
- Change to the directory containing the copied files.
- Enter
build
switch-module
Where
switch-module is either
ora18 for Oracle 18 databases, or
ora19 for Oracle 19 databases.
- Build Output
- The build process produces two binary RM switch module files from the
ESORAXA.CBL COBOL source file:
| Binary File
|
Type
|
| ESORAXA.DLL
|
static
|
| ESORAXA_D.DLL
|
dynamic
|
You can register an RM switch module with
Enterprise Server dynamically, or register it statically depending on which binary file you use. We recommend that you use the dynamic switch
module option, as this ensures that only active databases used in the global transaction participate in the TM/RM XA flow.
- Additional Resources
- For more information on using the Oracle RM switch module, including the open string definition and details of supported SQL
operations, see the following:
- The
Database Access - COBSQL (Pro*COBOL) section of the
Additional Software Requirements topic.
- The
Developing Applications with Oracle XA help topic available in the Oracle RDBMS documentation.