Table of Contents
These instructions apply if you are installing from the coxbgen standalone distribution. If you are installing the complete LegStar distribution please refer to legstar distribution.
Alternatively, the COBOL Transformers generator can be installed as an Eclipse plugin which contains all the necessary components. More details on this option are available on the LegStar Eclipse site. However, the plugin does not include the samples. Furthermore, the libraries that you would need to run your Transformers are not easily accessible with the plugin so we still recommend that you perform a standalone installation as described in this document.
Java 1.5+ and ant 1.6.5+ are both prerequisites for LegStar. This module requires a JDK, or an international version of the JRE, that includes charsets.jar. Make sure JAVA_HOME and ANT_HOME environment variables are set and that $JAVA_HOME/bin (%JAVA_HOME%/bin on Windows) and $ANT_HOME/bin (%ANT_HOME%/bin on Windows) are both in your system path.
Coxbgen relies on Sun's JAXB. The JAXB implementation must be at least 2.1 compliant. Such an implementation is part of the LegStar distribution.
You will likely need the LegStar tools that generate XML Schemas with COBOL annotations as this is the major input to COBOL Transformers generator:
COBOL to XML Schema Translator: used when the starting point is a COBOL structure.
XML Schema to COBOL Translator: used when the starting point is a Java class, an XML Schema or a WSDL.
Download the latest coxbgen standalone distribution.
Unzip the binary distribution package into the directory of your choice, referred to as <installDir> in the following steps.
The directory tree should look like this:
<installDir>
|-->LICENSE
|-->NOTICE
|-->readme.html
|--><samples>
|--><quickstarts>
|--><adapter_lsfileae>
|-->build-jaxb.xml
|-->build-coxb.xml
|--><schema>
|-->lsfileae.xsd
|--><proxy_pojo_jvmquery>
|-->build-jaxb.xml
|-->build-coxb.xml
|--><src>
|-->**/*.java
|--><schema>
|-->jvmquery.xsd
|--><proxy_ws_cultureinfo>
|-->build-jaxb.xml
|-->build-coxb.xml
|--><schema>
|-->jvmquery.xsd
|--><lib>
|-->*.jar
At this stage, you will probably want to run the samples provided