4.3.3　dc_rpc_call_s − 遠隔サービスの要求

(1)　形式

#include <dcvrpc.h>
DCLONG dc_rpc_call_s(DCCLT_ID cltid, char *group,
                     char *service, char *in,
                     DCULONG *in_len, char *out,
                     DCULONG *out_len, DCLONG flags)

#include <dcvrpc.h>
int dc_rpc_call(char *group, char *service,
                char *in, DCULONG *in_len,
                char *out, DCULONG *out_len, DCLONG flags)

#include <dcvrpc.h>
DCLONG dc_rpc_call_s(DCCLT_ID cltid, char CLTFAR *group,
                   char CLTFAR *service, char CLTFAR *in,
                   DCULONG CLTFAR *in_len, char CLTFAR *out,
                   DCULONG CLTFAR *out_len, DCLONG flags)

#include <dcvrpc.h>
int dc_rpc_call(char CLTFAR *group, char CLTFAR *service,
                char CLTFAR *in, DCULONG CLTFAR *in_len,
                char CLTFAR *out, DCULONG CLTFAR *out_len,
                DCLONG flags)

ページの先頭へ

(2)　機能

SPPのサービスを要求します。「サービスグループ名＋サービス名」に該当するサービス関数を呼び，その応答を受け取ります。

サービス要求されたサーバUAPが存在するノードのOpenTP1は，稼働していなければなりません。OpenTP1が稼働していない場合（開始処理中を含む）は，dc_rpc_call_s関数はDCRPCER_NET_DOWN，DCRPCER_OLTF_NOT_UP，DCRPCER_OLTF_INITIALIZINGでエラーリターンします。

dc_rpc_call_s関数を実行したときに，目的のサービスグループが閉塞されている場合は，DCRPCER_SERVICE_CLOSEDでエラーリターンします。

dc_rpc_call_s関数を実行したときに，目的のサービスグループがdcsvstopコマンドなどで終了処理中，または終了している場合，DCRPCER_SERVICE_TERMINATING，DCRPCER_SERVICE_CLOSED，DCRPCER_NO_SUCH_SERVICE_GROUPのうちのどれかでエラーリターンします。どのリターン値が戻るかは，dc_rpc_call_s関数を実行したタイミングで決まります。

ソケット受信型サーバでは，ユーザサービス定義のmax_socket_msgとmax_socket_msglenの指定でデータの輻輳制御をしています。そのため，サービス要求を受信できない場合があります。このとき，dc_rpc_call_s関数は，DCRPCER_SERVER_BUSYでエラーリターンします。この値が戻った場合，CUPは適当な時間をおいてから再実行すれば，サービス要求できる場合があります。

XDM/DCCM3と通常の通信形態で通信する場合，クライアント環境定義DCCLTSERVICEGROUPLISTにXDM/DCCM3論理端末のホスト名およびポート番号を指定し，dc_rpc_call_s関数を実行します。

ページの先頭へ

(3)　UAPで値を設定する引数

• cltid

  dc_clt_cltin_s関数で受け取ったクライアントIDを指定します。

• group

  サービスグループ名を31バイト以内の文字列で指定します。文字列の最後には，NULL文字を指定してください。

• service

  サービス名を31バイト以内の文字列で指定します。文字列の最後には，NULL文字を指定してください。

• in

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

• in_len

  サービスの入力パラメタ長を指定します。1からDCRPC_MAX_MESSAGE_SIZE^※までの範囲の長さが指定できます。

  注※

  クライアント環境定義DCCLTRPCMAXMSGSIZEに2以上を指定した場合，DCRPC_MAX_MESSAGE_SIZEの値（1メガバイト）ではなく，クライアント環境定義DCCLTRPCMAXMSGSIZEに指定した値になります。

• out

  サービスの応答を受け取る領域を指定します。

• out_len

  サービスの応答を受け取る領域の長さを指定します。1からDCRPC_MAX_MESSAGE_SIZE^※までの範囲の長さが指定できます。

  注※

  クライアント環境定義DCCLTRPCMAXMSGSIZEに2以上を指定した場合，DCRPC_MAX_MESSAGE_SIZEの値（1メガバイト）ではなく，クライアント環境定義DCCLTRPCMAXMSGSIZEに指定した値になります。

• flags

  RPCの形態を指定します。

  DCNOFLAGS：同期応答型RPC

  DCRPC_NOREPLY：非応答型RPC

  DCRPC_CHAINED：連鎖RPC

  flagsにDCNOFLAGS，またはDCRPC_CHAINEDを指定すると，応答が返されてくるか，または応答待ち時間（クライアント環境定義DCWATCHTIMの値）切れ（タイムアウト）エラーになるまで，dc_rpc_call_s関数は戻りません。ただし，サービス要求先のSPPがアボートした場合は，即時にエラーリターンします。

  この場合，DCWATCHTIMで指定された応答待ち時間によって，次の二つのリターン値が返されます。

  • DCWATCHTIMに1〜65535を指定した場合：DCRPCER_TIMED_OUT

  • DCWATCHTIMに0（無限に待つ）を指定した場合：DCRPCER_SERVICE_NOT_UP

  また，CUP実行中に応答待ち時間を変更することもできます。この場合，dc_rpc_call_s関数を実行する前に，dc_rpc_set_watch_time_s関数を実行してください。

  なお，トランザクション中，または常設コネクション中に限り，DCRPC_CHAINEDを指定できます。

  flagsにDCRPC_NOREPLYを指定すると，要求したサービスは応答を返さないサービスとみなされます。この場合，dc_rpc_call_s関数はサービスの実行終了を待たないで，すぐに戻ります。この指定をした場合は，応答（out）と応答の長さ（out_len）は参照できません。さらに，サービス関数が実行されたかどうかは，CUPではわかりません。

  トランザクションの処理からのRPCを，トランザクションとしないサービス要求にできます。RPCの形態を示すパラメタにDCRPC_TPNOTRANを合わせて指定すると，該当するdc_rpc_call_s関数のサービス要求は，トランザクションの処理でないサービス要求になります。

  （例）DCNOFLAGS|DCRPC_TPNOTRAN

  このサービス要求は，トランザクションの処理からだけ指定できます。トランザクションの範囲外でこの指定をした場合，dc_rpc_call_s関数はDCRPCER_INVALID_ARGSでエラーリターンします。

ページの先頭へ

(4)　値が返される引数

• out

  サービス関数で指定したサービスの応答が返されます。引数flagsにDCRPC_NOREPLYを指定した場合は，返されません。

• out_len

  サービス関数で指定したサービスの応答の長さが返されます。引数flagsにDCRPC_NOREPLYを指定した場合は，返されません。

ページの先頭へ

(5)　リターン値

ページの先頭へ

(6)　注意事項

• 入力パラメタ（in），およびサービス関数の応答（out）に同じバッファを指定しないでください。

• flagsにDCRPC_NOREPLYを指定した場合，次のリターン値は戻りません。

  発生しないエラー

  DCRPCER_REPLY_TOO_BIG

  DCRPCER_INVALID_REPLY

  発生しても検出できないエラー

  DCRPCER_NO_SUCH_SERVICE

  DCRPCER_SERVICE_CLOSED

  DCRPCER_SERVICE_TERMINATING

  DCRPCER_SYSERR_AT_SERVER

  DCRPCER_NO_BUFS_AT_SERVER

  DCRPCER_OLTF_INITIALIZING

• リターン値DCRPCER_TIMED_OUTが戻る場合，次に示す要因が考えられます。

  クライアント環境定義で指定した最大応答待ち時間が短い

  サービス要求先のSPPから発行したサービス関数の異常終了

  サービス要求先のSPPが存在するノードの障害

  サービス要求先のSPPの処理完了前での異常終了

  ネットワーク障害

  上記の場合，サービス要求先のSPPから開始したトランザクションの処理はコミットされて，データベースが更新されていることがあります。データベースが更新されているかどうか確認してください。

• CUPからdc_trn_begin_s関数を実行後，dc_rpc_call_s関数を実行して，次に示すリターン値が戻った場合は，必要があればロールバック要求の関数を実行してください。

  DCRPCER_TIMED_OUT

  DCRPCER_NO_SUCH_SERVICE

  DCRPCER_NO_BUFS_AT_SERVER

  DCRPCER_INVALID_REPLY

  DCRPCER_NO_BUFS_RB

  DCRPCER_SYSERR_RB

  DCRPCER_SYSERR_AT_SERVER_RB

  DCRPCER_REPLY_TOO_BIG_RB

ページの先頭へ