You can run Java programs
that use the IBM DFDL API on
systems where you have not installed the
IBM Integration Bus runtime component, but you
must ensure that you have purchased a
IBM Integration Bus license for each computer on
which you intend to run Java programs
that use the IBM DFDL API.
The
following instructions use the Windows path
separator; but apply equally to other operating systems, if you change
the separator.
To install and run IBM DFDL
independent programs in an environment that does not have the broker
component installed, complete the following steps:
- Ensure that the target system has a compatible Java Runtime Environment (JRE) installed. Because you are not installing the IBM Integration Bus runtime component, which includes
a JRE, you must use an alternative option. For more information about Java support, see Additional software requirements.
- Copy the following files from a system that has the IBM Integration Bus runtime component installed,
to the target system:
- ibm-dfdl-java.zip from install_dir\tools,
where install_dir is the directory that you specified
as the installation directory for IBM Integration Bus.
- Your Java independent
program that uses the IBM DFDL
API.
- On the target system, extract the contents of ibm-dfdl-java.zip to
a location of your choice; for example, C:\dfdl.
Important: Extracting the contents of
ibm-dfdl-java.zip installs
license and entitlement files onto the target computer for use by IBM
License Metric Tool (ILMT). You can use
ILMT to monitor
the usage of IBM (and other)
software products.
To ensure that ILMT reflects the correct license entitlement,
you must choose the correct ILMT license for the edition of IBM Integration Bus that you have purchased. For
more information about IBM Integration Bus licenses,
see Operation modes.
For more information about
ILMT, see the
IBM License
Metric Tool product documentation, or the
IBM License
Metric Tool website.
Update the class path environment variable:
- Add all of the JAR files that are required
for IBM DFDL. For
example:
set CLASSPATH = %CLASSPATH%;C:\dfdl\lib\ibm-dfdl.jar
Repeat this step for each JAR file in your extract_dir\lib directory,
where extract_dir is the directory to which you
extracted ibm-dfdl-java.zip. Alternatively, to
add all of the required JAR files, run the dfdlprofile utility
that is provided in your extract_dir\bin directory.
- If you want to run and explore the IBM DFDL sample, add the dfdlsample_java.jar JAR
file in your extract_dir\samples directory. For example:
set CLASSPATH = %CLASSPATH%;C:\dfdl\samples\dfdlsample_java.jar
- Add your DFDL independent program JAR file.
- Add any other JAR files and directories that you require.
Next: You can now run your DFDL independent programs
on the target computer.