Using the dynamic adapter trace feature

This feature is helpful for resolving adapter issues without having to:

  • bring the Launcher down to add tracing to the adapter command lines
  • having to recompile and redeploy the maps
  • having to restart the Launcher

The following procedure assumes you have connected to a Launcher from the Management Console and have selected the Compound System that appears in the navigation pane.

Refer to "Multiple Processes" for additional information when using the multiple-processes feature.

To use the dynamic adapter trace feature:

  1. Start the Launcher.

    When the Launcher starts, it will initialize all trace settings to default values as configured on the adapter command line. Tracing will be done for all watches according to the adapter command line settings.

    The MapAdapterTraceOff INI setting is used to override the default tracing at the startup of the Launcher.

    When the MapAdapterTraceOff INI setting is commented or 0, it indicates that the default tracing should be used at the startup of the Launcher.

    When the MapAdapterTraceOff INI setting is 1, it indicates that tracing is turned off for all components at the startup of the Launcher, regardless of the command line settings.

  2. Enable the adapter tracing feature in the Management Console.
  3. Configure adapter tracing dynamically through the configuration pane.
  4. Modify adapter tracing configurations.
    Note: When you modify the adapter tracing configurations after a Launcher has started, the changes will take affect in the next map that is run for that component.