For z/OS platforms

最適化されたローカル・アダプターを使用した、ローカル Liberty サーバーへの外部アドレス・スペースの登録

WebSphere Optimized Local Adapters (WOLA) でローカルの最適化されたローカル・アダプター・グループへのアウトバウンド呼び出しまたは Liberty サーバーへのインバウンド呼び出しを行うには、現行アドレス・スペースを Liberty サーバーにバインドし、登録 API を使用して接続属性を設定する必要があります。

始める前に

Liberty サーバー環境で WOLA を使用できるようにします。詳しくは、Optimized Local Adapters を使用するための Liberty サーバー環境の使用可能化を参照してください。

Liberty サーバーが、登録要求の発信元と同じ z/OS イメージ上でアクティブになっている必要があります。

顧客情報管理システム (CICS®) を使用している場合は、CICS で最適化されたローカル・アダプター・サポートを使用可能にします。詳しくは、CICS での Liberty の最適化されたローカル・アダプターのサポートの使用可能化を参照してください。CICS と Liberty サーバー間の接続を確立する前に、タスク関連のユーザー出口 (TRUE) プログラムをアクティブ化します。

手順

  1. 登録 API (BBOA1REG) を使用してアドレス・スペースを登録する際に使用するパラメーターを決定します。
    この API は、以下の項目のパラメーターを受け入れます。
    • server.xml ファイルにフィーチャーを追加した際に指定した WOLA グループ名の 3 つの部分
    • 登録名
    • 初期接続の最小数
    • 最大接続数
    • トレースの動作を指定する登録フラグ・ワード

    Liberty サーバーへのインバウンド呼び出しの場合、要求を実行するアドレス・スペースのユーザー ID が含まれているセキュリティー・コンテキストが常に、Liberty サーバーに伝搬されます。CICS の場合、reg_flag_C2Wprop 登録フラグが、アドレス・スペースのユーザー ID ではなく、CICS タスクのユーザー ID を伝搬します。

    Liberty サーバーからのアウトバウンド呼び出しの場合、reg_flag_W2Cprop 登録フラグが、ユーザー ID を CICS に伝搬するように Liberty サーバーに指示します。 これを受けて CICS は、そのユーザー ID を使用してターゲット・プログラムの開始を試行します。

    API パラメーターについて詳しくは、『Liberty for z/OS 上の最適化されたローカル・アダプターの API z/OS 用の Liberty での最適化されたローカル・アダプターの保護』を参照してください。

  2. このアドレス・スペースが接続されている別の最適化されたローカル・アダプター・グループが、選択した登録名を既に使用していないことを確認します。 登録名が別の最適化されたローカル・アダプター・グループによって使用されている場合は、エラー戻りコードが戻され、その登録要求は失敗します。
  3. 選択したパラメーターを使用してクライアント・アドレス・スペース内のネイティブ言語アプリケーションから呼び出し元の登録 API を呼び出します。

    戻りコードおよび理由コードが 0 の場合、クライアント・アドレス・スペースが Liberty サーバーにバインドされたことを示しています。

タスクの結果

渡された登録名ストリングは、現行アドレス・スペースで予約されます。このトークンでは、登録抹消 API 呼び出しを受信するまで、他の登録呼び出しを実行できません。
重要: この呼び出しに対する接続数の設定を最小限にすると、ターゲット・サーバーとの間で事前に確立され、要求を待機する接続のプールが発生します。
また、登録エントリー・コンテキストまたは制御ブロックが作成され、登録名ストリングに関連付けられます。固有の各登録名には登録コンテキストがあります。 同じアドレス・スペースおよびスレッドを持つ複数の登録名を、1 つ以上の Liberty の最適化されたローカル・アダプター・グループにバインドできます。

次のタスク

登録を使用して、Liberty 環境と外部アドレス・スペースの間のインバウンド呼び出しおよびアウトバウンド呼び出しを行うことができます。詳しくは、『Liberty での最適化されたローカル・アダプターを使用するアプリケーションの開発』を参照してください。

トピックのタイプを示すアイコン タスク・トピック

ファイル名: twlp_dat_register.html