イベント仕様のエクスポート

イベント・バインディングに含まれる 1 つ以上のイベント仕様の記述をスキーマまたはコピーブックとしてエクスポートして、別の場所で使用することができます。

始める前に

イベント・バインディング・ファイルを格納する CICS® バンドル・プロジェクトが必要で、イベント・バインディングに使用する EP アダプターを指定する必要があります。

このタスクについて

エクスポートされるファイルには、イベント・データのフォーマットが含まれています。これは、キャプチャーしたデータをプログラムまたはデータ処理エンジンで処理するときに役立ちます。

エクスポートしたファイルがスキーマとコピーブックのどちらになるかは、選択した EP アダプター、または選択した EP アダプター・セット内の EP アダプターによって指定された、データ形式によって決まります。
  • Common Base Event、Common Base Event REST、Decision Server Insights Event、WebSphere® Business Events などの XML 形式の場合、エクスポートしたファイルは XML スキーマ定義 .xsd ファイルになります。以下のアダプターが、イベントを XML 文字フォーマットで出力できます。
    • HTTP アダプター
    • TD キュー・アダプター
    • TS キュー・アダプター
    • IBM® MQ キュー・アダプター
  • 非 XML 形式、つまり CICS フラット化イベント形式の場合、エクスポートしたファイルは COBOL コピーブック .cpy ファイルになります。 以下のアダプターが、イベントを CICS フラット化イベント形式で出力できます。
    • TD キュー・アダプター
    • TS キュー・アダプター
    • IBM MQ キュー・アダプター
注: トランザクション開始アダプターやカスタム・アダプターのイベント仕様をエクスポートすることはできません。

手順

  1. CICS イベント・バインディング・エディターの「アダプター」タブから「イベント仕様のエクスポート」をクリックします。
  2. 以下のいずれかの場合には、アダプターまたはアダプター・セットの選択を求めるプロンプトが出されます。
    • ワークスペースで、指定したアダプター、または指定した EP アダプター・セット内のアダプターと同じ名前を複数の EP アダプターが使用している。
      「EP アダプターの選択」ウィンドウ
    • ワークスペースで、指定した名前を複数の EP アダプター・セットが使用している。
      「EP アダプター・セットの選択」ウィンドウ
  3. 「ルールのイベント仕様のエクスポート (Export Event Specifications for Rule)」ウィンドウで、対応するフィールドに正しい情報が指定されていることを確認します。 仕様のエクスポート・ウィンドウ
    エクスポート
    エクスポートするイベント仕様。
    宛先ディレクトリー
    エクスポートされるイベント仕様を保管するためのローカル・ディレクトリー。
    データ形式
    EP アダプター、または EP アダプター・セット内の EP アダプターで指定されているデータ形式。

    このフィールドは、EP アダプター、EP アダプター・セット、または EP アダプター・セット内の EP アダプターがワークスペースにないために CICS Explorer® がデータ形式を判別できないときに表示されます。

    注: データ形式情報は、EP アダプターで指定されているデータ形式と一致させておいてください。そうしないと、エクスポートされたファイルをデータ処理に使用するときに失敗する可能性があります。
  4. 「OK」をクリックします。
  5. 同じ名前でエクスポートされたイベント仕様が、指定したディレクトリーに既に存在する場合は、既存のファイルを上書きするかエクスポートを取り消すかを確認するプロンプトが出されます。

タスクの結果

選択した各イベント仕様の指定したディレクトリーに、1 つ以上のファイルが作成されます。 以下に、さまざまなイベント仕様に対して作成されるファイルの例を示します。
  • IBM MQ キュー・アダプターと Common Base Event 形式を指定し、example1 および example2 という 2 つのイベント仕様を選択した場合には、2 つの XML スキーマ・ファイル (example1_CBE.xsdexample2_CBE.xsd) が作成されます。これらのスキーマ・ファイルは、IBM Business Monitor にインポートして、インバウンド・イベントの定義に役立てることができます。
  • IBM MQ キュー・アダプターと WebSphere Business Events (XML) フォーマットを指定し、example1 というイベント仕様を選択した場合には、example1_WBE.xsd という XML スキーマ・ファイルが作成されます。このスキーマ・ファイルを IBM Operational Decision Manager Event Designer ツールで使用して、イベントを定義できます。
  • IBM MQ キュー・アダプターと Decision Server Insights Event (XML) 形式を指定し、example1 というイベント仕様を選択した場合は、example1_DSIE.xsd という XML スキーマ・ファイルが作成されます。 このスキーマ・ファイルを IBM Operational Decision Manager Insight Designer ツールで使用して、イベントを定義できます。
  • TD キュー・アダプターまたは TS キュー・アダプターと CICS フラット化イベント形式を指定し、example1 および example2 という 2つのイベント仕様を選択した場合は、example1.cpyexample2.cpy の 2 つの COBOL コピーブックが作成されます。このコピーブックを使用して、ユーザー作成のイベント・コンシューマー・プログラムでデータを処理できます。
  • TD キュー・アダプターまたは TS キュー・アダプター (CICS フラット化イベント形式) と IBM MQ キュー・アダプター (WebSphere Business Events (XML) フォーマット) を含む EP アダプター・セットを指定し、example1 および example2 という 2 つのイベント仕様を選択した場合は、形式を示す拡張子が付いた 4 つのファイル (example1.cpyexample1_WBE.xsdexample2.cpyexample2_WBE.xsd) が作成されます。これらのファイルは、プログラムおよび IBM Operational Decision Manager Event Designer ツールで使用できます。
  • TD キュー・アダプターまたは TS キュー・アダプター (CICS フラット化イベント形式 ) と IBM MQ キュー・アダプター (Decision Server Insights Event (XML) 形式) を含む EP アダプター・セットを指定し、example1 および example2 という 2 つのイベント仕様を選択した場合は、形式を示す拡張子が付いた 4 つのファイル (example1.cpyexample1_DSIE.xsdexample2.cpyexample2_DSIE.xsd) が作成されます。これらのファイルは、プログラムおよび IBM Operational Decision Manager Insight Designer ツールで使用できます。