Natural RPC 環境を設定するには、すべてのクライアント Natural およびサーバー Natural に対して次の手順を実行し、プラットフォーム固有の注意事項および考慮事項を確認する必要があります。
別途注釈がない限り、この手順はすべての環境に適用されます。
Natural クライアントを設定するには、次の手順に従います。
SYSRPC ユーティリティのサービスディレクトリメンテナンス機能を使用して、リモートに実行される各 CALLNAT ステートメントに対して使用されるサーバーの名前を定義します。
詳細および画面例については、SYSRPC ユーティリティのドキュメントの「サービスディレクトリの概念」を参照してください。
生成したディレクトリサブプログラム NATCLTGS は、Natural クライアントアプリケーションで有効にする必要があります。 クライアントライブラリに NATCLTGS を生成していない場合は、このライブラリまたはいずれかの steplib に NATCLTGS を移動します。
オプションで、次のサーバー選択技法のいずれかを使用できます。
デフォルトサーバーのアドレス
「Natural セッション内のデフォルトサーバーアドレスの指定」またはプロファイルパラメータ DFS を参照してください。
リモートディレクトリサーバー（RDS）の使用
「リモートディレクトリサーバーの使用」またはプロファイルパラメータ RDS を参照してください。
Windows、UNIX、および OpenVMS 環境に関する注：
Predict サーバーは、SYSRPC ユーティリティではメンテナンスできません。 Predict サーバーへの接続方法については、グローバルコンフィグレーションファイル内のディクショナリサーバー割り当て機能またはプロファイルパラメータ USEDIC を参照してください。
この手順は、Natural RPC 自動実行を使用しないか、または使用できない場合にのみ適用されます。「Natural RPC 環境の運用」の「Natural RPC 自動実行の操作」を参照してください。
リモートに実行される各 CALLNAT ステートメントについては、SYSRPC ユーティリティのスタブ生成機能を使用してください。「スタブサブプログラムの作成」を参照してください。
生成したスタブは、Natural クライアント環境に対して有効である必要があります。 クライアントライブラリ内にスタブサブプログラムを生成しなかった場合は、このライブラリまたはいずれかの steplib にスタブサブプログラムを移動します。
リモートプロシージャコールのクライアント固有の処理に関連した Natural プロファイルパラメータを設定します。
| パラメータ | 機能 |
|---|---|
MAXBUFF |
最大バッファサイズ（RPC 自動実行の場合のみ） |
RPCSIZE |
Natural RPC によって使用されるバッファのサイズ（メインフレームクライアントの場合のみ） |
| パラメータ | 機能 |
|---|---|
ACIVERS |
EntireX Broker ACI で使用する ACI バージョンの定義 |
AUTORPC |
Natural RPC 自動実行 |
COMPR |
RPC バッファ圧縮の設定
「Natural RPC 環境の運用」の「圧縮の使用」も参照してください。 |
CPRPC |
コードページ名の定義 |
DFS |
RPC クライアントのデフォルトサーバーアドレスの指定 |
RDS |
リモートディレクトリサーバーの定義 |
TIMEOUT |
RPC サーバーレスポンスに対する待機時間 |
TRYALT |
代替サーバーアドレスの試行 |
次の注は、EntireX Broker を使用する場合に該当します。
注意:
DFS で指定する名前はアクティブな EntireX Broker を識別する必要があり、EntireX Broker 属性ファイル内のサーバー定義と一致している必要があります。「EntireX Broker 環境の設定」を参照してください。
TIMEOUT で指定する待機時間は、EntireX Broker ACI の WAIT フィールドの設定に使用されます。 TIMEOUT をゼロに設定した場合、WAIT=YES が設定され、クライアントは CLIENT-NONACT 時間待機します。 待機時間が経過すると、リモートプロシージャコールは該当するエラーメッセージで終了します。 TIMEOUT を使用すると、EntireX Broker スタブによって提供されるトランスポートタイムアウトメカニズムを利用できます。
Natural サーバーは、Natural サブプログラム（サービス）の実行が可能な Natural タスク（サーバータスク）です。 この Natural タスクは、基本的に非同期またはバックグラウンドタスク（デタッチプロセス）です。 EntireX Broker およびクライアントは、nodename および servername を使用してそれを識別します。
Natural サーバーを設定するには、次の手順に従います。
Natural サーバーに対するリモートプロシージャコールの全体的およびサーバー固有の処理に関連するプラットフォーム依存の Natural パラメータを設定します。
RPC 固有の Natural パラメータモジュールを作成します。
必要に応じて、Natural プロファイルパラメータ RPC（次の表を参照）のサブパラメータを設定します。
RPC 固有の Natural パラメータファイルを作成します。
必要に応じて、Natural プロファイルパラメータ（次の表を参照）を設定します。
| パラメータ | 機能 |
|---|---|
MAXBUFF |
最大バッファサイズ |
RPCSIZE |
Natural RPC によって使用されるバッファのサイズ（メインフレームサーバーの場合のみ） |
SERVER |
RPC サーバーセッションとしての Natural セッションの開始 |
SRVNAME |
RPC サーバーの名前。次の EntireX Broker に関する注意事項を参照してください。 |
SRVNODE |
ノードの名前。次の EntireX Broker に関する注意事項を参照してください。 |
| パラメータ | 機能 |
|---|---|
ACIVERS |
EntireX Broker ACI で使用する ACI バージョンの定義 |
CPRPC |
コードページ名の定義 |
LOGONRQ |
RPC サーバー要求のログオン指定 |
NTASKS |
サーバーレプリカ数の最小および最大（メインフレームサーバーの場合のみ） |
SRVUSER |
RPC サーバーレジストリ用のユーザー ID |
SRVWAIT |
クライアント要求に対する RPC サーバーの待機時間 |
TRACE |
Natural RPC サーバーのトレースレベルの定義 |
TRANSP |
サーバートランスポートプロトコル（現在は不要） |
次の注は、EntireX Broker を使用する場合に該当します。
注意:
SRVNODE で指定する名前はアクティブな EntireX Broker を識別する必要があり、SRVNAME で指定する名前は EntireX Broker 属性ファイル内のサーバー定義と一致している必要があります。「EntireX Broker 環境の設定」を参照してください。
SRVWAIT で指定する待機時間は、EntireX Broker ACI の WAIT フィールドの設定に使用されます。 SRVWAIT を指定しないかゼロに設定した場合、WAIT=YES が設定され、サーバーは SERVER-NONACT 時間待機します。 待機時間が経過すると、該当するメッセージが RPC サーバートレースファイルに書き込まれ、RPC サーバーは次のクライアント要求を待機し続けます。 SRVWAIT を使用すると、EntireX Broker スタブによって提供されるトランスポートタイムアウトメカニズムを利用できます。
Natural サーバーセッションがコマンドモードに入ることを確認するには
Natural プロファイルパラメータ MENU=OFF を設定して、Natural メニューモードを無効にします（メインフレームサーバーのみに適用されます）。
 |
次のことは行わないでください。
|
Natural サーバーセッションが使用する Adabas ETID が特定の Adabas ニュークリアス内で一意であることを確認してください。
Natural サーバーを起動するには、「Natural RPC サーバーの起動」セクションの説明に従ってください。
その後、このサーバーはクライアントからのリモート CALLNAT 要求を待機します。
z/OS または z/VSE 上のバッチモードの Natural に関する注：
プロファイルパラメータ RPC のサブパラメータ NTASKS を使用するサーバーについては、「レプリカ付きメインフレーム Natural RPC サーバーの考慮事項」を参照してください。
EntireX Broker インターフェイスを設定するには、次の手順に従います。
Natural 環境へ EntireX Broker スタブをアクセス可能にします。 この手順は、使用するプラットフォームによって異なります。
Natural に EntireX Broker スタブ NATETB23 をリンクします。または、ランタイム時にダイナミックに NATETB23 をロードするためにプロファイルパラメータ RCA=BROKER を指定します。
次の場合には NATETB23 は使用できないため、別の Broker スタブを使用する必要があります。
BS2000/OSD で TCP/IP プロトコルを使用する場合は、代わりに BKIMBTIA を使用する必要があります。
z/OS バッチモードで偽装を使用する場合は、代わりに BKIMBTSO を使用する必要があります。
CICS で偽装を使用する場合は、代わりに CICSETB を使用する必要があります。
注意:
CICSETB を Natural CICS インターフェイスニュークリアスにリンクする必要があります。
BKIMBTIA または BKIMBTSO をランタイム時にダイナミックにロードするには、RCA=BROKER RCALIAS=(BROKER,stubname) を指定します。
現在、CICSETB をランタイム時にダイナミックにロードすることはできません。
詳細については、EntireX Communicator のドキュメントを参照してください。
Natural 固有のブローカースタブ natetb.so / natetb.sl を、ディレクトリ $EXXDIR/$EXX/VERS/lib から、ローカルコンフィグレーションファイル NATURAL.INI の NATEXTLIB で指定されたディレクトリにコピーします。
EntireX Broker スタブは、EntireX のインストール中に自動的に使用可能になります。
要件に従って、プロファイルパラメータ ACIVERS を設定します。
注意:
Natural パラメータモジュール（メインフレーム）またはパラメータファイル（Windows、UNIX、または OpenVMS）内に設定する ACIVERS 値は、EntireX Broker および EntireX Broker スタブもこのバージョンをサポートする場合のみ作用可能です。
次の表に、Natural RPC に関連する機能に関連付けられた ACIVERS の値のみを示します。
| 設定 | 機能 |
|---|---|
ACIVERS=2 |
デフォルト。EntireX Broker の サーバーは |
ACIVERS=3 |
EntireX Broker の非数値会話 ID をサポートし、データ量は 30 KB を超えます。
Natural クライアントが したがって、Natural クライアントおよびサーバーの両方が、対応する ACI バージョンをサポートすることを確認してください。 また、EntireX Broker ACI バージョン 3 以上では、トランスポートメソッド TCP/IP が使用される場合、1 つの要求でクライアントとサーバー間で交換できるデータ量が 30 KB を超えることが可能です。 注意:
|
ACIVERS=4 |
コードページおよび（サーバーのみ）Natural Security をサポートします。 EntireX Broker ACI V4 以上では、Natural RPC はコードページをサポートします。 このために、コードページの名前を、クライアントおよびサーバー用のプロファイルパラメータ コードページの評価は EntireX Broker により行われます。 つまり、EntireX Broker は送信した RPC データをクライアントおよびサーバーのコードページから該当するターゲットコードページに変換します。 プロファイルパラメータ サーバーは認可したユーザー ID を使用することにより、EntireX Broker へのログオンが可能となります。 プロファイルパラメータ |
ACIVERS=6 |
EntireX 暗号化（ EntireX Broker ACI バージョン 6 以上では、アプリケーションプログラミングインターフェイス |
ACIVERS=7 |
EntireX 圧縮（COMPRESSLEVEL）をサポートします。
EntireX Broker ACI バージョン 7 以上では、アプリケーションプログラミングインターフェイス |
ACIVERS=8 |
スタブ出口のない EntireX Security をサポートします（メインフレームのみ）。
EntireX Broker ACI バージョン 8 以上では、Natural RPC サーバーは、 |
ACIVERS=9 |
クライアントおよびサーバー環境の EntireX アプリケーション識別および（サーバーのみ）Integrated Authentication Framework（IAF）をサポートします。
EntireX Broker ACI バージョン 9 以上では、EntireX Broker スタブは、クライアントおよびサーバーの環境情報（ジョブ名など）を EntireX Broker に送信します。 EntireX Broker ACI バージョン 9 以上では、Natural RPC サーバーは、オプションでクライアント認証に IAF を使用できます。 詳細については、最新の EntireX ドキュメントを参照してください。 |
トランスポートメソッドとして TCP/IP が使用されており、ホスト名を使用してサーバーノードをアドレスする場合、次の代替手段があります。
TCP/IP インストールの Hosts および Services ディレクトリ内にサーバーノードを定義します。
ドメイン名の解決に Domain Name System（DNS）を使用します。
EntireX Broker 属性ファイル内に、以下を追加します。
各Natural RPC サーバーについて、サービス定義を次のように指定する必要があります。
CLASS=RPC, SERVICE=CALLNAT, SERVER=servername.
会話サービスを使用する場合は、CONVERSION=userexit を設定します。 この場合、プロファイルパラメータ CPRPC を設定する必要があります。
注意:
EntireX 属性ファイルで AUTOLOGON=NO または SECURITY=YES が設定されている場合、ACIVERS=2 以上を設定する必要があります。