To Deploy a Micro Focus Resource Adapter to a Java Application Server

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.
  1. 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.

  2. 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 %ProgramFiles(x86)%\Micro Focus\Visual COBOL\javaee\javaee7\appsrv (Windows) or $COBDIR/javaee/javaee7/appsrv (UNIX) directory, where appsrv represents a directory 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.

  3. 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