- BrokerName
- (Required) Specify the label of the broker for which accounting
and statistics are to be changed.
This parameter is implied on the
console form of the command.
- -a
- (Required) Specify that the command modifies archive accounting
and statistics collection.
You must specify either -a or -s.
If you do not specify one of these arguments you receive a warning message.
- -s
- (Required) Specify that the command modifies snapshot accounting
and statistics collection.
You must specify either -a or -s.
If you do not specify one of these arguments you receive a warning message.
- -e ExecutionGroupName
- (Required) Specify the name for the execution group, for which
accounting and statistics options are to be changed.
You must specify either -e or -g.
If you do not specify one of these arguments you receive a warning message.
- -f MessageFlow
- (Required) Specify the label for the message flow, for which accounting
and statistics options are to be changed.
You must specify either -f or -j.
If you do not specify one of these arguments you receive a warning message.
- -g
- (Required) Specifies that the command applies to all execution
groups that belong to the broker.
You must specify either -e or -g.
If you do not specify one of these arguments you receive a warning message.
- -j
- (Required) Specifies that the command applies to all message
flows that belong to the execution group.
You must specify either -f or -j.
If you do not specify one of these arguments you receive a warning message.
Note: If
you set the -g option for all execution groups,
you must use -j instead of -f.
- -c Control
- (Optional) Specify the string value that controls the level of
the action to be applied to accounting and statistics collection for snapshot
or archiving. Possible values are:
- active - turn on snapshot or archiving
- inactive - turn off snapshot or archiving.
- -t ThreadData
- (Optional) Specify a string value to modify the collection of
thread statistics data for a message flow Possible values are:
- none - exclude thread related data from the statistics
- basic - include thread related data in the statistics
- -n NodeData
- (Optional) Specify a string value to modify the collection of
node statistics data for a message flow. Possible values are:
- none - exclude node related data in the statistics
- basic - include node related statistics in the statistics
- advanced - include node related and terminal related data in the statistics
- -r
- (Optional) This parameter applies only to archive data and specifies
that archive data is to be reset.
This results in the clearing out of
accounting and statistics data accumulated so far for this interval, and restarts
collection from this point. All archive data for all flows in the execution
group, or groups, is reset.
The archive interval timer is only reset
if the -v option (statistics archive
interval) of mqsicreatebroker or mqsichangebroker is non zero.
That is, the interval timer is set only if the internal interval
notification mechanism is being used, and not an external method.
- -b AccountingOrigin
- This parameter has no effect.
- -o OutputFormat
- (Optional) Specify the output destination for the statistics reports.
Possible values are:
- usertrace - this is the default and writes "bip" messages to
usertrace, which can be post processed in the normal way using the mqsireadlog and mqsiformatlog commands
- xml - the statistics reports are generated as XML documents and
published by the broker running the message flow.
The topic on which the
data is published has the following structure:
$SYS/Broker/<brokerName>/StatisticsAccounting/<recordType>
/<executionGroupLabel>/<messageFlowLabel>
where recordType
is set to Snapshot or Archive, and broker, execution group, and message flow
names are specified according to the subscriber's requirements.
- smf - statistics reports are output as SMF type 117 records.