tpcall

名称

リクエスト/レスポンス型サービスの呼び出しと応答の受信

ページの先頭へ

形式

#include <xatmi.h>
int  tpcall(char *svc,char *idata,long ilen,char **odata,
            long *olen,long flags)

#include <xatmi.h>
int  tpcall(svc,idata,ilen,odata,olen,flags)
char    *svc;
char    *idata;
long    ilen;
char    **odata;
long    *olen;
long    flags;

ページの先頭へ

機能

関数tpcall()は，サービス要求を送信して，同期的に応答を待ちます。この関数を呼ぶことは，tpacall()を呼び出して，すぐにtpgetrply()を呼び出すのと同じことです。関数tpcall()はsvcで示されたサービスにサービス要求を送信します。サービス要求のデータ部は，idataで指しています。バッファは，事前にtpalloc()で割り当てておきます。引数ilenには，idataをどれだけ送信するかを設定します。

Note：idataが，長さを指定する必要がないバッファ型を指す場合は，ilenは無視されます（0にしてください）。長さが必要なバッファ型をidataが指す場合は，ilenには0を設定しないでください。idataがNULLの場合も，ilenは無視されます。idataのtypeとsubtypeは，svcで認識できるtypeとsubtypeのうちのどれか一つに必ず一致させてください。

odataは応答が読み込まれるバッファへのポインタのアドレスであり，その応答の長さは*olenにリターンされます。*odataは，tpalloc()であらかじめ割り当てたバッファを必ず指すようにしてください。送信と受信に同じバッファを使用する場合は，odataにidataのアドレスを入れておいてください。

応答のバッファのサイズを変更したかどうかの判断は，tpcall()を呼び出す前のバッファの合計サイズと*olenの長さを比較します。*olenの方が長い場合は，バッファは大きくなっています。長くない場合は，バッファのサイズは変わりません。

また，tpcall()が呼び出されたときに，idataと*odataが等しくても，*odataが変更されたときは，idataが指しているアドレスは無効です。

Note：*odataはバッファのサイズを増やす以外の理由でも変わるかも知れません。*olenに0が返ってきたら，応答にはデータ部がなくて，*odataとそれが指すバッファは変更されません。*odataやolenがNULLの場合はエラーになります。

ページの先頭へ

『引数』

ページの先頭へ

リターン値

tpcall()が正常リターンするか，またはTPESVCFAILがtperrnoに設定されてリターンしたとき，アプリケーションがtpreturn()の引数として渡した定義値は，グローバル変数tpurcodeとして参照できます。エラー時には，-1をリターンして，tperrnoにエラーの状態を示す値を設定します。

ページの先頭へ

関連項目

tpalloc()，tpacall()，tpgetrply()，tpreturn().

ページの先頭へ

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

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

2. 『該当バージョンのOpenTP1では，TPNOTIMEフラグは応答受信時にだけ有効です。サービス要求の送信時にブロッキング状態が起こった場合は，TPNOTIMEフラグは無効です。』

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

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

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

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

7. 『サービス要求先のSPPが異常終了した場合，定義のwatch_timeに指定した時間よりも早く，TPETIMEでエラーリターンするときがあります。また，watch_timeに0（応答を受信するまで無限に待つ）を指定している場合，TPEPROTOでエラーリターンするときがあります。』

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

9. 『TP1/NET/OSI-TP-Extendedを使ったOSI TP通信では，回線障害はTPESVCERRでエラーリターンします。』

10. 『TP1/NET/OSI-TP-Extendedを使ったOSI TP通信をする場合，送受信するデータの長さは NET/Library共通定義のNETバッファグループ定義 nettbufにあるlengthオペランドに指定した値を超えないようにしてください。』

11. 『次の場合，OSI TP通信では，tpcall，またはtpgetrplyでTPESVCERRのエラーになり，TCP/IP通信ではTPENOENT，またはTPESYSTEMのエラーになります。

    • 指定したサービスが要求先に存在しない

    • タイプトバッファがサーバに認識されない

    • サービス起動中にエラーになる』

12. 『OSI TP通信で，システムのアソシエーション本数が足りない場合，ログメッセージを出力し，TPESYSTEMでリターンします。』

13. 『OSI TP通信では，TPNOTIMEを指定しても，ブロッキングタイムアウトします。TCP/IP通信では，トランザクションでないとき，ブロッキングタイムアウトします。』

14. 『OSI TP通信では，ユーザサービス定義のmessage_store_buflenは，nettbuf -gで指定したサイズ以上を定義してください。TCP/IP通信では，dc_rpc_callと同様です。』

15. 『TP1間でOSI TP通信を行う場合で，atomic_updateオペランドが'N'のサービスをトランザクションとして呼ばれる場合，サービス要求元には，TPESVCERRが返ります。』

16. 『TCP/IP通信で呼び出されたサービスから，さらにOSI TP通信でサービスを呼び出し，応答を受け取らないでサービス関数を終了した場合，TCP/IP通信でサービスを呼び出したUAPには正常な応答電文が返り，tpcall()，tpgetrply()はエラーリターンしません。』

17. 『OSI TP通信をするXATMIのエラーは，従来のTCP/IPとエラー動作が異なる場合があります。』

ページの先頭へ