Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 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関数が呼び出されました。

Nの場合:dc_rap_connect関数を呼び出してコネクションを確立する前に,dc_rap_disconnect関数が呼び出されました。