rapリスナーとのコネクションの確立

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リスナーです。

●target_host　〜((1〜255文字の英数字，ピリオド，およびハイフン))

rapリスナーが起動されているOpenTP1ノードのホスト名を設定します。

●target_port　〜<符号なし整数>((1〜65535))

rapリスナーの使用しているウェルノウンポートのポート番号を設定します。

●rflags

DCNOFLAGSを設定します。

●sv_id

正常終了，またはDCRAPER_ALREADY_CONNECTの場合，サービスIDが返されます。

リターン値	リターン値（数値）	意味
DC_OK	0	正常終了しました。rapリスナーとのコネクションが確立されました。
DCRAPER_PARAM	-5501	引数が間違っています。
DCRAPER_PROTO	-5502	プロトコル不正です。要因としては次のことが考えられます。 dc_rpc_open関数が呼び出されていません。 ユーザサービス定義のrpc_rap_auto_connectオペランドに'Y'が指定されていますが，dc_rap_connect関数が呼び出されました。 ユーザサービスネットワーク定義のdcsvgdef定義コマンドで，-wオプションが指定されていません。
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関数が呼び出されました。または，ユーザサービスネットワーク定義が定義されていません。