Restriction: This topic applies only when the Enterprise Server feature is enabled.
Tip: For detailed information on deploying specific resource adapters, see the
Related tasks topics listed below.
- Start your Java application server and its administration console, and navigate to where you add resource adapters.
The resource adapter must be deployed on a machine where a COBOL system such as
COBOL Server or
Visual COBOL is installed.
- Specify the resource adapter to deploy. These can be one of the following:
- mfcobol-notx.rar - does not support transactions
- mfcobol-localtx.rar - supports local transactions
- mfcobol-xa.rar - supports XA transactions
Specific versions of these files are supplied for each supported application server. They are supplied with your
Visual COBOL installation in the
$COBDIR/javaee/javaee7/appsrv
directory, where
appsrv represents a subdirectory named for your Java application server and, in some cases, the version as well. For a list of supported
application servers, see the
Java Application Servers section of the
Supported Operating Systems and Third-party Software topic.
- Optionally, configure the resource adapter by editing the
<config-property> values set in the
ra.xml file packaged with the specified
.rar file (see step
2 above). The following describes each editable property:
- ServerHost
- Sets the server host name.
| Valid values:
|
Server host machine name or IP address
|
| Default:
|
localhost
|
- ServerPort
- Specifies the port used by
COBOL Server Web Services and J2EE listeners.
| Valid value:
|
The port number used by
COBOL Server Web Services and J2EE listeners
|
| Default:
|
9003
|
- Trace
- Sets tracing on or off.
| Valid values:
|
true or
false
|
| Default:
|
false
|
- SecureGUID
- Sets the level of encryption for each generated GUID.
| Valid values:
|
true - generates cryptographically strong GUIDs
false - generates GUIDs using the standard Random function seeded with a random number
|
| Default:
|
false
|
- ReadTimeoutInSeconds
- Sets the wait period, in seconds, that a socket waits before timing out on a read.
| Valid values:
|
0 - timeout wait period is infinite
Any positive integer - represents the number of seconds to wait before timing out
|
| Default:
|
0
|
- OpenTimeoutInSeconds
- Sets the wait period, in seconds, that a socket waits before timing out on a connect.
| Valid values:
|
0 - timeout wait period is infinite
Any positive integer - represents the number of seconds to wait before timing out
|
| Default:
|
120
|
- EnterpriseServerSocketCloseDueToInactivity
- Sets the wait period, in hours, that
COBOL Server waits before closing a socket due to inactivity.
| Valid values:
|
0 - timeout wait period is infinite
Any positive integer - represents the number of hours that
COBOL Server waits before closing a socket
|
| Default:
|
72
|