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


mqsiflowstats commands - common text

integrationNodeName
(Required) Specify the label of the integration node for which the previously stored accounting and statistics options are to be reported.
-a
(Required) Specify that the command modifies archive accounting and statistics collection.
(Required) Specify that the command reports the stored settings for the 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.

You must specify -a or -s, or both arguments. If you do not specify at least one of these arguments you receive a warning message.

-s
(Required) Specify that the command modifies snapshot accounting and statistics collection.
(Required) Specify that the command reports the stored settings for the snapshot accounting and statistics collection.
-e integrationServerName
(Required) Specify the name for the integration server, for which accounting and statistics options are to be changed.
(Required) Specify the name for the integration server, for which accounting and statistics options are to be reported.

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.
(Required) Specify the label for the message flow, for which accounting and statistics options are to be reported.

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 integration servers that belong to the integration node.
-j
(Required) Specifies that the command applies to all message flows that belong to the integration server.

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 integration servers, 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 integration server, 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.

That is, the interval timer is set only if the internal interval notification mechanism is being used, and not an external method; for example, ENF on z/OS®.

-b AccountingOrigin
This parameter has no effect.
(Optional) Specifies that the environment tree path Broker.Accounting.Origin is used to partition the collected statistics into distinct outputs. Possible values are:
  • none - do not partition statistics according to accounting origin data
  • basic - partition statistics according to accounting origin data
-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 integration node running the message flow.
    The topic on which the data is published has the following structure.
    • For publications on an MQ pub/sub broker:
      $SYS/Broker/integrationNodeName/StatisticsAccounting/recordType/integrationServerName/message_flow_name
    • For publications on an MQTT pub/sub broker:
      IBM/IntegrationBus/integrationNodeName/StatisticsAccounting/recordType/integrationServerName/message_flow_name
    where recordType is set to Snapshot or Archive, and integration node, integration server, and message flow names are specified according to the subscriber's requirements.
  • smf - statistics reports are output as SMF type 117 records.

anflstat.htm | Last updated 2015-03-27 19:27:11