Micro Focus Enterprise Developer 3.0 for Visual Studio 2013 > General Reference > Java Artifacts > Micro Focus Resource Adapters > CICS IBM ECI 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 IBM ECI resource adapter.

The ra.xml file is in the META-INF subdirectory of the mf-ibm-cics-notx.rar archive, located by default in %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\bin. 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>

<config-property>
  <config-property-name>JavaCommAreaEBCDIC</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>CicsCommAreaEBCDIC</config-property-name>
  <config-property-type>java.lang.Boolean</config-property-type>
  <config-property-value>true</config-property-value>
</config-property>

<config-property>
  <config-property-name>JavaContainerEBCDIC</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>CicsContainerEBCDIC</config-property-name>
  <config-property-type>java.lang.Boolean</config-property-type>
  <config-property-value>true</config-property-value>
</config-property>

<config-property>
  <config-property-name>CommAreaAndChannelLogging</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>KeyRingClass</config-property-name> 
   <config-property-type>java.lang.String</config-property-type> 
   <config-property-value>.\estruststore.jks</config-property-value> 
</config-property>

<config-property>
   <config-property-name>KeyRingPassword</config-property-name> 
   <config-property-type>java.lang.String</config-property-type> 
   <config-property-value>password</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`

JavaCommAreaEBCDIC

Indicates whether or not the Java CommArea is ASCII or EBCDIC.

Valid values:	`true` - Java CommArea is EBCDIC `false` - Java CommArea is ASCII
Default:	`false`

CicsCommAreaEBCDIC

Indicates whether or not the CICS CommArea is ASCII or EBCDIC.

Valid values:	`true` - CIC CommArea is EBCDIC `false` - CICS CommArea is ASCII
Default:	`false`

CommAreaAndChannelLogging

Turns logging for CommAreas and Channels on or off.

Valid values:	`true` or `false`
Default:	`false`

JavaContainerEBCDIC

Indicates whether or not the Java Container is ASCII or EBCDIC.

Valid values:	`true` - Java Container is EBCDIC `false` - Java Container is ASCII
Default:	`false`

CICSContainerEBCDIC

Indicates whether or not the CICS Container is ASCII or EBCDIC.

Valid values:	`true` - CICS Container is EBCDIC `false` - CICS Container is ASCII
Default:	`false`

KeyRingClass

The path to the truststore.

Valid value:	The path to the truststore
Default:	`.\estruststore.jks`

KeyRingPassword

The password for the truststore.

Valid value:	The password for the truststore
Default:	`password`