分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編

[目次][索引][前へ][次へ]

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