分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編

[目次][索引][前へ][次へ]

dc_rap_disconnect

名称

rapリスナーとのコネクションの解放

形式

ANSI C,C++の形式

 
 #include <dcrap.h>
 int dc_rap_disconnect(DCRAP_SV_ID sv_id, DCLONG rflags)
 

K&R版 C の形式

 
 #include <dcrap.h>
 int dc_rap_disconnect(sv_id, rflags)
 DCRAP_SV_ID sv_id;
 DCLONG      rflags;
 

機能

rapリスナーとrapクライアントとの間に確立されているコネクションを解放します。

UAPで値を設定する引数

●sv_id

dc_rap_connect関数で受け取ったサービスIDを設定します。

●rflags

DCNOFLAGSを設定します。

リターン値

リターン値 リターン値(数値) 意味
DC_OK 0 正常終了しました。rapリスナーとのコネクションが解放されました。
DCRAPER_PARAM -5501 引数が間違っています。要因としては次のことが考えられます。
  • dc_rap_connect関数で受け取ったサービスIDではありません。
DCRAPER_PROTO -5502 プロトコル不正です。要因としては次のことが考えられます。
  • dc_rpc_open関数が呼び出されていません。
  • ユーザサービス定義のrpc_rap_auto_connectオペランドに'Y'が指定されていますが,dc_rap_disconnect関数が呼び出されました。
  • ユーザサービスネットワーク定義のdcsvgdef定義コマンドで,-wオプションが指定されていません。
DCRAPER_NOMEMORY -5503 メモリ不足が発生しました。
DCRAPER_NETDOWN -5505 rapリスナーとの通信でネットワーク障害が発生しました。
DCRAPER_TIMEDOUT -5506 rapリスナーとの通信でタイムアウトが発生しました。
DCRAPER_SHUTDOWN -5521 rapリスナーは停止中です。
DCRAPER_NOCONTINUE -5522 続行できない障害が発生しました。障害の要因として次のことが考えられます。
  • 予期しないメッセージを受信しました。
  • 予期しない相手からのメッセージを受信しました。
DCRAPER_SYSCALL -5523 システムコールで予期しないエラーが発生しました。

注意事項

DCRAPER_PARAM,DCRAPER_PROTO以外のリターン値で,dc_rap_disconnect関数がエラーリターンした場合,rapリスナーとのコネクションは解放されています。

UAPトレースに取得されるエラー要因コードは次のとおりです。

0:エラーなし。
1:dc_rpc_open関数が呼び出されていません。
3:ユーザサービス定義のrpc_rap_auto_connectオペランドの指定値がYの場合に,dc_rap_disconnect関数が呼び出されました。