dc_rap_connect
- 〈このページの構成〉
形式
ANSI C,C++の形式
#include <dcrap.h> int dc_rap_connect(char *target_host, DCLONG target_port, DCRAP_SV_ID *sv_id, DCLONG rflags)
K&R版 C の形式
#include <dcrap.h> int dc_rap_connect(target_host, target_port, sv_id, rflags) char *target_host; DCLONG target_port; DCRAP_SV_ID *sv_id; DCLONG rflags;
機能
rapリスナーとrapクライアントとの間にコネクションを確立します。
コネクションを確立するrapリスナーはtarget_host上にtarget_portで起動されているrapリスナーです。
UAPで値を設定する引数
●target_host 〜((1〜255文字の英数字,ピリオド,およびハイフン))
rapリスナーが起動されているOpenTP1ノードのホスト名を設定します。
●target_port 〜<符号なし整数>((1〜65535))
rapリスナーの使用しているウェルノウンポートのポート番号を設定します。
●rflags
DCNOFLAGSを設定します。
OpenTP1から値が返される引数
●sv_id
正常終了,またはDCRAPER_ALREADY_CONNECTの場合,サービスIDが返されます。
リターン値
リターン値 |
リターン値(数値) |
意味 |
---|---|---|
DC_OK |
0 |
正常終了しました。rapリスナーとのコネクションが確立されました。 |
DCRAPER_PARAM |
-5501 |
引数が間違っています。 |
DCRAPER_PROTO |
-5502 |
プロトコル不正です。要因としては次のことが考えられます。
|
DCRAPER_NOMEMORY |
-5503 |
メモリ不足が発生しました。 |
DCRAPER_NETDOWN |
-5505 |
rapリスナーとの通信でネットワーク障害が発生しました。 |
DCRAPER_TIMEDOUT |
-5506 |
rapリスナーとの通信でタイムアウトが発生しました。 |
DCRAPER_NOSOCKET |
-5507 |
ソケット不足が発生しました。 |
DCRAPER_NOHOSTNAME |
-5508 |
ホスト名称が解決できません。 |
DCRAPER_MAX_CONNECTION |
-5517 |
一つのプロセスからdc_rap_connect関数を呼び出せる上限値を超えました。 |
DCRAPER_NOMEMORY_SV |
-5520 |
rapリスナーまたはrapサーバでメモリ不足が発生しました。 |
DCRAPER_SHUTDOWN |
-5521 |
rapリスナーは停止中です。 |
DCRAPER_NOCONTINUE |
-5522 |
続行できない障害が発生しました。障害の要因として次のことが考えられます。
|
DCRAPER_SYSCALL |
-5523 |
システムコールで予期しないエラーが発生しました。 |
DCRAPER_NOSERVICE |
-5528 |
rapリスナーは開始処理中,または停止処理中です。 |
DCRAPER_ALREADY_CONNECT |
-5529 |
すでにrapリスナーとのコネクションは確立しています。 |
DCRAPER_UNKNOWN_NODE |
-5531 |
接続されていないネットワーク上のrapリスナーに対してコネクションを確立しようとしています。 |
DCRAPER_TIMEOUT_SV |
-5532 |
rapリスナーサービス定義のrap_watch_timeオペランドに指定したメッセージ送受信監視時間内にコネクションが確立できませんでした。 |
DCRAPER_PANIC_SV |
-5533 |
rapリスナーでシステム障害が発生しました。 |
DCRAPER_MAX_CONNECTION_SV |
-5534 |
rapリスナーの管理するrapクライアントとのコネクション要求受付可能最大数を超えました。 |
注意事項
DCRAPER_ALREADY_CONNECT以外のリターン値で,dc_rap_connect関数がエラーリターンした場合,rapリスナーとのコネクションは確立されていません。
UAPトレースに取得されるエラー要因コードは次のとおりです。
0:エラーなし。
1:dc_rpc_open関数が呼び出されていません。
3:ホスト名称の設定に誤りがあります。
4:ポート番号の設定に誤りがあります。
5:サービスID格納エリアが設定されていません。
6:ユーザサービス定義のrpc_rap_auto_connectオペランドの指定値がYの場合に,dc_rap_connect関数が呼び出されました。または,ユーザサービスネットワーク定義が定義されていません。
7:コネクション確立後に発行したdc_rpc_callがエラーとなった場合は,dc_rap_disconnectでコネクションを解放したあと,再度dc_rap_connectでコネクションを確立させてください。