ee_rpc_call_to

ANSI C，C++の形式

#include <eerpc.h>
int ee_rpc_call_to(struct EERPC_BINDING_TBL *direction,
                   char *group, char *service,
                   char *in, EEULONG *in_len,
                   char *out, EEULONG *out_len, EELONG flags)

●direction

サービス要求先を特定する検索キーを格納するEERPC_BINDING_TBL構造体のアドレスを指定します。検索のキーはホスト名またはノード識別子のどちらかです。

EERPC_BINDING_TBL構造体の形式を次に示します。

struct EERPC_BINDING_TBL {
    char *nid ;             /*ノード識別子格納アドレス*/
    char *hostnm ;          /*ホスト名格納アドレス    */
    unsigned short portno ; /*ポート番号              */
    short filler1 ;         /*予備                    */
    EELONG flags ;          /*属性                    */
    EELONG filler2[4] ;     /*予備                    */
};

• nid

  ノード識別子を検索キーにする場合，サービス要求先のノード識別子を格納した領域のアドレスを指定します。文字列の最後にはNULL文字を設定してください。このNULL文字は文字列の長さに数えません。

  ノード識別子は，OpenTP1システム共通定義のnode_idオペランドに指定した名称で，かつサービス要求先ノードのホスト名がグローバルドメイン内にあることが前提です。相手先がTP1/EEの場合も親TP1/Server Baseのノード識別子を指定してください。

  ノード識別子を検索のキーにしない場合には，nidにアドレス0を指定してください。

  EERPC_BINDING_TBL構造体のflagsにEERPC_SCDPORTを指定した場合は，nidにアドレス0を指定してください。

• hostnm

  ホスト名を検索キーにする場合，サービス要求先ノードのホスト名を格納した領域のアドレスを指定します。EERPC_BINDING_TBL構造体のflagsにEENOFLAGS以外を指定した場合は，hostnmを必ず指定してください。

  指定できるホスト名は1〜255文字の文字列です。文字列に使用できる文字は，英数字，ピリオド，およびハイフンです（ただし，IPアドレス形式は除く）。文字列の最後にはNULL文字を設定してください。このNULL文字は文字列の長さに数えません。指定するホスト名は，/etc/hostsファイルまたはDNSなどで，IPアドレスとのマッピングができる名称です。

  なお，サービス要求先ノードのホスト名はグローバルドメインに指定されていても，指定されていなくてもかまいません。

  ホスト名を検索キーにしない場合には，hostnmにアドレス0を指定してください。

• portno

  ホスト名を検索キーとする場合のポート番号（1〜65535）を指定します。

  EERPC_BINDING_TBL構造体のflagsにEERPC_NAMPORTを指定した場合，サービス要求先ノードのネームサービスのポート番号（TP1/Server Baseのシステム共通定義のname_portオペランドに指定した値）を指定します。

  EERPC_BINDING_TBL構造体のflagsにEENOFLAGSを指定した場合は，サービス要求元のネームサービスのポート番号と，サービス要求先のネームサービスのポート番号が同じであることが前提となります。

  EERPC_BINDING_TBL構造体のflagsにEERPC_SCDPORTを指定した場合，サービス要求先がTP1/Server BaseのSPPのときは，要求先のスケジュールサービスのポート番号を指定します。サービス要求先がTP1/EEのときは，要求先の自サービスグループ定義のmysvgdefオペランドで指定したポート番号を指定します。

  EERPC_BINDING_TBL構造体のflagsにEERPC_SCDPORTを指定し，portnoに0を指定した場合は，送信先ポート番号の省略値として，最初に定義した自サービスグループ情報のmysvgdef定義コマンドに指定したポート番号の値を仮定します。最初に定義したmysvgdef定義コマンドのポート番号に0を指定している場合は，portnoに0を指定できません。

  ノード識別子を検索のキーとする場合は，portnoに指定した値は無視されます。

• filler1

  0を指定します。

• flags

  EERPC_NAMPORT

  portnoにネームサービスのポート番号を指定した場合に指定してください。

  EERPC_SCDPORT

  サービス要求先（TP1/Server Base）のスケジュールサービスのポート，またはサービス要求先（TP1/EE）のmysvgdef定義コマンドで指定したポートに対してサービスを要求する場合に指定してください。

  EENOFLAGS

  上記以外の場合に指定してください。

• filler2

  すべて0を指定します。

●group

SPPのサービスグループ名を，31バイト以内のアスキー文字列で設定します。文字列の最後にはNULL文字を設定してください。このNULL文字は文字列の長さに数えません。

●service

SPPのサービス名を，31バイト以内のアスキー文字列で設定します。文字列の最後にはNULL文字を設定してください。このNULL文字は文字列の長さに数えません。

●in

サービスの入力パラメタを設定します。

●in_len

サービスの入力パラメタ長を設定します（単位：バイト）。1〜EERPC_MAX_MESSAGE_SIZE_EX^※の範囲の値を指定できます。EERPC_MAX_MESSAGE_SIZE_EXは，eerpc.hで定義してあります。

サービス要求先がTP1/EEの場合，相手先のTP1/EEのIMAサイズ以下の値を設定してください。

注※

従来のEERPC_MAX_MESSAGE_SIZEは，eerpc.hで定義してありますが，EERPC_MAX_MESSAGE_SIZE_EXの使用をお勧めします。

●out

サービス関数から返ってくる応答を格納する領域を設定します。outで指す領域に，サービス関数からの応答が設定されます。

●out_len

サービスの応答の長さを設定します（単位：バイト）。1〜EERPC_MAX_MESSAGE_SIZE_EX^※の範囲の値を指定できます。EERPC_MAX_MESSAGE_SIZE_EXは，eerpc.hで定義してあります。

非応答型RPCの場合も，サービスの応答の長さを設定した領域のアドレスを指定する必要があります。この場合，サービスの応答の長さには，0を設定します。

注※

従来のEERPC_MAX_MESSAGE_SIZEは，eerpc.hで定義してありますが，EERPC_MAX_MESSAGE_SIZE_EXの使用をお勧めします。

●flags

RPCの形態とオプションを次に示す形式で設定します。

｛EENOFLAGS｜EERPC_NOWAIT｜EERPC_NOREPLY｝〔｜EERPC_TPNOTRAN〕〔｜EERPC_NOWAIT_OUTLEN〕

EENOFLAGS

同期応答型RPC

EERPC_NOWAIT

非同期応答型RPC

EERPC_NOREPLY

非応答型RPC

EERPC_TPNOTRAN

トランザクション処理からのサービス要求で，要求先の処理をトランザクションにしない場合に設定します。

この値はRPCの形態との論理和で設定してください。

EERPC_NOWAIT_OUTLEN

非同期応答型RPCで，サービス関数が設定した応答の長さを参照したい場合に設定します。EERPC_NOWAIT_OUTLENを設定した場合，ee_rpc_poll_any_replies関数の正常終了時，ee_rpc_call_to関数で設定したoutとout_lenに，サービス関数が設定した応答と応答の長さがそれぞれ設定されます。EERPC_NOWAIT_OUTLENを設定しない場合，outだけ設定されます。

EERPC_NOWAIT_OUTLENはEERPC_NOWAITと論理和で指定してください。EERPC_NOWAITを指定していない場合，EERPC_NOWAIT_OUTLENは無視されます。

●out

サービス関数が設定した応答が返されます。

●out_len

サービス関数が設定した応答の長さが返されます。