OLT Viewer - Client Controller page

The OLT Client Controller lets you set the parameters that tell the trace components what mode the client application should execute in as well as the location of the debugger. 

The Client Controller displays the host name and the client applications executing on them. For each client, you can change the execution mode and debugger settings. You can check Use default settings for all clients to use the same settings for all clients you trace. To set the default settings choose the Default settings node in the tree, change the settings to desired values, and click Apply.

The Client Controller lets you choose a monitoring mode while your application runs. Any change you make to the monitoring mode takes effect right away.

Changes made to the debugger hostname and TCP/IP port take effect the next time the client application is run.

Help is available for the following Client Controller fields:

Execution mode settings
OLT offers four options for monitoring applications. While running an application, you can switch execution modes by selecting the application from the tree, selecting a new mode and clicking Apply. The new mode takes effect on the next call to the application server.

Debugger hostname
The host name of the machine where the debugger is to open (the default is the host name of the current workstation). 

If the debugger hostname is the host name of the current workstation and you register a client application with OLT to execute in Debug only or Trace and debug mode, the debugger daemon is automatically started.

If you intend to interact with the debugger on a different machine, follow these steps:

  1. Start the debugger daemon manually on the machine where you want the debugger to open.
  2. Select the node representing the client application waiting for registration from the tree view.
  3. Enter the host name and TCP/IP port for the workstation on which you intend to run the debugger daemon.
  4. Select Debug only or Trace and debug from the Execution mode settings.
  5. Click Apply to start tracing and debugging your client application.

Debugger TCP/IP port
The port where the OLT debugger daemon is listening (the default port is 8001). You need only change this value if the port 8001 is already in use. This is more common in a multi-user environment like AIX.

Restriction: Port 8002 is reserved for use by the debugger user interface.

If you change the debugger's TCP/IP port value, you must update the idebug entry in the services file on all clients and servers affected by the change and all machines running the application.

On Windows NT, the services file is located in winnt\system32\drivers\etc.

On AIX, the services file is located in /etc.

If you change the debugger hostname and TCP/IP port while the client application is running, the changes will only take effect the next time you start the application.