When you collect message flow statistics, you can choose the output destination for the data.
If you start the collection of message flow statistics data by using the IBM® Integration Explorer, the statistics are emitted in XML format in addition to any other formats that are being emitted. If you start the collection of message flow statistics data by using the web user interface, the statistics are emitted in JSON format in addition to any other formats that are already being emitted. As a result, if statistics collection is started through both the IBM Integration Explorer and the web user interface, data is emitted in both XML and JSON formats. If the output format was previously not specified and therefore defaulted to the user trace, the newly specified format replaces the default, and the data is no longer emitted to the user trace. However, if user trace has been explicitly specified, any additional formats that are selected subsequently are emitted in addition to the user trace.
If you use the mqsichangeflowstats command to explicitly specify the required output formats, the formats specified by the command replace the formats that are currently being emitted for the message flow (they are not added to them).
If you stop statistics collection from either the web user interface or the IBM Integration Explorer, all output formats are turned off. If statistics collection is subsequently restarted by using the mqsichangeflowstats command, the output format is reset to the default value of user trace, unless other formats are specified on the command. However, if statistics collection is restarted by using the IBM Integration Explorer, the data is collected in XML format; if statistics collection is restarted through the web user interface, data is collected in JSON format.
Statistics data is written to the specified output location in the following circumstances:
You can specify that the data that is collected is written to the user trace log. The data is written even when trace is switched off.
If no output destination is specified for accounting and statistics, the default is the user trace log. If one or more output formats are subsequently specified, the specified formats replace the default, and the data is no longer emitted to the user trace. However, if user trace has been explicitly specified, any additional formats that are selected subsequently are emitted in addition to the user trace.
The data is written to one of the following locations:
You can specify that the data that is collected is published in JSON format, which is available for viewing in the web user interface. If statistics collection is started through the web user interface, statistics data is emitted in JSON format in addition to any other formats that are already being emitted.
$SYS/Broker/brokerName/Statistics/JSON/SnapShot/integrationServerName/applications/applicationName
/libraries/libraryName/messageflows/messageFlowName
You can specify that the data that is collected is published in XML format and is available to subscribers registered in the broker network that subscribe to the correct topic. If statistics collection is started through the IBM Integration Explorer, statistics data is emitted in XML format in addition to any other formats that are already being emitted.
The topic on which the data is published has the following structure:
$SYS/Broker/brokerName/StatisticsAccounting/recordType/integrationServerLabel/messageFlowLabel
Subscribers can include filter expressions to limit the publications that they receive. For example, they can choose to see only snapshot data, or to see data that is collected for a single broker. Subscribers can specify wild cards (+ and #) to receive publications that refer to multiple resources.
$SYS/Broker/BrokerA/StatisticsAccounting/#
$SYS/Broker/BrokerA/StatisticsAccounting/Archive/Execution/Flow1
$SYS/Broker/BrokerA/StatisticsAccounting/+/Execution/Flow1
For help with registering your subscriber, see Message display, test and performance utilities SupportPac (IH03).
On z/OS, you can specify that the data collected is written to SMF. Accounting and statistics data uses SMF type 117 records. SMF supports the collection of data from multiple subsystems, and you might therefore be able to synchronize the information that is recorded from different sources.
To interpret the information that is recorded, use any utility program that processes SMF records.