dc_rap_connect

名称

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

UAPで値を設定する引数

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

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

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

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

●rflags

DCNOFLAGSを設定します。

OpenTP1から値が返される引数

●sv_id

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

リターン値

リターン値リターン値(数値)意味
DC_OK0正常終了しました。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-5505rapリスナーとの通信でネットワーク障害が発生しました。
DCRAPER_TIMEDOUT-5506rapリスナーとの通信でタイムアウトが発生しました。
DCRAPER_NOSOCKET-5507ソケット不足が発生しました。
DCRAPER_NOHOSTNAME-5508ホスト名称が解決できません。
DCRAPER_MAX_CONNECTION-5517一つのプロセスからdc_rap_connect関数を呼び出せる上限値を超えました。
DCRAPER_NOMEMORY_SV-5520rapリスナーまたはrapサーバでメモリ不足が発生しました。
DCRAPER_SHUTDOWN-5521rapリスナーは停止中です。
DCRAPER_NOCONTINUE-5522続行できない障害が発生しました。障害の要因として次のことが考えられます。
  • 予期しないメッセージを受信しました。
  • 予期しない相手からのメッセージを受信しました。
DCRAPER_SYSCALL-5523システムコールで予期しないエラーが発生しました。
DCRAPER_NOSERVICE-5528rapリスナーは開始処理中,または停止処理中です。
DCRAPER_ALREADY_CONNECT-5529すでにrapリスナーとのコネクションは確立しています。
DCRAPER_UNKNOWN_NODE-5531接続されていないネットワーク上のrapリスナーに対してコネクションを確立しようとしています。
DCRAPER_TIMEOUT_SV-5532rapリスナーサービス定義のrap_watch_timeオペランドに指定したメッセージ送受信監視時間内にコネクションが確立できませんでした。
DCRAPER_PANIC_SV-5533rapリスナーでシステム障害が発生しました。
DCRAPER_MAX_CONNECTION_SV-5534rapリスナーの管理する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関数が呼び出されました。または,ユーザサービスネットワーク定義が定義されていません。