テスト・メッセージの書き込み

始める前に

このタスクを完了するには、以下のタスクを完了している必要があります。

メッセージ・フローに MQInput および MQOutput ノードが含まれる場合、最初の MQInput ノードの入力キューにテスト・メッセージを書き込むことによってフローを起動したい場合があります。 このトピックでは、ワークベンチ内のエンキュー・ファイルを構成および使用することにより、テスト・メッセージを書き込む方法を示します。これは、コマンド行インターフェースまたは WebSphere MQ Explorer (WebSphere MQ バージョン 6 の場合) または WebSphere MQ Services (WebSphere MQ バージョン 5 の場合) を使用してメッセージを書き込む方法の代わりとして行える、簡単で反復可能な方法です。

メッセージがメッセージ・フローによって処理されて出力キューに書き込まれる場合、それをそのキューから取り出すことができます。 詳細については、テスト・メッセージの読み取りを参照してください。

エンキュー・ファイルの構成および使用

エンキュー・ファイルを使用してテスト・メッセージを送信できるように、エンキュー・ファイルを構成するには、以下のようにします。

  1. 「ブローカー管理」パースペクティブに切り替えます。
  2. ワークベンチ・ツールバーで、「メッセージをキューに入れる」アイコン メッセージをキューに入れる 上の矢印をクリックします。
  3. ドロップダウン・メニューで「メッセージの挿入...」をクリックして「新規のエンキュー・メッセージ・ファイル」ウィザードを起動します。
  4. デバッグするメッセージ・フローが入っているメッセージ・フロー・プロジェクトを選択します。
  5. 「ファイル名」フィールドで、作成するファイルの名前を入力します (拡張子 .enqueue が自動的に追加されます)。
  6. 「完了」をクリックします。 エンキュー・ファイルが作成されて、その詳細を示すビューが開きます。
  7. このフローのキュー・マネージャーおよび入力ノードのキューの名前を入力します。 キュー・マネージャー名では、大/小文字を区別します。名前を正確に入力したことを確認してください。

    リモート・コンピューター上にある入力キューにメッセージを書き込む場合、 関連するブローカーのキュー・マネージャーに SYSTEM.BKR.CONFIG という名前のサーバー接続チャネルがあることを確認してください。

  8. メッセージをリモート・キューに書き込む場合、値を入力して、キューをホストしているコンピューターのホストとポートを識別します。
  9. 変更の始まりオプション: MQMD タブをクリックして、MQMD ヘッダーのフィールドをカスタマイズします。WebSphere MQ アプリケーション・プログラミング・リファレンス」にあるこれらのフィールドについての説明に目を通してください。定数は「WebSphere MQ Constants」にリストされています。変更の終わり
  10. 「ファイル」 > 「保管」をクリックして、エンキュー・ファイルを保管します。
  11. オプション: このウィンドウから即時にキューにメッセージを挿入するには、「キューへの書き込み」ボタンをクリックします。
  12. 「メッセージをキューに入れる」アイコン メッセージをキューに入れる 上の矢印をクリックすると、ドロップダウン・メニューにエンキュー・ファイルがリスト表示されます。
  13. メニュー上のこのファイルをクリックして (またはそれがメニューの先頭にあれば、アイコン自体をクリックして)、メッセージをキューに書き込みます。 該当するブレークポイントを設定している場合は、 フロー・デバッガーは次のブレークポイントでフローを一時停止します。

後にエンキュー・ファイルを検索するには、 「ブローカー・アプリケーション開発」パースペクティブ に切り替えてメッセージ・フロー・プロジェクトのナビゲーション・ツリーを展開します。 エンキュー・ファイルをダブルクリックして、ビュー内で開きます。

オプション: メッセージへのデータの追加

わずかな量のテスト・データをテスト・メッセージに含めるだけの場合は、データをウィンドウに入力して、テスト・データを素早く追加します。

  1. エンキュー・ファイルを開いて、「ブラウズ」タブを選択します。
  2. "「メッセージ・データ」"ウィンドウに、テスト・データを直接入力します。
  3. 「一般」タブを選択し、「キューへの書き込み」ボタンをクリックして、テスト・メッセージを挿入します。

オプション: サンプル・データのファイルの使用

テスト・メッセージに、大量のサンプル・データ (多少の構造化 XML など) を組み込みたい場合は、 まず最初にそのデータを含むファイルを作成するかインポートしてから、エンキュー・ファイルを取得して使用します。 データの作成と追加にどちらの方法を使用するにしても、以下のオプションの節とステップに従ってください。

サンプル・データを含むファイルを使用するために、エンキュー・ファイルを取得するには、以下のようにします。

  1. 以下に説明する方法で、メッセージ・データ・ファイルを作成またはインポートします。
  2. エンキュー・ファイルを開きます。「ファイル名」「ブラウズ」ボタンをクリックします。
  3. "「メッセージの追加」"ウィンドウでファイルを選択し、「OK」をクリックします。
  4. 終了したら、「ファイル」 > 「保管」をクリックします。
  5. エンキューのビューの下部で「ブラウズ」タブを選択すると、ファイル中のデータが表示されます。 データに変更を加えたい場合は、"「メッセージ・データ」"ウィンドウにテキストを入力するか、「リソース・ナビゲーター」ビューで、ファイルをダブルクリックして編集します。
    ヒント: テキストの代わりに XML データ・ファイルを使用してみることにした場合は、必ずメッセージ・フローの入力ノードのプロパティーを編集し、「メッセージ・ドメイン」「XML」に設定してください。 「変数」ビュー内のフロー・デバッガーにメッセージが表示される際に、XML が構文解析され、ツリー中で展開できるようになります。

オプション: メッセージのサンプル・データのファイルの作成

サンプル・データの新規ファイルを作成するには、次のようにします。

  1. 「ブローカー・アプリケーション開発」パースペクティブに切り替えます。
  2. 「ファイル」 > 「新規作成」 > 「その他...」をクリックします。
  3. 「単純」をクリックしてから、「ファイル」をクリックします。
  4. 「新規ファイル」ウィンドウで、ファイルを保持するプロジェクトを選択してから、「ファイル名」で、ファイルの名前と拡張子を入力します。 ファイルに XML が含まれている場合は、拡張子が .XML であることを確認してください。
  5. 「完了」をクリックします。 ファイルが作成されて、「リソース・ナビゲーター」ビューに表示されます。ビューと、ファイルに該当するエディター (テキストまたは XML) が開きます。
  6. ファイルを編集し、挿入したいテキストまたは XML データを入力します。
  7. 終了したら、「ファイル」 > 「保管」をクリックします。

これで、オプション: サンプル・データのファイルの使用のセクションで説明されているように、ファイルを選択できるようになりました。 ファイルをダブルクリックして適切なエディターで開くこともできます。

オプション: メッセージのサンプル・データの既存ファイルのインポート

テスト・メッセージ中で使用したいサンプル・データを含むファイルがすでにコンピューター上にある場合は、以下のステップを使用して、データをワークベンチ にインポートします。 ファイルに XML が含まれている場合は、 拡張子が .XML であることを確認してください。

  1. 「ブローカー・アプリケーション開発」パースペクティブに切り替えます。
  2. 「ファイル」 > 「インポート」をクリックします。
  3. ウィザードのリストで、「ファイル・システム」を選択して、「次へ」をクリックします。
  4. 「ディレクトリー」で、「ブラウズ」ボタンをクリックして、ファイルを含むフォルダーにナビゲートしてから「OK」をクリックします。 フォルダー内のファイルのリストが表示されます。
  5. ファイルのリストで、インポートするファイルの隣のチェック・ボックスを選択します。
  6. 「フォルダー」で、「ブラウズ」ボタンをクリックし、ファイルを保持するプロジェクトを選択します。
  7. 「完了」をクリックします。

以下のようにファイルをインポートし終えたら、ファイルのコピーが、構成用の他のすべての ワークベンチ・ファイルと共に ワークベンチ データ・スペースに格納されます。元のファイルが直接使用されることはなくなります。

選択したプロジェクトの「リソース・ナビゲーター」内にファイルが表示され、 このページの「オプション: サンプル・データのファイルの使用」セクションで述べられているように、選択することができます。ファイルをダブルクリックして、適切なエディターで開くこともできます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ag16710_