メッセージ・フローを経由するメッセージの流れを記録するには、データベースを作成し、セキュリティー設定を構成し、適切な構成可能サービスを作成し、メッセージ・フローのモニターを構成します。
始める前に:データを記録するメッセージ・フローがデプロイ済みであることを確認します。
詳しくは、リソースのデプロイを参照してください。
監査目的または問題判別に役立てるためにデータをデータベースに記録することができます。
WebSphere® Message Broker には、DB2® データベースおよびデータベース表を作成するために使用できるスクリプトが付属しています。
このスクリプトを変更せずにそのまま実行することも、カスタマイズすることもできます。
このスクリプトは、デフォルトのスキーマを持つ MBRECORD というデータベースを作成します。
データを記録するように WebSphere Message Broker を構成するには、以下の手順を実行します。
- WebSphere Message Broker に付属するスクリプトを使用して、データベースを作成し、記録されるメッセージが保管されるように構成します。
- オペレーティング・システム用のスクリプトを見つけます。
- Windows: install_dir¥ddl¥db2¥DataCaptureSchema.sql
- UNIX: install_dir/ddl/db2/DataCaptureSchema.sql
- z/OS® : JCL スクリプトは、データ・セットおよびメンバー SBIPPROC(BIPRRDB) にあります。
install_dir は、WebSphere Message Broker インストールの場所です。
- オプション: 独自のデータベースまたはスキーマを指定するには、付属の DataCaptureSchema スクリプトをカスタマイズし、変更を保存します。
以下の理由でスクリプトを編集することもできます。
- スクリプトを 1 度実行しており、もう一度実行する場合、最初にデータベース MBRECORD を除去する必要があります。
create database MBRECORD という行の前にコマンド drop database MBRECORD を挿入します。
- (エンコードが行われた後) 記録できるメッセージ本体の最大サイズは 5 MB です。
この最大値は、スクリプトを編集して WMB_BINARY_DATA.DATA 列の値を大きくすることによって増やすことができます。
- コマンド・ラインでスクリプトの場所にナビゲートし、スクリプトを実行します。 例えば、Windows または UNIX システムでは以下のコマンドを入力します。
db2 -tvf DataCaptureSchema.sql
- データベースの ODBC 定義を作成します。
付属のスクリプトを変更せずに使用してデータベースを作成した場合、MBRECORD というデータベースの ODBC 定義を、データ・ソース名 (DSN) として MBRECORD を使用して作成します。
詳しくは、データベースへの ODBC 接続の使用可能化を参照してください。
- mqsisetdbparms コマンドを使用して、データベースに接続する際に使用するブローカーのユーザー ID とパスワードを設定します。例えば、次のように入力します。
mqsisetdbparms brokerName -n dataSourceName -u userID -p password
- brokerName は、ブローカーの名前です。
- dataSourceName は、データの記録先とするデータベースを示します。
- userID と password は、ブローカーがデータベースに接続するために使用する ID とパスワードを指定します。
- mqsisetdbparms コマンドに対する変更を有効にするには、ブローカーを再始動します。 詳しくは、ブローカーの開始と停止を参照してください。
- mqsicvp コマンドを使用して、データベースへの接続をテストします。 詳しくは、mqsicvp コマンドを参照してください。
- 適切な構成可能サービスを作成することにより、データ・キャプチャーのランタイム・プロパティーを指定します。
データベースのデータ処理情報および接続情報を指定するには、DataCaptureStore 構成可能サービスを作成します。
このトピックのイベント・データを処理するために使用するモニター・トピックとデータ・キャプチャー・ストアを識別するには、DataCaptureSource 構成可能サービスを作成します。
DataCaptureSource 構成可能サービスの複数インスタンスは、同じ DataCaptureStore 構成可能サービスを使用できます。
- DataCaptureStore 構成可能サービスを構成します。
付属の DefaultCaptureStore 構成可能サービスを使用することも、タイプ DataCaptureStore の独自の構成可能サービスを作成することもできます。
WebSphere Message
Broker Explorer を使用して構成可能サービスを作成することができます。
詳しくは、WebSphere Message Broker Explorer を使用した構成可能サービスの処理を参照してください。
あるいは、mqsicreateconfigurableservice コマンドを使用することもできます。詳しくは、mqsicreateconfigurableservice コマンドを参照してください。
この構成可能サービスのプロパティーについて詳しくは、DataCaptureStore 構成可能サービスを参照してください。
例えば、コマンド・ラインに以下のコマンドを入力します。
mqsicreateconfigurableservice brokerName -c DataCaptureStore -o dataCaptureStoreName
-n dataSourceName,egForRecord -v dataSource,executionGroup
- brokerName は、ブローカーの名前です。
- dataCaptureStoreName は、構成可能サービス・オブジェクトの名前です。
- dataSource は、データ・ソースの名前です。
- executionGroup は、記録するデータを処理する実行グループの名前です。
- DataCaptureSource 構成可能サービスを構成します。
タイプ DataCaptureSource の構成可能サービスを作成します。
構成可能サービスは、WebSphere Message
Broker Explorer または mqsicreateconfigurableservice コマンドを使用して作成できます。
WebSphere Message
Broker Explorer の DataCaptureSourceTemplate を使用する場合、テンプレートに基づいて新規構成可能サービスを作成する必要があります。
新規構成可能サービスを作成せずにテンプレートを編集すると、実行時にエラーが出されます。
この構成可能サービスのプロパティーについて詳しくは、DataCaptureSource 構成可能サービスを参照してください。
例えば、UNIX システムの場合、コマンド・ラインに以下のコマンドを入力します。
mqsicreateconfigurableservice brokerName -c DataCaptureSource -o dataCaptureSourceName -n dataCaptureStore,topic
-v dataCaptureStoreName,'$SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName'
- brokerName は、ブローカーの名前です。
- dataCaptureSourceName は、構成可能サービス・オブジェクトの名前です。
- dataCaptureStoreName は、このサブスクリプションで使用する DataCaptureStore 構成可能サービスの名前です。
- myBroker、executionGroupName、および msgFlowName は、データ取り込み元のブローカー、実行グループ、およびメッセージ・フローの名前です。
これらの値は、トピック・ストリングの一部です。これは、ビジネス・モニターを使用してセットアップするイベントにサブスクライブするために使用されます。
このトピック・ストリングにはトピック・ワイルドカードを使用できます。
UNIX システム上でトピック・ストリングをコマンド・ラインに入力する場合は、単一引用符で囲みます。
Windows システム上では、二重引用符を使用します。
WebSphere Message
Broker Explorer を使って構成可能サービスを作成する場合、引用符は不要です。
brokerName キュー・マネージャー上でサブスクリプションを表示することにより、topic プロパティーに指定されたトピックに正常にサブスクライブされたかどうかテストします。
WebSphere Message
Broker Explorer または runmqsc コマンドを使用します。
WebSphere Message
Broker Explorer を使用してサブスクリプションを確認するには、以下の手順を実行します。
- 「キュー・マネージャー」フォルダーの下のキュー・マネージャーを展開します。
- 「サブスクリプション」ペインを開くには、「サブスクリプション」をクリックします。
- 「最新表示」をクリックして、$SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName というトピック・ストリングのサブスクリプションが存在することを確認します。
runmqsc を使用してサブスクリプションを確認するには、以下の手順を実行します。
- コマンド・プロンプトで、runmqsc qmName を入力します。
qmName はキュー・マネージャー名です。
- キュー・マネージャーのサブスクリプションすべてを表示するには、dis sub(*) を入力します。
- サブスクリプション・トピックのリストにトピック・ストリング $SYS/Broker/myBroker/Monitoring/executionGroupName/msgFlowName が
戻されることを確認します。
- runmqsc 環境を終了するには、end を入力します。
- キャプチャー・イベントが発行されるようにメッセージ・フローでモニターを構成するには、以下のいずれかの方法を使用します。
- イベント・ソースを構成および使用可能にし、ビジネス・レベル・モニターの手順を実行することによってメッセージ・フローのモニターを活動化します。
モニター・トピックにサブスクライブする必要はありません。ブローカーは、DataCaptureSource 構成可能サービスで指定されるトピックへのサブスクリプションを管理します。
- install_dir/sample/RecordReplay/basicMonitoringProfile.xml で提供されるサンプル・モニター・プロファイルを使用することにより、モニター・イベント・ソースを構成します。
サンプル・モニター・プロファイルは、単一の入力ノードに対してのみ機能します。
プロファイルを更新して NODENAME を入力ノードの名前で置き換える必要があります。
このモニター・プロファイルを使用可能にするには、フローをデプロイしたブローカーに対して mqsicreateconfigurableservice、mqsichangeproperties、
および mqsichangeflowmonitoring コマンドを実行します。
これらのコマンドの実行について詳しくは、モニター・プロファイルを使用したモニター・イベント・ソースの構成を参照してください。
次に行う事柄: メッセージを記録した後、それを表示できるようになります。
詳しくは、記録したデータの表示を参照してください。
特定の実行グループの記録を (例えばパフォーマンス上の理由で) 一時的にオフにすることもできます。
詳しくは、データ・キャプチャーの使用不可化と使用可能化を参照してください。データ・キャプチャーの調整について詳しくは、データ・キャプチャーの調整を参照してください。