メッセージ・フローの統計を収集する場合、データの出力先を選択できます。
以下の状況のときに、指定した出力場所に統計データが書き込まれます。
- アーカイブ・データのインターバルが満了したとき。
- スナップショットのインターバルが満了したとき。
- ブローカーがシャットダウンしたとき。
ブローカーによって収集されたものの、指定した出力先にまだ書き込まれていないすべてのデータが、シャットダウン中に書き込まれます。
その結果、インターバルの途中でのデータが示される場合があります。
- ブローカー構成の何らかの部分が再デプロイされたとき。
再デプロイされた構成データには、既存のレコード構造と整合していない、更新された構成が含まれている場合があります (例えば、メッセージ・フローに追加ノードが含まれていたり、実行グループに新しいメッセージ・フローが含まれている場合があります)。
そのため、現在のデータ (インターバルの途中を表している場合がある) が出力先に書き込まれます。
データ収集パラメーターが変更されるか、またはデータ収集が停止するまで、再デプロイされた構成でデータ収集が続行されます。
- データ収集パラメーターが変更されたとき。
データ収集に設定したパラメーターを更新する場合、データ保全性を保持するために、
メッセージ・フロー (複数の場合もある) に関して収集したすべてのデータが出力先に書き込まれます。
新しいパラメーターに従って、統計の収集が再開されます。
- データ収集が終了されるエラーが発生したとき。
この場合、データ収集を自分で再開しなければなりません。
XML パブリケーション
収集したデータがパブリッシュされるように指定できます。
パブリケーション・メッセージは XML フォーマットで作成され、適切なトピックにサブスクライブする、ブローカー・ネットワークに登録しているサブスクライバーが使用できるようになります。
データがパブリッシュされるトピックは、以下の構造になっています。
$SYS/Broker/brokerName/StatisticsAccounting/recordType/executionGroupLabel/messageFlowLabel
変数は、次の値に対応します。
- brokerName
- 統計が収集されたブローカーの名前。
- recordType
- サブスクライブしているデータのタイプに応じて、Snapshot または Archive に設定されます。あるいは、# を使用して、スナップショットとアーカイブの両方のデータに登録します (作成されている場合)。
- executionGroupLabel
- 統計が収集された実行グループの名前。
- messageFlowLabel
- 統計が収集されたメッセージ・フローのラベル。
サブスクライバーはフィルター式を組み込んで、受け取るパブリッシュを制限することができます。
たとえば、スナップショット・データだけが表示されるようにしたり、1 つのブローカーに関して収集されるデータを表示するようにできます。
サブスクライバーは、ワイルドカード (+ および #) を指定して、複数のリソースを参照するパブリケーションを受け取ることができます。
以下の例は、さまざまな種類のデータを受け取るためにサブスクライバーが登録する必要があるトピックを示しています。
- サブスクライバーが BrokerA 上で実行されるすべてのメッセージ・フローのデータを受け取るには、以下のトピックを登録します。
$SYS/Broker/BrokerA/StatisticsAccounting/#
- サブスクライバーがブローカー BrokerA 上の実行グループ Execution 上で実行されるメッセージ・フロー Flow1 に関連したアーカイブ統計のみを受け取るには、以下のトピックを登録します。
$SYS/Broker/BrokerA/StatisticsAccounting/Archive/Execution/Flow1
- サブスクライバーがブローカー BrokerA 上の実行グループ Execution 上で実行されるメッセージ・フロー Flow1 のスナップショットとアーカイブ・データの両方を受け取るには、以下のトピックを登録します。
$SYS/Broker/BrokerA/StatisticsAccouting/#/Execution/Flow1
メッセージの表示、テスト、
およびパフォーマンス・ユーティリティー SupportPac™ (IH03) は、サブスクライバーを登録する際に役立ちます。
SMF
z/OS では、収集されたデータが SMF に書き込まれるように指定できます。アカウンティング・データおよび統計データは、SMF タイプ 117 レコードを使用します。SMF は複数のサブシステムからのデータの収集をサポートしているため、異なるソースから記録される情報の同期化が可能な場合もあります。
記録された情報を解釈する場合、SMF レコードを処理する任意のユーティリティー・プログラムを使用できます。