Micro Focus Enterprise Developer 2.3 Update 2 for Eclipse > General Reference > Java Artifacts > Micro Focus Resource Adapters > CICS Resource Adapter > ra.xml file

ra.xml file

Describes the contents of the ra.xml file, which includes a list of properties that configure your CICS resource adapter.

The ra.xml file is in the META-INF subdirectory of the mfcics-notx.rar archive, located by default in %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\bin (Windows) or $COBDIR/lib (UNIX). Its contents include a list of properties in XML format. You can edit this file to configure your CICS resource adapter by modifying the property values.

<config-property>
  <config-property-name>ServerHost</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
  <config-property-value>localhost</config-property-value>
</config-property>
<config-property>
  <config-property-name>ServerPort</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
  <config-property-value>9003</config-property-value>
</config-property>
<config-property>
  <config-property-name>Trace</config-property-name>
  <config-property-type>java.lang.Boolean</config-property-type>
  <config-property-value>false</config-property-value>
</config-property>
<config-property>
  <config-property-name>SecureGUID</config-property-name>
  <config-property-type>java.lang.Boolean</config-property-type>
  <config-property-value>false</config-property-value>
</config-property>
<config-property>
  <config-property-name>secureConnection</config-property-name>
  <config-property-type>java.lang.Boolean</config-property-type>
  <config-property-value>false</config-property-value>
</config-property>
<config-property>
  <config-property-name>ReadTimeoutInSeconds</config-property-name>
  <config-property-type>java.lang.Integer</config-property-type>
  <config-property-value>0</config-property-value>
</config-property>
<config-property>
  <config-property-name>OpenTimeoutInSeconds</config-property-name>
  <config-property-type>java.lang.Integer</config-property-type>
  <config-property-value>120</config-property-value>
</config-property>
<config-property>
  <config-property-name>EnterpriseServerSocketCloseDueToInactivity</config-property-name>
  <config-property-type>java.lang.Integer</config-property-type>
  <config-property-value>72</config-property-value>
</config-property>

The following describes each property:

ServerHost

Sets the server host name.

Valid values:	Server host machine name or IP address
Default:	`localhost`

ServerPort

Specifies the port used by Enterprise Server Web Services and J2EE listeners.

Valid value:	The port number used by Enterprise 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`

secureConnection

Turns SSL on or off.

Valid values:	`true` or `false`
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 Enterprise 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 Enterprise Server waits before closing a socket
Default:	`72`