4.4.1 dc_clt_connect_s常設コネクションの確立

<この項の構成>
(1) 形式
(2) 機能
(3) UAPで値を設定する引数
(4) リターン値
(5) 注意事項

(1) 形式

(a) _s付き関数の場合

#include <dcvclt.h>
DCLONG dc_clt_connect_s(DCCLT_ID cltid, DCLONG flags)

(b) _s無し関数の場合

#include <dcvclt.h>
DCLONG dc_clt_connect(DCLONG flags)

(2) 機能

CUP実行プロセス,rapサーバまたはDCCM3の論理端末との間に常設コネクションを確立します。

常設コネクションを確立するCUP実行プロセスが起動されているOpenTP1ノードは,dc_clt_cltin_s関数の引数target_hostに指定したOpenTP1ノード,クライアント環境定義DCCLTRAPHOSTまたはDCHOSTに指定したOpenTP1ノードです。

DCCM3の論理端末との間に常設コネクションを確立する場合,クライアント環境定義にDCCLTDCCMHOSTおよびDCCLTDCCMPORTを定義し,dc_clt_connect_s関数の引数flagsにDCCLT_DCCM3を指定します。

また,リモートAPI機能を使用する場合,DCCM3の論理端末との間に常設コネクションを確立するには,DCCLTRAPHOSTにDCCM3の論理端末のホスト名およびポート番号を指定し,dc_clt_connect_s関数の引数flagsにDCNOFLAGSを指定します。

(3) UAPで値を設定する引数

(4) リターン値

リターン値数値
(10進数)
意味
DC_OK0正常終了しました。または,すでに常設コネクションが確立されています。
DCCLTER_INVALID_ARGS-2501引数が誤っています。
DCCLTER_PROTO-2502次のどれかの要因が考えられます。
  • トランザクション内で発行されています。
  • dc_rpc_open_s関数が発行されていません。
  • OpenTP1に対する確立要求が発行されましたが,すでにDCCM3との常設コネクションが確立されています。
  • DCCM3に対する確立要求が発行されましたが,すでにOpenTP1との常設コネクションが確立されています。
DCCLTER_NO_BUFS-2504必要なバッファが確保できませんでした。または,リソース不足が発生しました。
DCCLTER_NET_DOWN-2506通信障害が発生しました。
DCCLTER_TIMED_OUT-2507常設コネクション確立時に時間切れ(タイムアウト)が発生しました。
DCCLTER_OLTF_NOT_UP-2515次のどれかの要因が考えられます。
  • OpenTP1サーバ,またはDCCM3論理端末が起動されていません。
  • クライアント拡張サービスが起動されていません。システムサービス構成定義clt_confの指定が正しくありません。
  • CUP実行プロセスが起動されていません。クライアントサービス定義clt_cup_confの指定が正しくありません。
DCCLTER_SYSERR-2518システムエラーが発生しました。
DCCLTER_WRONG_HOST-2539DCCM3の論理端末に対する確立要求が発行されましたが,ホスト名が不正です。
DCCLTER_INVALID_CLTID-2544cltidに指定したクライアントIDは,dc_clt_cltin_s関数で受け取ったクライアントIDと異なっています。
DCCLTER_PORT_IN_USE-2547指定したポート番号は使用されています。または,OSが自動的に割り当てるポート番号が不足しています。

(5) 注意事項