Tracing errors in mqiptAdmin

The mqiptAdmin command has an execution trace facility that can diagnose errors that occur when an administrative command is issued to MQIPT from the command line.

Procedure

  1. To enable trace for the mqiptAdmin command, set the following environment variable before you run the command:
    • [AIX][Linux]On AIX® and Linux® systems, issue the following command:
      export MQIPT_JVM_OPTIONS="-Dcom.ibm.mq.ipt.trace.override.path=trace_directory -Dcom.ibm.mq.ipt.trace.override.level=5"
    • [Windows]On Windows systems, issue the following command:
      set MQIPT_JVM_OPTIONS=-Dcom.ibm.mq.ipt.trace.override.path=trace_directory -Dcom.ibm.mq.ipt.trace.override.level=5
    Replace trace_directory with the name of the directory that trace files are written to.
    When the mqiptAdmin command runs, a trace file is created in the specified directory. The trace file name has the following format:
    AMQyyyymmddnnnnnnnnn.0.TRC.0
  2. To disable trace for mqiptAdmin, unset the environment variable.