In order to trace or debug with OLT, you must compile your code with specific OLT parameters.
Compiling an unmanaged C++ client for WebSphere Application Server Version
4.0 Enterprise Extensions
When compiling the C++ client code, ensure that debug flags are turned on. When
compiling with the MSVC on Windows NT/2000, you must compile with the /DEBUG
/PDB:NONE link option in addition to compiling with the debug flag (/Z7 or
/Zi)
Compiling Component Broker applications from within Object Builder
Component Broker code must include the IVB_TRACE_DEBUG option. This option sets flags in
the makefile, which in turn add tracing and debugging statements to your server DLL. The
flags are not set by default because the added statements significantly increase the size
of your DLLs. Code compiled with OLT flags will continue to run normally outside of OLT.
CB developers can generate OLT-enabled code by invoking an option in the Object Builder preferences dialog:
All files generated from the build are written to a corresponding output directory
(OUTDIR) according to the build option you selected:
TRACE: Project directory\Working\platform\TRACE
TRACE DEBUG: Project directory\Working\platform\TRACE_DEBUG
Compiling Component Broker applications from the command line
To generate a trace build or trace and debug build from the command line, enter
one of the following commands from your Object Builder working directory:
obgen -p<project_path> -aAll -t<platform> -OIVB_TRACE
obgen -p<project_path> -aAll -t<platform> -OIVB_TRACE_DEBUG
where:
<platform> is 390, AIX, NT, or SOLARIS
Compiling a single Component Broker business object
If you want to trace and debug only one business object, you can save time by recompiling
only that object's makefile. Before doing so, delete the DLL and OBJ files associated with
your object (for example, yourobjectS.dll, yourobjectMO_.obj, and yourobjectBO_I.obj
on Windows NT/2000, or the equivalent *.o, *.so, and *.a files on AIX ), then recompile the
object's make file (yourobjectS.mak) from the appropriate output directory
(either TRACE or TRACE DEBUG).
Compiling CB client applications
Depending on the language used, recompile with the following debug options:
C++ applications:
/Ti+ (compile);
/DEBUG (link)
-g
Java applications:
javac -g
Note: If your client-side code includes transaction timeout values, you must set these values to 0 and recompile before continuing.
Compiling WebSphere servlets or EJBs (Advanced or Advanced Single Server Edition)
For WebSphere applications intended to run outside of a Component Broker
environment, compile with javac -g.
The next step is to enable OLT on your application server (this procedure is different depending on whether you are deploying the application in a Component Broker or WebSphere Application Server environment).
Enabling OLT for Component Broker
Enabling OLT and the IBM Distributed Debugger for WebSphere Advanced Single Server Edition
Enabling OLT for WebSphere Advanced Edition and Enterprise Extensions