Restriction: This topic applies only when the Enterprise Server feature is enabled.
Use this page to specify the details of an external resource manager that the server needs to communicate with on behalf of container-managed applications.
To access this page:
- From the Enterprise Server Administration Home page, at the left of the Enterprise Server instance to configure, click
Edit.
- On the server instance screen, select the
tabs.
- Select the XA resource to display.
- ID
- Specify an XA resource manager (XAR) ID, used internally to identify a particular XA configuration, and must be unique within the
enterprise server region. This ID is used by
. See
and
Planning and Designing XARs for more information. Mandatory.
- Name
- Specify the name by which the XAR is known. It should match the name returned in the name field of the xa_switch_t structure. Mandatory.
- Module
- Specify the location of the RM switch module executable file (
.so) that contains the entry point that returns the xa_switch_t structure to the enterprise server. We strongly recommend that you include the full path to the executable file. Mandatory.
- Open string
- Specify the string that is passed to the resource manager on the xa_open() call. It usually contains at least the database name, and often the user ID and password credentials for connecting to the database. The contents of this string are database-specific.
Where the RM switch module supports dynamic registration, and the database vendor requires the name of the module that provides the
ax_reg function, you should specify
casaxlib.
- Close string
- The string that is passed to the XAR on the xa_close() call. To find out whether or not you need to supply
Close string, see your database vendor's documentation.
- Description
- Specify an optional text description of the XAR definition.
- Enabled
- Check this to enable the XAR. It is checked by default.