dc_rpc_call_to

ANSI C，C++の形式

#include <dcrpc.h>
int dc_rpc_call_to(struct DCRPC_BINDING_TBL *direction, 
                   char *group,
                   char *service,char *in, DCULONG *in_len,
                   char *out, DCULONG *out_len, DCLONG flags)

K&R版 C の形式

#include <dcrpc.h>
int dc_rpc_call_to(*direction, *group, *service, *in, *in_len,
                   *out, *out_len, flags)
struct DCRPC_BINDING_TBL  *direction;
char      *group;
char      *service;
char      *in;
DCULONG   *in_len;
char      *out;
DCULONG   *out_len;
DCLONG    flags;

●direction

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

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

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

• nid

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

  ノード識別子は，システム共通定義のnode_idオペランドに指定した名称で，かつサービス要求先ノードのホスト名がグローバルドメイン^※内にあることが前提です。

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

• hostnm

  ホスト名を検索のキーにする場合，サービス要求先ノードのホスト名を格納した領域のアドレスを指定します。指定できるホスト名は1から255文字までの文字列です。文字列に使用できる文字は，英数字記号，ピリオド，およびハイフンです（ただし，IPアドレス形式は除きます）。文字列の最後にはヌル文字を設定してください。このヌル文字は文字列の長さに数えません。指定するホスト名は，/etc/hostsファイルまたはDNSなどで，IPアドレスとのマッピングができる名称です。

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

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

• portno

  ホスト名を検索のキーとする場合，サービス要求先ノードのネームサービスのポート番号（システム共通定義 name_portに指定した値）を指定します。portnoの指定値は，DCRPC_BINDING_TBL構造体のflagsにDCRPC_NAMPORTを指定した場合だけ有効です。

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

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

• flags

  DCNOFLAGSを指定します。

  portnoに値を指定した場合は，DCRPC_NAMPORTを指定してください。

  なお，filler1，filler2は拡張性を考慮して設けたエリアなので，値を設定する必要はありません（filler1，filler2のメンバ名称は使用しないでください）。

注※

ここでのグローバルドメインとは，次のノード名の集合を指します。

システム共通定義のname_domain_file_useオペランドにNを指定している場合

システム共通定義のall_nodeオペランド，all_node_exオペランドで指定したノード名の集合です。

システム共通定義のname_domain_file_useオペランドにYを指定している場合

ドメイン定義ファイルに指定したノード名の集合です。なお，ドメイン定義ファイルは次の場所に格納します。

• all_nodeのドメイン定義ファイル

  $DCCONFPATH/dcnamndディレクトリ下

• all_node_exのドメイン定義ファイル

  $DCCONFPATH/dcnamndexディレクトリ下

dc_rpc_call_to関数のdirectionに指定するDCRPC_BINDING_TBL構造体は，「DCRPC_BINDTBL_SET関数」または「DCRPC_DIRECT_SCHEDULE関数」を使用して作成することもできます。詳細については，「DCRPC_BINDTBL_SET，DCRPC_DIRECT_SCHEDULE」を参照してください。

●group

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

●service

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

●in

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

●in_len

サービスの入力パラメタ長を設定します。1からDCRPC_MAX_MESSAGE_SIZE^※までの範囲の長さが設定できます。DCRPC_MAX_MESSAGE_SIZEは，dcrpc.hで定義してあります。

注※

rpc_max_message_sizeオペランドを使用した場合，DCRPC_MAX_MESSAGE_SIZEの値（1メガバイト）ではなく，rpc_max_message_sizeオペランドに指定した値になります。

●out

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

●out_len

サービスの応答の長さを設定します。1からDCRPC_MAX_MESSAGE_SIZE^※までの範囲の長さが設定できます。DCRPC_MAX_MESSAGE_SIZEは，dcrpc.hで定義してあります。

注※

rpc_max_message_sizeオペランドを使用した場合，DCRPC_MAX_MESSAGE_SIZEの値（1メガバイト）ではなく，rpc_max_message_sizeオペランドに指定した値になります。

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

●flags

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

{DCNOFLAGS|DCRPC_NOWAIT|DCRPC_NOREPLY|DCRPC_CHAINED}〔|DCRPC_TPNOTRAN〕

DCNOFLAGS

同期応答型RPC

DCRPC_NOWAIT

非同期応答型RPC

DCRPC_NOREPLY

非応答型RPC

DCRPC_CHAINED

連鎖RPC

DCRPC_TPNOTRAN

トランザクション処理からのサービス要求で，要求先の処理をトランザクションにしない場合に設定します。またはDCRPC_DIRECT_SCHEDULE関数を使用してDCRPC_BINDING_TBL構造体を作成し，非トランザクション属性（ユーザサービス定義のatomic_updateオペランドに'N'を指定，またはシステム共通定義のjnl_fileless_optionオペランドに'Y'を指定）のユーザサーバにサービス要求を行う場合に設定します。

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

（例）

同期応答型RPCでトランザクションにしないサービス要求をする場合，flagsには「DCNOFLAGS｜DCRPC_TPNOTRAN」と設定します。

●out

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

●out_len

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