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として受信した応答は,暗黙的に捨てられます(コミュニケーションリソースマネジャによって)。

『データ領域』

『●COMM-HANDLE

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

『●TPSTATUS-REC

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

リターン値

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

エラー

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

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

関連項目

TPACALL