mqsichangeflowstats 命令

受支持平台

用途

使用 mqsichangeflowstats 命令:
  • 打开或关闭记帐和统计信息快照应用程序,或压缩记录输出。
  • 指定命令应用于特定流消息流和执行组中的所有流,或属于代理的所有执行组。
  • 修改标准消息流记帐和统计信息以外还收集的数据的颗粒度。这个附加的数据可以包含线程相关的数据、节点相关的数据、节点终端相关的数据或这种数据的混合体。

使用此命令的选项集在被后继 mqsichangeflowstats 命令修改之前保持活动。

语法

Windows 平台、Linux 和 UNIX 系统

z/OS

同义词 cs

参数

brokername
(必需 - Windows 平台、Linux 和 UNIX 系统)指定要更改记帐和统计信息的代理的标签。
-a
(必需)指定命令修改归档记帐和统计信息集合。
注: 必须指定 -a-s。 如果不指定这些参数中的任何一个,会收到警告消息。
-s
(必需)指定命令修改快照记帐和统计信息集合。
注: 必须指定 -a-s。 如果不指定这些参数中的任何一个,会收到警告消息。
-e ExecutionGroupName
(必需)为要更改其计算和统计信息选项的执行组指定名称。
注: 必须指定 -e-g。如果不指定这些参数中的任何一个,会收到警告消息。
-f MessageFlow
(必需)为要更改其记帐和统计信息选项的消息流指定标签。
注: 必须指定 -f-j。 如果不指定这些参数中的任何一个,会收到警告消息。
-g
(必需)指定命令适用于属于代理的所有执行组。
注: 必须指定 -e-g。如果不指定这些参数中的任何一个,会收到警告消息。
-j
(必需)指定命令适用于属于执行组的所有消息流。
注:
  1. 必须指定 -f-j。 如果不指定这些参数中的任何一个,会收到警告消息。
  2. 如果您为所有执行组设置 -g 选项,您必须使用 -j,而不是 -f
-c control
(可选)指定字符串值,该值控制应用于快照或归档的记帐和统计信息集合的操作级别。 可能的值是:
  • 活动的 - 打开快照或归档
  • 不活动的 - 关闭快照或归档。
-t ThreadData
(可选)为消息流指定字符串值以修改线程统计信息数据的集合,可能的值是:
  • 无 - 从统计信息中排除线程相关的数据
  • 基本 - 在统计信息中包含线程相关的数据
-n NodeData
(可选)为消息流指定字符串值以修改节点统计信息数据的集合。可能的值是:
  • 无 - 排除统计信息中节点相关的数据
  • 基本 - 在统计信息中包含节点相关的统计信息
  • 高级 - 在统计信息中包含节点相关和终端相关的数据
-r
(可选)指定需要归档数据的复位。
注: 此操作仅对于归档数据有效。
这导致清空迄今为止此时间间隔中累加的记帐和统计信息数据,并从此时重新启动集合。复位一个或多个执行组中所有流的所有归档数据。

仅当 mqsicreatebroker-v 选项(统计信息归档时间间隔)或 mqsichangebroker 为非 0 时,才重新设置归档时间间隔计时器。即,仅当使用内部时间间隔通知机制并且它不是外部方法(例如,z/OS 上的 ENF)时,才设置时间间隔计时器。

-b AccountingOrigin
(可选)指定环境树路径 Broker.Accounting.Origin 要用于将收集到的统计信息分区到各个不同输出。可能的值是:
  • none - 不要根据记帐原始数据对统计信息进行分区
  • basic - 根据记帐原始数据对统计信息进行分区
-o OutputFormat
(可选)指定统计信息报告的输出目的地。 可能的值是:
  • usertrace - 这是 usertrace 的缺省和写“bip”消息,可以使用 mqsireadlogmqsiformatlog 命令以常规的方式来进行随后的处理。
  • xml - 统计信息报告作为 XML 文档生成并由正运行消息流的代理发布。
    数据发布的主题有以下结构:
    $SYS/Broker/<brokerName>/StatisticsAccounting/<recordType>/<executionGroupLabel>/<messageFlowLabel>
    其中 recordType 设置成 Snapshot 或 Archive,并且代理、执行组和消息流名称是根据订户的需求指定的。
  • smf - (仅 z/OS)。统计信息报告以 SMF 类型 117 记录输出。

权限

用于发出命令的用户标识必须具有 mqbrkrs 权限。

响应

该命令返回下列响应:
  • BIP2226 请求更改消息流节点 ' ' 中的属性:消息流不存在
  • BIP8004 所选的标志和参数无效
  • BIP8013 组件不存在
  • BIP8020 无法访问数据库
  • BIP8029 代理未配置
  • BIP8033 无法发送 XML 消息
  • BIP8038 命令选项不受支持
  • BIP8039 执行组不可用
  • BIP8040 无法连接到数据库

示例

打开 BrokerA 的所有执行组中的消息流“myFlow1”的快照统计,并指定要通过记帐源收集的数据:
mqsichangeflowstats BrokerA -s -g -j -b none
关闭 BrokerA 的执行组“EGRP2”中的消息流“MyFlow1”的归档统计信息的集合,并同时修改将要收集(下次激活时)的数据的颗粒度以包含线程相关的数据。
 mqsichangeflowstats BrokerA -a -e "EGRP2" -f MyFlow1 -c inactive -t basic
关闭代理 A 的所有执行组中的所有消息流的快照数据。
mqsichangeflowstats BrokerA -s -g -j -c inactive
相关概念
消息流概述
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an11770_