1. Homepage

  2. IBM CTG Connector (2.3)

All Connectors

IBM CICS Transaction Gateway Connector - Mule 4

IBM CICS Transaction Gateway Connector バージョン 2.3

IBM CICS Transaction Gateway 用 Anypoint Connector (IBM CTG Connector) は、CICS Transaction Gateway を使用してバックエンド CICS アプリケーションとの統合を実現します。CTG は、Java プラットフォーム向けに Java 暗号化アーキテクチャ (JCA) リソースアダプターを実装することで、Java アプリケーションを Customer Information Control System (CICS) システムに接続できるようにしています。このコネクタは、Mule アプリケーションと IBM CTG の間のリンクとして機能します。

リリースノート: IBM CICS Transaction Gateway Connector リリースノート​
Exchange: IBM CICS Transaction Gateway Connector

始める前に

この情報を使用するには、IBM CTG、Mule Runtime Engine (Mule)、Anypoint Connector、Anypoint Studio、Mule の概念、Mule フローの要素、グローバル要素に精通している必要があります。

対象リソースへの接続をテストするには、ログイン情報が必要です。

Apache Maven でこのコネクタを使用するには、 Anypoint Exchange​ の ​[Dependency Snippets (連動関係スニペット)]​ で pom.xml ファイルの連動関係情報を確認してください。

用語

CICS (Customer Information Control System)

安全で拡張性が高くコスト効果に優れた環境で大量トランザクションのワークロードをサポートするエンタープライズアプリケーションサーバーの統合システム。CICS アプリケーションは、Java から COBOL まで、さまざまな言語で書かれています。

CICS リージョン

CICS によって 1 つの単位として制御される、名前の付いたリソースの集合。CICS リソースとは、タスクを実行するのに必要な、CICS システムを構成する機器またはコンポーネントです。

CICS TG (CICS Transaction Gateway)

リモートクライアントアプリケーションが CICS リージョン内のサービスを呼び出せるようにするためのクライアントおよびサーバーソフトウェアコンポーネントの集合。クライアントアプリケーションには、Java アプリケーションと非 Java アプリケーションがあります。CICS TG は、CICS TG on z/OS と CICS TG for Multiplatforms の 2 つの製品で利用できます。

COMMAREA

プログラム間でのデータの受け渡しに使用される連続したメモリのブロック。COBOL 構造のバイナリ版であり、キャラクターベースで定義されます。

ECI (External Call Interface)

CICS アプリケーションとのリンクに使用されるシンプルなリモートプロシージャーコールスタイルのインターフェース。クライアントアプリケーションと CICS との間でデータをエクスチェンジするためのデータインターフェースとしては COMMAREA またはチャネルが使用されます。

JCA

J2EE プラットフォームを CICS などの異機種エンタープライズ情報システム (EIS) に接続するための標準アーキテクチャ。EIS ベンダーは、JCA に準拠することで自社の EIS 用の標準リソースアダプターを提供することができます。リソースアダプターは、Java アプリケーションと EIS の中間層として機能し、Java アプリケーションを EIS に接続します。

Studio プロジェクトへのコネクタの追加

Anypoint Studio には、Studio プロジェクトにコネクタを追加する 2 つの方法があります。Studio タスクバーの Exchange ボタンから追加するか、[Mule Palette (Mule パレット)] ビューから追加します。

Exchange を使用してコネクタを追加する

  1. Studio で Mule プロジェクトを作成します。

  2. Studio タスクバーの左上にある Exchange アイコン ​(X)​ をクリックします。

  3. Exchange で、​[Login (ログイン)]​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。

  4. Exchange で、「CTG」を検索します。

  5. コネクタを選択して ​[Add to project (プロジェクトに追加)]​ をクリックします。

  6. 画面の指示に従ってコネクタをインストールします。

Studio でコネクタに追加する

  1. Studio で Mule プロジェクトを作成します。

  2. [Mule Palette (Mule パレット)] ビューで、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  3. [Add Modules to Project (モジュールをプロジェクトに追加)]​ で、検索項目に「CTG」と入力します。

  4. [Available modules (使用可能なモジュール)]​ で、このコネクタの名前をクリックします。

  5. [Add (追加)]​ をクリックします。

  6. [Finish (完了)]​ をクリックします。

Studio プロジェクトを設定する

  1. コネクタの操作を Studio キャンバスにドラッグします。

  2. コネクタのグローバル要素を設定します。

    コネクタの設定
    項目 説明

    必須のライブラリ

    • ctgserver.jar (CTG サーバーライブラリ)

    • cicsjee.jar (CICS JEE)

    • ccf2.jar (CICS 共通コネクタフレームワーク)

    • ctgclient.jar (CTG クライアントライブラリ)

    • geronimo-j2ee-connector_1.6_spec.jar

    注意: コネクタと CTG システムとの互換性を確保するため、IBM の Web サイトから SDK の ZIP ファイルをダウンロードするのではなく、CTG サーバーのインストールにバンドルされている JAR ファイルを使用してください。

    Host (ホスト)

    CICS TG のホスト名を入力します。

    Port (ポート)

    CICS TG が動作しているポートを入力します。デフォルト値は 2006 です。

    Server name (サーバー名)

    CICS TG 設定ファイルに定義されている対象 CICS サーバー名を入力します。省略可能。

    Username (ユーザー名)

    CICS ユーザー ID を入力します。CICS リージョンでセキュリティが有効化されていない場合は省略可能です。

    Password (パスワード)

    CICS ユーザー ID のパスワードを入力します。CICS リージョンでセキュリティが有効化されていない場合は省略可能です。

  3. 連動関係を追加するには、​[Add dependency (連動関係を追加)]​ を選択して、項目に情報を入力します。

    連動関係コネクタ

  4. [Additional Settings (追加の設定)]​ タブに移動して設定を完了します。

    コネクタの設定
    項目 説明

    Keystore location (キーストアの場所)

    SSL クライアントに必要な証明書が格納されたキーストアの場所を入力します。省略可能。

    Keystore Password (キーストアパスワード)

    SSL クライアント用のキーストアにアクセスするためのパスワードを入力します。省略可能。

    Connection Timeout (接続タイムアウト)

    クライアントから CTG へのソケットタイムアウトを入力します。デフォルト値は 0 (タイムアウトなし) です。

    Response Timeout (応答タイムアウト)

    クライアントから CTG への応答タイムアウトを入力します。デフォルト値は 30000 ミリ秒 (30 秒) です。 †

    CTG Trace (CTG トレース)

    True​ に設定すると、CTG トレースのすべてのデバッグレベルが有効になります。デフォルト値は ​False​ です。

    †​ ​[Response Timeout (応答タイムアウト)]​ は、サーバー側で ​ecitimeout​ パラメーターが設定されている場合、そのパラメーターで上書きされます。 IBM の ECI Timeout (ECI タイムアウト)​ を参照してください。

  5. 操作を選択します。

    操作コネクタ

    IBM CTG Connector は次の 2 つのアウトバウンド操作をサポートします。

    Name (名前) 説明

    Execute

    データをチャネルおよびコンテナとしてカプセル化して CICS プログラムを呼び出します。

    Execute using COMMAREA

    データを COMMAREA としてカプセル化して CICS プログラムを呼び出します。要求の最大サイズは 32 KB です。

POM ファイル情報

<dependency>
  <groupId>com.mulesoft.connectors</groupId>
  <artifactId>mule-ibm-ctg-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>

x.x.x​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​pom.xml​ ファイル情報を取得するには、​ Anypoint Exchange​ でコネクタにアクセスし、​[Dependency Snippets (連動関係スニペット)]​ をクリックします。

要求および応答のロギングの有効化

コネクタと IBM CTG のインタラクションのロギングを有効にするには、Mule アプリケーションの log4j2.xml ファイルで次のようにロガーを設定する必要があります。log4j2.xml ファイルの ​Loggers​ ブロックに AsyncLogger ステートメントを挿入します。

<AsyncLogger
	name="org.mule.modules.ibmctg.internal.service.CTGServiceImpl"
	level="DEBUG"/>

一般的なユースケース

  • COMMAREA プログラムを呼び出す

  • チャネルプログラムを呼び出す

  • トランザクションスコープ内で COMMAREA またはチャネルを呼び出す

  • カスタムメタデータを追加する

最初の 3 つのユースケースを正常に実施するためには、対象 CICS システムに指定されたプログラムがある必要があります。

関連情報