tpconnect

名称

会話型サービスとのコネクションの確立

ページの先頭へ

形式

#include <xatmi.h>
int  tpconnect(char *svc,char *data,long len,long flags)

#include <xatmi.h>
int  tpconnect(svc,data,len,flags)
char    *svc;
char    *data;
long    len;
long    flags;

ページの先頭へ

機能

関数tpconnect()は，会話型サービスであるsvcに，半二重型の通信路を設定します。コネクションを確立する処理の一部として，呼び出し側はデータを受け取り側のサービス関数へ渡せます。呼び出し側がデータを渡す場合は，dataはtpalloc()で割り当てたバッファを指しておいてください。lenにはどれぐらいのバッファを送信するかを設定します。

Note：dataが，長さを指定する必要がないバッファ型を指す場合は，lenは無視されます（0にしてください）。長さが必要なバッファ型をdataが指す場合は，lenには0を設定しないでください。また，dataはNULLを設定することもできます。その場合もlenは無視されます（会話型サービスにはアプリケーションデータは送信されません）。dataのtypeとsubtypeは，svcで認識するtypeとsubtypeのうちのどれか一つに必ず一致させてください。

会話型サービスが正常に開始すると，TPSVCINFOを経由してdataとlenを受信します。そのため，会話型サービスは，tpconnect()から送信されたdataを受信するためにtprecv()を呼ぶ必要はありません。

ページの先頭へ

『引数』

ページの先頭へ

リターン値

成功した場合，tpconnect()は，そのあとでこのコネクションを指定するために使われる記述子をリターンします。エラー時には，-1をリターンして，tperrnoにエラーの状態を示す値を設定します。

ページの先頭へ

関連項目

tpcall()，tpdiscon()，tprecv()，tpsend()，tpservice()

ページの先頭へ

『OpenTP1で使う場合の注意事項』

1. 『該当バージョンのOpenTP1では，TPNOBLOCKフラグは無効となります。そのため，TPEBLOCKがtperrnoにリターンすることはありません。OpenTP1では，ブロッキング状態のため通信ができない場合は，ネットワークダウンが原因で通信ができない場合と同様に，TPESYSTEMをリターンする仕様となっています。』

2. 『該当バージョンのOpenTP1では，TPNOTIMEフラグは無効となります。』

3. 『TPSIGRSTRTフラグは無効となります。このフラグの有無に関係なく，シグナル受信時には，中断したシステムコールを再び呼びます。TPEGOTSIGがリターンすることはありません。』

4. 『該当バージョンのOpenTP1では，TPEITYPEはリターンされません。svcで使えないタイプのdataを渡した場合，TPESYSTEMがリターンされます。もし呼び出し側がトランザクションモードの場合は，rollback_only状態となります。』

5. 『OpenTP1では，トランザクションタイムアウトが起こったときには，そのプロセスは異常終了します。そのため，TPETIMEがリターンされるのは，ブロッキングタイムアウトの場合だけとなります。』

6. 『該当バージョンのOpenTP1では，ロールバックする必要があるエラーは，X/Openで特に指定がないかぎり，TPESYSTEMとしています。ただし，TPESYSTEMがリターンしても，rollback_only状態とならない場合もあります。』

7. 『OpenTP1のセキュリティ機能を使っている場合で，サービス要求が認証されなかったときは，TPEPROTOでエラーリターンします。サービス要求が認証されなかったことが原因かどうかは，UAPトレースの詳細エラーコードで確認してください。』

8. 『TP1/NET/OSI-TP-Extendedを使ったOSI TP通信をする場合は，会話型サービスの通信はできません。OSI TP通信で会話型サービスの通信を使った場合，システムの動作は保証しません。』

9. 『サーバAPが閉塞状態の場合は，ローカルノードの要求先SPPが閉塞しているか，リモートノードの要求先SPPが閉塞しているかによって，次のように動作します。

   ローカルノードの要求先SPPが閉塞しているとき

   tpconnect()は-1を返し，tperrnoにTPEPROTOが設定されます。

   リモートノードの要求先SPPが閉塞しているとき

   トランザクションモードであれば，トランザクションタイムアウトでサーバAPが異常終了します。

   非トランザクションモードであれば，tpconnect()は-1を返し，tperrnoにTPETIMEが設定されます。』

ページの先頭へ