ra.xml file

The ra.xml file is in the META-INF subdirectory of the resource adapter, located by default in the appropriate application-server-specific directory under $COBDIR/javaee-ccl. 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>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

CommAreaAndChannelLogging

Turns logging for CommAreas and Channels on or off.

Valid values:	true or false
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