dc_xat_connect

名称

アソシエーションの確立

形式

ANSI C,C++の形式

#include <dcxat.h>
int  dc_xat_connect(char *svcname,char *aso_name,DCLONG flags)

K&R版 C の形式

#include <dcxat.h>
int  dc_xat_connect(svcname,aso_name,flags)
char       *svcname;
char       *aso_name:
DCLONG     flags;

機能

svcnameに設定したXATMI通信サービスに,aso_nameに設定したアソシエーションの確立を要求します。

dc_xat_connect関数は,相手システムにアソシエーションの確立要求を送信してからリターンします。アソシエーション確立の通知は,dc_xat_connect関数では受け取れません。

dc_xat_connect関数は,TP1/NET/OSI-TP-Extendedを使ったOSI TP通信をするときにだけ使えます。

dc_xat_connect関数は,トランザクションの処理の範囲からでも範囲外からでも呼び出せます。

UAPで値を設定する引数

●svcname

アソシエーションの確立を要求する先のXATMI通信サービス名を設定します。XATMI通信サービス名として,XATMI通信サービス定義のxat_invoke_serverオペランドに指定するXATMI通信サービス定義ファイル名を設定します。

●aso_name

確立するアソシエーション名を設定します。アソシエーション名として,

TP1/NET/OSI-TP-Extendedの定義のプロトコル固有定義nettalccnオペランドの-cオプションに指定したコネクション名を設定します。

●flags

DCNOFLAGSを設定します。

リターン値

リターン値リターン値(数値)意味
DC_OK0正常に終了しました。
DCXATER_INVAL-4570引数に設定した値が間違っています。
DCXATER_MEMORY-4571メモリが不足しました。
DCXATER_PROTO-4572dc_rpc_open関数を呼び出していません。
DCXATER_NOT_FOUND-4575XATMI通信サービスのアドレス情報を取得できません。
DCXATER_TERMINATING-4576XATMI通信サービスは終了処理中です。
DCXATER_COMM_SEND-4577XATMI通信サービスへの送信時に,サービス要求が失敗しました。
DCXATER_COMM_RECV-4578XATMI通信サービスからの受信時に,サービス要求が失敗しました。XATMI通信サービスがコネクション確立要求を実行している可能性があります。
DCXATER_ASO_NAME-4580設定したアソシエーション名を定義していません。
DCXATER_ASO_CONNECT_ALREADY-4581アソシエーションはすでに確立しています。
DCXATER_ASO_CONNECTING-4582アソシエーションは確立処理中です。
DCXATER_ASO_DISCONNECTING-4583アソシエーションは解放処理中です。
DCXATER_ASO_INITIATE-4584アソシエーションは着呼モードのため,確立できません。