- 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 valid only 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 valid only 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 valid only 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. When you
have successfully changed 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 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, when 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.