3.2. OTS Configuration File

Similar to the RESOLVE_INITIAL_REFERENCES option, JBoss Transaction Service supports an initial reference file where references for specific services can be stored and used at run-time. The file, CosServices.cfg, consists of two columns: the service name (which is always TransactionService if you are using OTS server) and the IOR, separated by a single space. CosServices.cfg normally resides in the etc directory of the JBoss Transaction Service installation, although the actual location is determined at run-time by searching the CLASSPATH for a copy of the file in an etc directory or the location of the TransactionService properties file directory.

The OTS server creates this file if not found, and registers itself within the file. Stale information is automatically removed. Machines sharing the same transaction server need access to either this file itself, or a copy of it.

You can override the name and location of the file using the com.arjuna.orbportability.initialReferencesFile and com.arjuna.orbportability.initialReferencesRoot variables, respectively.

com.arjuna.orbportability.initialReferencesFile=myFile
com.arjuna.orbportability.initialReferencesRoot=c:\\temp