TPCANCEL

〈このページの構成〉

名称

リクエスト／レスポンス型サービスのキャンセル

01 TPSVCDEF-REC.
   COPY  TPSVCDEF.
01 TPSTATUS-REC.
   COPY  TPSTATUS.
 
CALL "TPCANCEL" USING TPSVCDEF-REC TPSTATUS-REC.

TPCANCELは，TPACALLで返された通信ハンドルCOMM-HANDLEをキャンセルします。グローバルトランザクションに属している通信ハンドルをキャンセルしようとすると，エラーになります。

成功した場合，COMM-HANDLEは無効となって，COMM-HANDLEとして受信した応答は，暗黙的に捨てられます（コミュニケーションリソースマネジャによって）。

キャンセルする通信ハンドルを設定します。』

TPCANCELの実行結果を示すリターン値が設定されます。』

成功した場合，TPCANCELはTP-STATUSにTPOKを設定します。

次のような場合，TPCANCELはエラーリターンして，次のうちどれか一つの値をTP-STATUSに設定します。

TPEBADDESC: COMM-HANDLEは，間違った通信ハンドルです。
TPETRAN: COMM-HANDLEが，呼び出し側のグローバルトランザクションに参加しています。エラーのあとでも，引き続きCOMM-HANDLEは有効で，呼び出し側の現在のトランザクションには影響しません。
TPEPROTO: TPCANCELが間違った状況で呼ばれました。
TPESYSTEM: コミュニケーションリソースマネジャシステムでエラーが起こりました。厳密なエラーの性質は，product-specificな方法で定義されます。
TPEOS: オペレーティングシステムにエラーが起こりました。厳密なエラーの性質は，product-specificな方法で定義されます。