バージョン 6.3.3
 —  Natural リモートプロシージャコール(RPC)  —

Natural RPC サーバーの終了

このセクションでは、Natural RPC サーバーを終了する方法について説明します。 いくつかの方法があります。


SYSRPC の使用

SYSRPC ユーティリティ』ドキュメントの「サーバーの終了」で説明されているように、SYSRPC ユーティリティの Terminate Server コマンドを使用します。

Natural RPC サーバーは、サーバーが現在リモート CALLNAT を実行しておらず、会話の次の CALLNAT 要求を待機していない場合にのみ終了できます。

Top of page

EntireX System Management Hub の使用

EntireX System Management Hub の Server サブツリーの[Deregister]ボタンを使用します。

Top of page

アプリケーションプログラミングインターフェイス USR2073N の使用

アプリケーションプログラミングインターフェイス(API)USR2073N によって、Natural RPC サーバーを ping または終了できます。

インターフェイスによって、ping または終了コマンドが、ノード名およびサーバー名によって指定された RPC サーバーに送信されます。 返されたメッセージには、次の情報が含まれています。

Start of instruction setUSR2073N を使用するには

  1. サブプログラム USR2073N を、ライブラリ SYSEXT からライブラリ SYSTEM または steplib ライブラリまたはサーバー環境の任意のアプリケーションにコピーします。

  2. DEFINE DATA PARAMETER ステートメントをストラクチャードモードで使用するか、RESET ステートメントをレポーティングモードで使用して、次のパラメータを指定します。

    パラメータ フォーマット I/O 説明
    FUNCTION A10 I PING RPC サーバーにそのバージョンを問い合わせます。
    TERMINATE Natural RPC サーバータスクの終了を開始します。
    SRVNODE A192 I サーバー名が EntireX のロケーショントランスペアレンシまたは LOGBROKER=nodename として論理 Broker ノード名を表す場合、ノード名または * を指定します。 プロファイルパラメータ SRVNODE を参照してください。
    SRVNAME A192 I サーバー名または EntireX ロケーショントランスペアレンシ。 プロファイルパラメータ SRVNAME を参照してください。
    LOGON A1 I

    ログオンフラグ "Y"(はい)は、ログオンデータを Natural RPC サーバーに転送する必要があることを示します。

    USER-ID A8 I

    LOGON=Y の場合、ユーザー ID およびパスワードが Natural Security のログオンデータです。

    クライアントが Natural Security(NSC)環境で実行されておらず、ログオンフラグが設定されている場合は、データがアプリケーションプログラミングインターフェイス USR1071N 経由で入力されていない限り、ユーザー ID およびパスワードを指定する必要があります。 「Security の使用」の「Natural Security での Natural RPC の使用」を参照してください。

    PASSWORD
    MSG A79 O メッセージが返されました。
    RC I2 O レスポンスコード。設定可能値は次のとおりです。
    0 MSG には、RPC サーバーまたは Broker からの正常メッセージが含まれています。
    1 MSG には、RPC サーバーまたは Broker からのエラーメッセージが含まれています。
    2 MSG には、インターフェイスからのエラーメッセージが含まれています。
    3 Natural Security エラー。
  3. API を呼び出す前に、上述した入力変数を指定してください。

Top of page

ユーザー出口 NATRPC99

この出口は、Natural RPC サーバーが登録解除し、サーバーノードからログオフした後に呼び出されます。

NATRPC99 は、パラメータのない FETCH ステートメントで呼び出されます。つまり、NATRPC99 が呼び出される前に、Natural スタック上にデータは置かれません。

転送制御ステートメント(FETCHCALLNATPERFORM)やプログラムを終了するステートメント(STOPESCAPETERMINATE)など、NATRPC99 にコーディングを追加できます。

RETURN または STOP ステートメントによって NATRPC99 が終了された場合、Natural は NEXT プロンプトに戻ります。 使用している環境で NEXT プロンプトがサポートされていない場合(プロファイルパラメータ CM=OFF、非同期 Natural セッションなど)、セッションは終了します。 それ以外の場合は、セッションは Natural コマンドのプライマリ入力ファイル/データセットおよび INPUT データ(CMSYNIN)から、次のコマンドを読み取ろうとします。

重要な注意:

  1. NATRPC99 は Natural プログラムである必要があります。

  2. NATRPC99FUSER のライブラリ SYSTEM に置く必要があります。 サーバーが現在ログオンしているライブラリの STEPLIB 連結は、NATRPC99 の検索で評価されません。

  3. NATRPC99 は、『SYSRPC ユーティリティ』ドキュメントの「サーバーの終了」で説明されているように、現在は SYSRPC ユーティリティを使用して発行された Terminate Server コマンドでサーバーが終了された場合にのみ呼び出されます。 サーバーが EntireX System Management Hub. によって終了された場合は、出口は呼び出されません。

  4. NATRPC99FETCHCALLNATPERFORM)によって呼び出される Natural オブジェクトは、サーバーがログオンしているライブラリまたはそのいずれかの steplib(FUSERSYSTEM など)に存在する必要があります。

Top of page