Restriction: This topic applies only when the Enterprise Server feature is enabled.
Note: Dynamic update of the XA Resource properties for an active enterprise server region is currently a technology preview feature
only. It is being made available to allow you to test and provide feedback on this new capability; however, this feature is
not intended for production use and it is not supported as such.
- In the table of servers on the Home page of
Enterprise Server Administration, click
Edit to the left in the row for the
enterprise server region that you want to edit.
- Click the
XA Resources tab.
- Click
Add.
- Specify the details of the XAR:
- 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
the XAID compiler directive option. See
XAID,
and
Planning and Designing XARs for more information. Mandatory.
- Name
- Specify the name by which the XAR is known. Mandatory.
- Module
- Specify the location of the RM switch module executable file (.dll on Windows or
.so on UNIX platforms) 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.
- Reconnection attempts
- The reconnect value controls how many attempts are made to connect to the XA resource. The default value is 1. A value of
0 is not permitted. A -1 value instructs it to continually retry.
- 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.
Important: For more information on the syntax for
Open string, see the
xa_open string topic for your database type, listed below.
- Click
Add.
Note: You cannot add an XAR until all the mandatory fields have values. If you add an XAR whilst the region is running, you can
connect to it as soon as the XAR is enabled.