Enabling OLT for WebSphere Advanced Edition and Enterprise Extensions

You can enable OLT using the WebSphere Advanced Edition's Administrator's Console (as described below), and then start OLT, run your application, and trace and/or debug.

WebSphere Application Server Advanced Edition Version 4.0
Before tracing and debugging, or just tracing, in a WebSphere Application Server environment, use the Administrative Console to enable tracing and debugging on the application server where you have deployed your application:

  1. Start the WebSphere Application Server Administrative Console.
  2. Select the Default Server for your node in the topology view on the left side of the console, and then select the JVM Settings tab.
  3. In the JVM Settings tab, click Advanced JVM Settings and enter the path that the debugger uses to search for your application's source code in the Source Path field.
  4. Select the Enable IBM distributed debugger checkbox and then click OK. If you have not previously enabled OLT trace, you will receive a Confirm dialog indicating that the IBM Distributed Debugger will work only when Object Level Tracing is enabled. Confirm this dialog by clicking Yes.
  5. In the Administrative Console, select the Services tab and then select the Object Level Trace Service.
  6. For the selected Object Level Trace Service, click Edit Properties.
  7. In the resulting Object Level Trace Service dialog box, enter the fully-qualified name or TCP/IP address of the machine running your OLT server in the OLT server host field.
  8. Enter the port where the OLT server listens for connecting OLT clients in the OLT server port field. The default port is for the OLT server is 2102.
  9. Click Apply.

Non-managed C++ clients in WebSphere Application Server Enterprise Extensions Version 4.0
To run a C++ client using Object Level Trace and the Distributed Debugger on a host that has WebSphere Application Server Enterprise Extensions Version 4.0 installed, you need to use a client-style properties file to provide the necessary properties and arguments. At run-time, the client application will acquire arguments from this properties file. To use the client style properties file, ensure that the SOMCBPROPS environment variable is set to the name of this file. To run non-managed C++ clients against OLT, the client-style properties file must be set to include the following:

com.ibm.CORBA.debugEnabled=yes
com.ibm.CORBA.oltHostname=
com.ibm.CORBA.oltPort=2102
com.ibm.CORBA.requestTimeout=0

Information for compiling the client for tracing and debugging must also be added to the properties file. For information about this and additional properties that can be used in a client- style properties file, please refer to the Enterprise Extensions documentation.

WebSphere Application Server Advanced Edition Version 3.5
Before tracing or debugging in a WebSphere Application Server environment, use the Administrative Console to enable tracing and debugging on the application server where you have deployed your application, as follows:

  1. Start the WebSphere Application Server Administrative Console.
  2. Expand the host name.
  3. Select the application server where you want to enable tracing and debugging.
  4. Select Debug from the pages at right.
  5. Check the Debug enabled flag. This starts the server in a debuggable JVM.
  6. Check the Object Level Tracing enabled flag. This enables OLT.
  7. Enter the fully qualified name or TCP/IP address of the machine running your OLT server in the OLT server hostname field.
  8. Enter the port where the OLT server listens for connecting OLT clients in the OLT server Port field. The default port is for the OLT server is 2102.
  9. Optional: Enter the path that the debugger uses to search for your application's source code in the Source Path field.
  10. Click Apply.

ngrelt.gif (466 bytes)
Tracing a distributed application
Enabling OLT and the IBM Distributed Debugger for WebSphere Advanced Single Server Edition
Enabling OLT for Component Broker
Compiling application code for OLT and the IBM Distributed Debugger
Preparing for an OLTand IBM Distributed Debugger session on workstations

ngrelr.gif (548 bytes)
WebSphere Advanced Edition: tracing and debugging a servlet