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 (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>
<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