Preparing an AS/400 environment for OLT

Before tracing and debugging your AS/400 application, you must configure the WebSphere Application Server environment to enable tracing and debugging. Configuring the WebSphere Application Server on the AS/400 consists of the following steps:

  1. Start the WebSphere Application Server Administrative Console.
  2. Select the Topology view. The Topology view is the default view.
  3. Expand the host name.
  4. Select the application server where you want to enable tracing and debugging.
  5. Stop the application server.
  6. Select Debug from the pages at right.
  7. Check the Debug enabled flag. This allows OLT to start the debugger when you step into a debuggable method in your client application from the OLT viewer.
  8. Check the Object Level Tracing enabled flag. This enables OLT.
  9. Enter the fully-qualified name or TCP/IP address of the machine running your OLT server in the OLT server hostname field.
  10. 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.
  11. Optional: Enter the path that the debugger uses to search for your application's source code in the Source Path field.
  12. Select the General page.
  13. Add the -classpath option to the Command line arguments field:
    -classpath /qibm/userdata/webasadv/myuserid/mydirectory

    where /qibm/userdata/webasadv/myuserid/mydirectory is the root directory containing the debuggable class files.

    For example if you want to debug the com.mycompany.mybeans.AccountBean class, and the debuggable version of the AccountBean class resides in directory /QIBM/UserData/WebASadv/enterprisebeans/com/mycompany/mybeans, specify -classpath /QIBM/UserData/WebASadv/enterprisebeans in the Command line arguments field for the application server.
  14. If your source and class files are in different locations, add the -Ddebugsourcepath option to the Command line arguments field.  For example, if your source for the com.mycompany.mybeans.AccountBean class resides in directory /QIBM/UserData/WebASadv/enterprisebeans/mysource/com/mycompany/mybeans, specify -Ddebugsourcepath /QIBM/UserData/WebASadv/enterprisebeans/mysource in the Command line arguments field for the application server.
  15. Click Apply.

Once you have completed the steps above, you can start OLT on the workstation where you want to trace and debug your application.

Once you have started OLT, start your application server.