IBM Support

Collecting a "Utility" trace for IBM Integration Bus

Troubleshooting


Problem

Use this procedure to capture a trace of particular command on IBM Integration Bus (IIB).

Resolving The Problem

First:
Determine whether your mqsi* command is traced via IIB Utility Trace or command flag/argument.
  • Commands using Utility trace are listed in the IIB Knowledge Center's mqsireadlog article.
  • To confirm whether your command has a flag/argument for tracing, locate it in the IIB Knowledge Center (see: Commands)

If your command takes a trace flag/argument, use the correct syntax to enable tracing.


If your command uses IIB Utility Trace, use these instructions:
  1. Enable tracing of utility commands.
    set/export MQSI_UTILITY_TRACE=debug
  2. Set the maximum size of the trace.
    The value is set in kilobytes (here, we suggest 50MB).
    set/export MQSI_UTILITY_TRACESIZE=51200
  3. Run the failing mqsi* command(s)
  4. Disable the trace
    set/export MQSI_UTILITY_TRACE=none
  5. Retrieve the trace log for the specified command.
    This can be issued against all commands executed in step 3.
    mqsireadlog <component> -t -b <mqsicommand> -f -o <mqsicommand>trace.xml
    Note that the <mqsicommand> should just be the command name, and should not include any flags or arguments.
  6. Format the XML trace log(s) into text.
    mqsiformatlog -i <mqsicommand>trace.xml -o <mqsicommand>trace.txt

Note:
The value of '<component>' will change based on the object of the failing mqsi* command. You can find more information in the IIB Knowledge Center on which component name to use.
See: mqsireadlog command.

[{"Product":{"code":"SSNQK6","label":"IBM Integration Bus"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Problem Determination","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"10.0;9.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

WMB MB WebSphere Message Broker MQ Integrator WBIMB WBI-MB MQSI WMQI

Document Information

Modified date:
26 June 2020

UID

swg21461066

Page Feedback