EP アダプターおよびディスパッチャー情報の指定

CICS® がイベント・バインディングによって生成されたイベントを出力する方法を制御する情報をイベント・バインディングで指定します。

このタスクについて

ディスパッチャー情報を使用して、当該バインディングによって発生したイベントに対して実行される内容を定義します。 イベントを出力する EP アダプターを選択してから、EP アダプターに関するオプションを選択します。

手順

  1. CICS event binding editor「アダプター」タブをクリックし、「ここで定義されるアダプターを使用」オプションを選択して、このイベント・バインディングで使用する EP アダプター構成、EP アダプターのパラメーター、および任意の拡張情報を指定します。

    事前定義されている EPADAPTER リソースまたは EPADAPTERSET リソースを使用するかどうかも選択できます。 事前定義された EPADAPTER リソースについて詳しくは、CICS TS 5.1 インフォメーション・センター内の『イベント処理 (EP) アダプター構成エディター』を参照してください。 事前定義された EPADAPTERSET リソースについて詳しくは、CICS TS 5.1 インフォメーション・センター内の『イベント処理 (EP) アダプター・セット・エディター』を参照してください。

    事前定義されている EPADAPTER または EPADAPTERSET リソースを指定する場合は、「名前」フィールドに名前を入力するか、または「選択」をクリックしてリソースを選択する必要があります。 アダプター・リソースの選択について詳しくは、CICS TS 5.1 インフォメーション・センター内の『EP アダプター・リソースの選択』および CICS TS 5.1 インフォメーション・センター内の『EP アダプター・セット・リソースの選択』を参照してください。

  2. オプション: 当該イベント・バインディングの 1 つ以上のイベント仕様をエクスポートできます。
    イベント仕様をエクスポートするには、事前定義された EPADAPTER リソースの名前を入力するか、独自にアダプターを選択します。
    • TSQ EP アダプターまたは WebSphere® MQ EP アダプターを使用し、 CFE 形式を選択してイベントをバイナリー形式で出力します。 この場合、COBOL コピーブック (.cpy) が提供されます。
    • 任意の他の EP アダプターと形式を使用して XML スキーマ定義 (.xsd) を提供します。
    注: トランザクション開始アダプターを使用している場合は、イベント仕様のエクスポートはサポートされません。CICS のコンテナー・ベースのイベント形式について詳しくは、CICS TS 5.1 インフォメーション・センター内の『イベント処理フォーマット』を参照してください。
    1. イベント仕様のエクスポート」をクリックします。 EPADAPTER リソースを使用しており、ワークスペースに同名のアダプターが複数含まれている場合、リストからアダプターを選択するよう求められます。 「イベント仕様のエクスポート」ウィンドウが表示されます。
    2. エクスポートするイベント仕様を選択します。
    3. イベント仕様をエクスポートするために、「宛先ディレクトリー」フィールドにディレクトリーを指定します。
    4. ワークスペース内に存在しない、事前定義された EPADAPTER リソースを使用する場合は、「データ形式」フィールドに適した値を選択する必要があります。
    5. エクスポート」をクリックします。
    選択した各イベント仕様の指定したディレクトリーに、ファイルが作成されます。
    いくつかの指定例を以下に示します。
    • WebSphere MQ EP アダプターと CBE (共通ベース・イベント) 形式を指定して、example1 と example2 という名前の 2 つのイベント仕様を選択した場合には、2 つの XML スキーマ・ファイル (example1_CBE.xsdexample2_CBE.xsd) が作成されます。 これらのスキーマ・ファイルは、IBM® Business Monitor にインポートして、インバウンド・イベントの定義に役立てることができます。
    • WebSphere MQ EP アダプターと WebSphere Business Events (XML) 形式を指定して、example1 という名前のイベント仕様を選択した場合には、XML スキーマ・ファイル (example1_WBE.xsd) が作成されます。 このスキーマ・ファイルを WebSphere Business Events Design Data ツールで使用して、イベントを定義できます。
    • HTTP EP アダプターと Common Base Event REST 形式を指定して、example1 および example2 という名前の 2 つのイベント仕様を選択した場合には、2 つの XML スキーマ・ファイル (example1_CBER.xsdexample2_CBER.xsd) が作成されます。これらのスキーマ・ファイルは、IBM Business Monitor にインポートして、インバウンド・イベントの定義に役立てることができます。
    • HTTP EP アダプターと WebSphere Business Events (XML) 形式を指定して、example1 という名前のイベント仕様を選択した場合には、XML スキーマ・ファイル (example1_WBE.xsd) が作成されます。このスキーマ・ファイルを WebSphere Business Events Design Data ツールで使用して、インバウンド・イベントを定義できます。
    • HTTP EP アダプターと Common Base Event 形式を指定して、example1 および example2 という名前の 2 つのイベント仕様を選択した場合には、2 つの XML スキーマ・ファイル (example1_CBE.xsdexample2_CBE.xsd) が作成されます。これらのスキーマ・ファイルは、Common Base Event 形式を受け入れる任意のコンシューマーにインポートして、インバウンド・イベントの定義に役立てることができます。
    • TS キュー EP アダプターを指定して、example1 と example2 という名前の 2 つのイベント仕様を選択した場合には、2 つの COBOL コピーブック (example1.cpyexample2.cpy) が作成されます。 このコピーブックを使用して、ユーザー作成のイベント・コンシューマー・プログラムでデータを処理できます。

    イベント仕様をエクスポートしてから、同じイベント仕様を同じディレクトリーに再度エクスポートすると、既存のファイルを上書きするか、あるいは、エクスポート操作を取り消すかを尋ねるプロンプトが CICS event binding editorから出ることに注意してください。

  3. アダプター」リストから EP アダプター・タイプを選択します。 以下の EP アダプター・タイプを指定できます。
    TS キュー
    指定された CICS TS キューに、Common Base Event、Common Base Event REST、または WebSphere Business Events (WBE) のいずれかの XML 形式か、非 XML (CFE) 形式でイベントを出力します。 正しいイベントが正しいデータでキャプチャーされていることを検証し、 TS キューから読み取りを行う任意のコンシューマーにイベントを出力する場合は、この EP アダプターを使用します。
    保証イベント出力の場合、同期トランザクション・イベントにはリカバリー可能な TS キューが必要であり、 同期非トランザクション・イベントにはリカバリー不能なキューが必要です。 TS キューがリカバリー可能かどうかは、一致する TSMODEL の設定によって決まります。 TS キューは、一致する TSMODEL が存在するときにのみリカバリー可能です。 同期トランザクション・イベントに対して TS キュー・アダプターを使用する場合、 イベントをキャプチャーする作業単位でイベント TS キューに対して DELETEQ TS コマンドを発行することはできません。
    トランザクション開始
    指定された CICS トランザクションにイベントを出力します。 データは、コンテナー・ベースのイベントの形式でトランザクションに渡されます。 トランザクションを実行する CICS システムを指定できます。 イベント・データが必要でない場合には、既存のトランザクションが使用できます。
    トランザクション開始 EP アダプターは、イベントの保証出力をサポートしません。
    カスタム (ユーザー作成)
    必要な形式でイベントを出力します。 カスタム EP アダプターは、提供されている EP アダプターでサポートされていないイベントの形式設定とルーティングの組み合わせを指定するためにユーザーが作成する CICS プログラムです。 カスタム EP アダプターは、イベントのコンシュームなど、その他の処理を実行してはなりません。
    保証イベント出力の場合、カスタム EP アダプターは、イベントのリカバリー可能要件に準拠していなければなりません。 トランザクション同期イベントまたは非トランザクション同期イベントがサポートされるかどうかは、カスタム EP アダプターの資料を参照してください。
    WebSphere Message Queue
    イベントを WebSphere メッセージ・キューに XML 形式 (WebSphere Business Events が コンシュームする場合)、Common Base Event 形式 (IBM Business Monitor の場合)、 または非 XML 形式で出力します。
    保証イベント出力の場合、WebSphere MQ EP アダプターが永続 WebSphere メッセージ・キューと組み合わせて使用されているときは、 イベント・デリバリーは保証されます。
    HTTP
    HTTP POST を使用して、WebSphere Business Events および IBM Business Monitor などの製品によるコンシューム用の XML 形式で、HTTP 1.1 準拠サーバーにイベントを出力します。
    HTTP EP アダプターは、トランザクション・イベントの保証出力をサポートしません。
  4. 選択した EP アダプター・タイプのオプションを指定します。
    • TS キュー EP アダプターの場合は、以下のオプションを指定します。
      • CICS キュー名を指定します。キュー名は必ず指定する必要があります。
      • ターゲット・キューがリモートである場合には、システム ID を指定します。
      • 必要に応じて、「補助一時ストレージの使用」を選択します。
      • イベントのデータ形式を指定します。「データ形式」リストから以下のいずれかの値を選択します。
        CICS フラット化イベント (バイナリー)
        イベント・データは非 XML 形式となります。
        WebSphere Business Events (XML)
        イベント・データは XML 形式です。
        共通ベース・イベント (XML)
        イベント・データは XML 形式です。
        Common Base Event REST (XML)
        イベント・データは XML 形式です。
    • トランザクション開始 EP アダプターの場合は、以下のオプションを指定します。
      • イベントの結果として実行される CICS アプリケーションのトランザクション ID を指定します。 トランザクション ID は必ず指定する必要があります。
      • トランザクション・ユーザー ID を指定します。トランザクション開始 EP アダプターによって開始されるトランザクションは、 このユーザー ID を使用して実行されます。
      • システム ID を指定します (これは、トランザクション EP アダプターでのみ使用可能)。EP アダプター・トランザクションは、このシステム ID を使用して CICS システムで実行されます。
    • カスタム (ユーザー作成) EP アダプターの場合は、以下のオプションを指定します。
      • 次のいずれかを指定します。
        • 出力モードが非同期の場合は、イベントの形式設定、ルーティング、および出力を行うユーザー作成の CICS アプリケーションのトランザクション ID。カスタム EP アダプターによる非同期出力の場合は、トランザクション ID を指定する必要があります。
        • 出力モードが同期の場合は、イベントの形式設定、ルーティング、および出力を行うユーザー作成の CICS アプリケーション・プログラムの名前。カスタム EP アダプターによる同期出力の場合は、プログラム ID を指定する必要があります。
      • カスタム EP アダプターに渡すデータを記述します。このデータは、カスタム EP アダプターが処理します。
    • WebSphere MQ EP アダプターの場合は、以下のオプションを指定します。
      • 当該イベント・バインディングで出力されたイベントが配置される、WebSphere MQ キューのキュー名を指定します。 キュー名は必ず指定する必要があります。
      • メッセージを永続的なものにするかどうかを指定します。 「永続」リストから以下のいずれかの値を選択します。
        いいえ
        WebSphere MQ EP アダプターによってキューに書き込まれるメッセージは非永続になります。
        はい
        WebSphere MQ EP アダプターによってキューに書き込まれるメッセージは永続になります。
        キューのデフォルト
        キューに書き込まれるメッセージは、指定されたキューのデフォルトの永続性を継承します。
      • メッセージ優先順位を指定します。「キューのデフォルト」を選択するか、「優先順位」フィールドに WebSphere MQ メッセージ優先順位の値 (0 から 9) を入力します。
      • 有効期限時刻を指定します。「有効期限なし」を選択するか、「有効期限時刻」フィールドに WebSphere MQ メッセージの有効期限の値を入力します。 この時刻は 10 分の 1 秒単位で表されます。 メッセージは、この期間が経過する前に宛先キューから除去されなかった場合は破棄の対象となります。
      • イベントのデータ形式を指定します。「データ形式」リストから以下のいずれかの値を選択します。
        CICS フラット化イベント (バイナリー)
        イベント・データは非 XML 形式となります。
        WebSphere Business Events (XML)
        メッセージは、WebSphere Business Events で必要な XML 形式でキューに書き込まれます。
        共通ベース・イベント (XML)
        メッセージは、IBM Business Monitor で必要な Common Base Event 形式でキューに書き込まれます。
    • HTTP EP アダプターの場合は、以下のオプションを指定します。
      • URIMAP を指定します。これは、HTTP 1.1 対応サーバーへの接続を表す URIMAP リソースの名前です。
      • イベントのデータ形式を指定します。「データ形式」リストから以下のいずれかの値を選択します。
        Common Base Event REST (XML)
        イベントは、IBM Business Monitor で必要な XML 形式で HTTP 1.1 対応サーバーに送信されます。
        WebSphere Business Events (XML)
        イベントは、WebSphere Business Events で必要な XML 形式で HTTP 1.1 対応サーバーに送信されます。
        共通ベース・イベント (XML)
        イベントは、Common Event Infrastructure をサポートするいずれの製品でもコンシューム可能な Common Base Event 形式で HTTP 1.1 対応サーバーに 送信されます。
  5. オプション: 必要な拡張ディスパッチャー・オプションを指定します。 これらのオプションは、上級者用であり、CICS システムで EP アダプターが実行される方法を制御するものです。
    注: 通常は CICS で EP アダプターがディスパッチャー・スレッドで実行されるようにしたほうが効果的です。しかし、 EP アダプターを個別のトランザクションとして実行する必要がある場合もあります。例えば、 WebSphere MQ キューへの書き込み権限を持つ特定のユーザー ID の下で EP アダプターを実行する必要がある場合や、 TRANCLASS 設定を使用することによって EP アダプターの並行タスク数を制御する必要がある場合などです。
    1. 出力モードを指定します。 ASYNC または SYNC を指定して、イベントの出力方法を指定できます。保証イベント出力には同期出力モードを指定します。 出力モードが同期モードの場合、WebSphere MQ EP アダプターは以下のイベントを出力します。
      • トランザクション・イベント (MQPMO_SYNCPOINT オプションが使用された場合)。 WebSphere MQ メッセージは、キャプチャー・トランザクションの作業単位でリカバリーできます。
      • 非トランザクション・イベント (MQPMO_NO_SYNCPOINT オプションが使用された場合)。

      出力モードが非同期モードの場合、WebSphere MQ EP アダプターは、MQPMO_NO_SYNCPOINT オプションを使用してイベントを出力します。

      注:
      • 同期イベント (保証イベント出力) の場合、イベント・キャプチャー・アプリケーションには、 イベント出力トランスポートに対する書き込み権限が必要です。 非同期イベントの場合、EP アダプターに書き込み権限が必要です。
      • HTTP EP アダプターに対して SYNC NONTRANS を指定すると、キャプチャー・トランザクションが Web アプリケーションに変わり、しかるべく構成し直さなければならなくなる可能性があります。
      • HTTP EP アダプターを介して同期イベントを出力する可能性があるトランザクションについては、TRANSACTION 定義の DTIMOUT 属性を指定してください。
    2. ディスパッチング優先順位を指定します。通常」または「」優先順位を指定して、イベント・ディスパッチャーが当該イベント・バインディングに関連したイベントを処理する方法を制御できます。 高優先順位のイベントは、「イベントはトランザクション」設定に応じて、使用可能になるとすぐに出力されます。 通常優先順位のイベントは、「イベントはトランザクション」設定に応じて、使用可能になるとすぐに出力されます (ただし、すべての高優先順位のイベントが処理された後)。
      注: このオプションは、同期出力モードには適用されません。
    3. トランザクション ID とユーザー ID を指定します。 アダプターは、指定したトランザクション ID および ユーザー ID を使用して開始されます。トランザクション ID は、代わりに「Adapter (アダプター)」セクションで設定されるため、カスタム EP アダプター・タイプには適していません。トランザクション ID とユーザー ID の設定に応じて、EP ディスパッチャー・タスクは EP アダプター・プログラムを開始するか、または EP アダプター・プログラムにリンクされます。
      表 1. WebSphere MQ EP アダプター、TS キュー EP アダプター、およびトランザクション開始 EP アダプターのトランザクション ID とユーザー ID
      トランザクション ID の指定 ユーザー ID の指定 コンテキスト・ユーザー ID の使用 EP アダプターの状態 EP アダプターの実行に使用するユーザー ID EP アダプターのトランザクション ID
      x x   接続 指定されたユーザー ID 指定されたトランザクション ID
      x   x 接続 コンテキスト・ユーザー ID 指定されたトランザクション ID
        x   接続 指定されたユーザー ID

      WebSphere MQ EP アダプターでは CEPQ
      TS キュー EP アダプターでは CEPT
      トランザクション開始 EP アダプターでは CEPS

          x 接続 コンテキスト・ユーザー ID

      WebSphere MQ EP アダプターでは CEPQ
      TS キュー EP アダプターでは CEPT
      トランザクション開始 EP アダプターでは CEPS

      x     接続 CICS デフォルト・ユーザー ID 指定されたトランザクション ID
            リンク CICS 領域ユーザー ID 適用外
      WebSphere MQ キュー、TS キュー、または開始するトランザクションがリモートの場合は、セキュリティー設定についてを参照してください。
      表 2. HTTP EP アダプターのトランザクション ID とユーザー ID
      トランザクション ID の指定 ユーザー ID の指定 コンテキスト・ユーザー ID の使用 EP アダプターの状態 EP アダプターの実行に使用するユーザー ID EP アダプターのトランザクション ID
      x x   接続 指定されたユーザー ID 指定されたトランザクション ID
      x   x 接続 コンテキスト・ユーザー ID 指定されたトランザクション ID
        x   接続 指定されたユーザー ID CEPH
          x 接続 コンテキスト・ユーザー ID CEPH
      x     接続 CICS デフォルト・ユーザー ID 指定されたトランザクション ID
            接続 CICS デフォルト・ユーザー ID CEPH
      トランザクション ID と非同期出力モードが設定されたカスタム (ユーザー作成) EP アダプターの場合、EP ディスパッチャー・タスクは必ず、指定されたユーザー ID、コンテキスト・ユーザー ID、または CICS デフォルト・ユーザー ID でこのアダプターに接続します。
      注: これら 2 つのオプションは、同期出力モードには適用されません。
    4. イベントがトランザクションかどうかを指定します。 イベントに関連付けられたビジネス作業単位 (UOW) が正常に完了した場合のみ CICS がイベントをキャプチャーするようにするには、「イベントはトランザクション」チェック・ボックスを選択します。
      注: リカバリー不能アクションからキャプチャーされるイベントをトランザクションとして指定すべきかどうか、注意深く考慮してください。 例えば、WEB SEND コマンドからトランザクション・イベントをキャプチャーして、その後作業単位を取り消すと、イベントは取り消されますが、 WEB SEND コマンドが HTTP メッセージを送信したかもしれません。

      CICS でこのイベント・バインディングに関連したイベントをトランザクション外で処理する場合には、「イベントはトランザクション」チェック・ボックスをクリアします。イベントは生成されたときに出力されます。

タスクの結果

これで、イベント・バインディングのアダプターおよびディスパッチャー情報の指定が完了しました。