Install and run Java™ independent programs that use the IBM® DFDL API on systems that do
not have the WebSphere® Message
Broker runtime component
installed.
You can run Java programs
that use the IBM DFDL API on
systems where you have not installed the
WebSphere Message
Broker runtime component, but you
must ensure that you have purchased a
WebSphere Message
Broker 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 WebSphere Message
Broker 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 WebSphere Message
Broker 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 WebSphere Message
Broker.
- 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
Tivoli® License Manager (ITLM). You can use
ITLM to monitor
the usage of IBM (and other)
software products.
To ensure that ITLM reflects the correct license entitlement,
you must choose the correct ITLM license for the edition of WebSphere Message
Broker that you have purchased. For
more information about WebSphere Message
Broker licenses,
see Operation modes.
For more information about
ITLM, see the
IBM Tivoli License Manager Information
Center, or the
IBM Tivoli License Manager 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.