ra.xml file

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