Configuring logging and tracing

This section describes how to set up message logging and tracing. These settings can be made by using The Edit Configuration option in System Manager and by manually editing the InterchangeSystem.cfg file. The following tasks are described:

"Steps for opening the Edit Configuration tool"

"Steps for configuring InterChange Server Express logging and tracing destinations"

Steps for configuring other InterChange Server Express logging and tracing parameters

Steps for configuring the connector agent logging destination

Steps for configuring tracing levels for InterChange Server Express, business objects, and collaborations

Steps for configuring the collaboration object trace level

Steps for configuring connector tracing

Steps for configuring map tracing

Steps for opening the Edit Configuration tool

InterChange Server Express must be running and in the Connected state to use the Edit Configuration tool. The Edit Configuration tool can manage only one InterChange Server Express per session.

Perform the following steps to open the Edit Configuration tool:

  1. Open System Manager.
  2. Right-click a server instance in the InterChange Server Component Management view and click Edit Configuration. The Edit Configuration tool opens in the upper-right section of System Manager, where you can edit the InterchangeServer.cfg file in the

Steps for configuring InterChange Server Express logging and tracing destinations

Perform the following steps to configure the destination for InterChange Server Express message logging and tracing:

  1. In the Edit Configuration tool, click the Trace/Log Files tab.

    The logging and tracing configuration window appears (see Figure 50).

    Figure 50. Edit Configuration tool, Trace/Log Files tab


  2. Under Logging, select the destination for system logging. You can log to both system console and a log file, but use this option only for debugging and only on development systems. Do the following:
  3. Under Tracing, select the destination for system tracing. Do the following:
  4. To configure IBM WebSphere MQ tracing, accept the default path name of the file or click the browse button to navigate to the log file.
  5. Click OK to save changes and exit.

Your changes take effect immediately, and if you already had a log file configured, it is saved and dated, and a new file created using the newly entered configuration.

Steps for configuring stack trace

When InterChange Server Express stack tracing is enabled, the stack trace information is printed to the InterChange Server Express log file. This can be useful for troubleshooting a newly installed system.

Perform the following steps to configure the stack tracing feature:

  1. Open the Edit Configuration tool (see Steps for opening the Edit Configuration tool).
  2. Click the Trace/Log Files tab.
  3. Select the Enable Stack Tracing check box. When you enable stack tracing, the Tracing Severity Level list is available.
  4. In the Tracing Severity Level list, select the severity level for which you want to print the stack tracing. The choices are: INFO, WARNING, ERROR, and FATAL. When stack tracing is printed to the log file, it prints the level you select and all levels above it. For example, if you select ERROR, both ERROR and FATAL messages are printed to the log file.

Steps for configuring other InterChange Server Express logging and tracing parameters

Perform the following steps to set file size and number of archived files for log and trace files:

  1. Open the Edit Configuration tool (see Steps for opening the Edit Configuration tool).
  2. Click the Trace/Log Files tab.
  3. To limit the log file, select the To File and the Unlimited check boxes, and select a number to represent the maximum log file size from the Log file list, and then select Byte, KB (kilobyte), MB (megabyte), or GB (gigabyte).
  4. To limit the trace file, select the To File and the Unlimited check boxes, select a number to represent the maximum trace file size from the Trace file list, then select Byte, KB (kilobyte), MB (megabyte), or GB (gigabyte).
  5. To set the number of log or trace file archives, select a number from the Number of archives list under either Logging or Tracing section.
  6. Stop and restart InterChange Server Express.

Steps for configuring the connector agent logging destination

The two connector components have separate mechanisms for logging. Connector controller logging is sent to the InterchangeServer.log file. This section describes configuring the connector agent log file name and location.

For background information on connector agent logging, see "Connector Agent logs".

You can set the destination for connector agent logging using one of the following methods:

Perform the following steps to configure the destination for connector agent logging using Connector Configurator Express:

  1. Connect to a server.
  2. In System Manager, right-click a connector object, then select Edit definition. The Connector Configurator Express widow appears.
  3. Click the Standard Properties tab.
  4. Select one of the logging property values (see Table 18 for an explanation of these values), and click Edit.
  5. Type the new value in Value field and click OK.

    For example, change the LogAtInterchangeEnd value to true to send messages to the InterChange Server Express log. If InterChange Server Express is configured to send e-mail when error and fatal messages are logged, e-mail is sent for the connector agent messages as well.

  6. Repeat Steps 3 and 4 to edit the other logging property value if necessary.

    For example, to send connector agent messages to a message file instead of the default STDOUT, enter the full path name of the file in the Value field.

  7. Restart the connector for changes to take effect.
Note:
If you want to specify a logging and tracing file for the connector agent, you must specify a local configuration file when starting the agent.

Steps for configuring tracing levels for InterChange Server Express, business objects, and collaborations

Perform the following steps to configure tracing:

  1. Open the Edit Configuration tool (see Steps for opening the Edit Configuration tool).
  2. Click the Tracing Levels tab (see Figure 51).

    Figure 51. Edit Configuration tool, Tracing Levels tab


  3. To configure subsystem tracing, under IBM WebSphere Business Integration Trace Levels, select a Trace level for the subsystems you want to configure.

    Setting these trace levels updates parameters in the InterchangeSystem.cfg file. For details about what information is produced at the various tracing levels, see WebSphere Business Integration Server Express Installation Guide.

  4. To configure tracing for collaborations, do the following:
  5. To configure tracing for business objects, do the following:
  6. Click OK to save changes and exit.

    The trace levels for the subsystems, business objects and collaborations are immediately in effect.

Steps for configuring the collaboration object trace level

This section describes one of two methods that can be used to configure collaboration object trace levels. For the alternative method, see Steps for configuring tracing levels for InterChange Server Express, business objects, and collaborations.

Perform the following steps to configure the collaboration object trace level:

  1. In System Manager, go to the InterChange Server Component Management view, right-click the collaboration object, and click Properties. The Properties dialog box appears.
  2. Do one of the following on the Collaboration General Properties tab:

Steps for configuring connector tracing

Perform the following steps to configure connector tracing:

  1. From System Manager, right-click the connector object, then click Edit definition. The Connector Configurator Express window appears.
  2. Do one of the following:
  3. Click File > Save > To Project.
  4. Close Connector Configurator Express.

    Any changes to these properties take effect immediately. Trace messages for connector controllers appear wherever InterChange Server Express sends its trace messages, and trace messages for connector agents appear wherever the connector agent logs messages.

    Note:
    If you want to specify a logging and tracing file for the connector agent, you must specify a local configuration file when starting the agent.

Steps for configuring map tracing

Perform the following steps to set the trace level for a map:

  1. In System Manager, go to the InterChange Server Component Management view, right-click the map object, and click Properties. The Maps Property Page appears (see Figure 52).

    Figure 52. Maps Property Page


  2. In the Trace Level field, type the appropriate value.
  3. Click OK.

Copyright IBM Corp. 2004