最適化されたローカル・アダプターでローカルのデーモン・グループへのアウトバウンド呼び出し、または WebSphere® Application Server セルへのインバウンド呼び出しを実行するには、現行アドレス・スペースを WebSphere Application Server デーモン・グループにバインドし、接続属性を設定します。
始める前に
WebSphere Application Server デーモン・グループが、登録要求の発信元と同じ z/OS® イメージ上でアクティブになっている必要があります。
顧客情報管理システム (CICS®) を使用している場合は、CICS と
WebSphere Application Server との間に接続が確立される前に、Task Related User Exit (TRUE) プログラムがアクティブになっている必要があります。
情報管理システム (IMS™) を使用する場合は、最適化されたローカル・アダプター API の呼び出しをアプリケーションが開始する前に、最適化されたローカル・アダプターの外部サブシステム・インターフェースをインストールし、活動化する必要があります。
手順
- 接続で使用するパラメーターを定義します。 CICS を使用している場合、reg_flag_trans フラグを 1 に設定すると、この登録名で作成された接続が RRS に付加され、WebSphere Application Server のグローバル・トランザクションで実行される作業と結合されます。
このフラグを 0 (ゼロ) に設定すると、この登録名で作成された接続で、RRS に付加され、WebSphere Application Server のグローバル・トランザクションで行われる作業に結合される接続がないことが示されます。
インバウンド呼び出しの場合、セキュリティー・コンテキストは常に WebSphere Application Server に伝搬されます。そのセキュリティー・コンテキストには、要求を作成したアドレス・スペースのユーザー ID が含まれています。
CICS の場合、アドレス・スペースのユーザー ID ではなく、CICS タスクが現在使用しているユーザー ID が、reg_flag_C2Wprop フラグによって伝搬されます。
アウトバウンド呼び出しの場合、reg_flag_W2Cprop フラグにより、WebSphere Application Server はユーザー ID を CICS に伝搬するよう指示されます。
これを受けて CICS は、そのユーザー ID を使用してターゲット・プログラムの開始を試行します。
セキュリティーの使用について詳しくは、『インバウンド・サポート用に最適化されたローカル・アダプターの保護』および『アウトバウンド・サポート用に最適化されたローカル・アダプターの保護』の各トピックを参照してください。
- その登録名が、このアドレス・スペースが接続されている別のセルで既に使用されていないかどうか検査します。 その登録名が別のセルによって既に使用されていないことを確認するためのアドレス・スペース検査が行われます。
登録名が別のセルによって既に使用されている場合は、エラー戻りコードが戻され、その登録要求は失敗します。
- クライアント・アドレス・スペースのネイティブ言語アプリケーションをセットアップして、BBOA1REG API を呼び出します。 デーモン・グループとサーバー名が渡され、WebSphere Application Server デーモンによって使用される名前または登録名を表す入力ストリングが渡されます。
戻りコードおよび理由コードの 0 (ゼロ) は、クライアント・アドレス・スペースが、選択した WebSphere Application Server デーモン・グループおよびサーバーにバインドされていることを示します。この WebSphere Application Server と対話するこれ以降の呼び出しは、提供された登録名を持っているか、またはその登録名を使用して作成された特定の接続ハンドルが付随している必要があります。
タスクの結果
この作業が完了すると、渡された登録名ストリングが現行のアドレス・スペースによって予約されます。このトークンでは、登録抹消呼び出しを受信するまで、他の登録呼び出しを作成できません。
重要: この呼び出しに対する接続設定を最小限にすると、ターゲット・サーバーとの間で事前に確立され、要求を待機する接続のプールが発生します。
また、登録エントリー・コンテキストまたは制御ブロックが作成され、登録名ストリングに関連付けられます。固有の各登録名には登録コンテキストがあります。
同じアドレス・スペースとスレッドを持つ複数の登録名を、1 つ以上の
WebSphere Application Server デーモン・グループにバインドすることができます。
次のタスク
BBOA1REG API について詳しくは、『z/OS ネイティブ API 用の最適化されたローカル・アダプター (Optimized local adapters for z/OS native APIs)』トピックを参照してください。