Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 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通信サービス定義ファイル名(_xatc)を設定します。

●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

アソシエーションは着呼モードのため,確立できません。