- Component
- (Required) This can either be the name of a broker, or of a Configuration
Manager,
or the fixed value, UserNameServer (all are case sensitive
on UNIX systems and on Linux).
Key words workbench and utility are
reserved and must not be used as a component name.
- -u
- (Required for user trace only if the component is a broker)
Specifies that user trace options are to be modified. This
option is only valid if you have specified a broker name as the component
name.
- -e EgName
- (Required for user trace; optional for service trace)
Identifies the execution group for which trace options are
to be modified (for example, started or stopped). This option is valid only
for a broker.
- -f MessageFlow
(Optional) Identifies the message flow for
which trace options are to be modified. This option is only valid if you have
specified an execution group (flag -e).
- -r
(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 only valid if you have specified an execution
group (flag -e).
- -l Level
(Optional) Set the level of the trace. This must be one of:
- normal. This provides a basic level of trace information.
- none. This switches tracing off.
- debug. This provides a more comprehensive trace.
This is valid for all components and each component is created
with a default value of none. If you do not specify this
parameter, the current value is unchanged. Once you successfully change this
value, it is persistent.
- -m Mode
(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 only written to file in batches.
Each component starts with a default value of
safe.
If you do not specify this parameter, the current value is unchanged.
This parameter is valid only if the component you have specified
is:
- A broker. If you change this value, it affects tracing for the execution
group (if you have specified one), or for the agent component (if you have
not specified an execution group).
- The User Name Server. If you change this value,
it affects tracing for the entire component. This second option is valid only
for service trace and, once you have successfully changed this value, it is
persistent.
- -c Size
(Optional) The size of the trace file in KB (kilobytes).
If you do not specify this parameter, the current value is left unchanged.
Each component starts with a default value of 4096 KB. Specify this option
to reset the value. The maximum value you can specify depends on how you subsequently
intend to read the log, using the
mqsireadlog command:
- If you use this 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 this command without setting the -f option,
a WebSphere MQ message is sent to the broker
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.
On HP-UX, set the size value
below 500 MB.
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.
This parameter is valid only if the component you have specified
is:
- A broker. If you change this value, it affects tracing for the execution
group (if you have specified one), or for the agent component (if you have
not specified an execution group).
- The User Name Server. If you change this value,
it affects tracing for the entire component. This second option is valid only
for service trace.