IBM Integration Bus, Version 10.0.0.2 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


mqsichangetrace - common text

Specifies that user trace options are to be modified.

Specifies that user trace options are to be modified.

Identifies the integration server for which trace options are to be modified (for example, started or stopped).

(Optional) Identifies the message flow for which trace options are to be modified. This option is valid only if you have specified an integration server (flag -e).

(Optional) This option requests that the trace log is reset: that is, all current records are discarded. Use this option when you start a new trace to ensure that all records in the log are unique to the new trace.

This option is valid only if you have specified an integration server (flag -e).

(Optional) Set the level of the trace. The following options are supported:
  • normal. This option provides a basic level of trace information.
  • none. This option switches tracing off.
  • debug. This option provides a more comprehensive trace.

Each integration node is created with a default value of none. If you do not specify this parameter, the current value is unchanged. When you have successfully changed this value, it is persistent.

(Optional) Indicate the way trace information is to be buffered:
  • safe. This mode causes trace entries to be written to file when they are generated.
  • fast. This mode causes trace entries to be buffered, and written to file in batches.
Each integration node starts with a default value of safe. If you do not specify this parameter, the current value is unchanged.

If you change this value, it affects tracing for the integration server (if you have specified one), or for the agent component (if you have not specified an integration server).

(Optional) The size of the trace file in KB (kilobytes). If you do not specify this parameter, the current value is left unchanged.

Each integration node starts with a default value of 102400 KB. Specify this option to reset the value. The maximum value you can specify depends on how you subsequently intend to read the log, by using the mqsireadlog command;
  • If you use the mqsireadlog command with the -f option set, the log file is read directly from the file system. In this case, the maximum value that you can specify is 2097151, which allows a trace file up to 2 GB (gigabyte) to be created.
  • If you use the mqsireadlog command without setting the -f option, a WebSphere® MQ message is sent to the integration node to retrieve the log. In this case, do not allow the trace file to exceed 70 MB (megabytes). The maximum value that you can set is 70000.

However you intend to retrieve the trace file, you might want to keep its size small, either by using a low value for this parameter, or by using the reset (-r) option on this command to clear the trace log. The benefit of adopting this approach is that the formatting process (mqsiformatlog) is much faster and requires less resource to carry out its task.

If you change this value, it affects tracing for the integration server (if you have specified one), or for the agent component (if you have not specified an integration server).

If you change the trace size, the new value is persistent over a restart of the integration node.

(Required) Specifies the mode for trace flow. Valid values are on and off.

(Required) Specifies that service trace options are to be modified.

(Required) Specifies that service trace options for the agent subcomponent of the integration node specified are to be modified (for example, started or stopped). You can specify this flag only if -t is also specified.

(Optional) In addition to the safe and fast modes available for user trace, there is a third temp mode available with integration server service trace only:
  • temp. This mode is the same as safe mode, but trace is automatically switched off when the component restarts. You can also specify BIP numbers to stop the trace automatically. You can specify up to 10 BIP numbers, separated by commas, as shown in the following examples:
    mqsichangetrace IB9NODE -e default -t -l debug -m temp
    mqsichangetrace IB9NODE -e default -t -l debug -m temp=BIP2213E
    mqsichangetrace IB9NODE -e default -t -l debug -m temp=BIP4395E,BIP2213E

anchtrce.htm | Last updated 2015-09-24 12:53:09