TPUNSUBSCRIBE(3cbl)

名前

TPUNSUBSCRIBE() - イベントのサブスクリプションの削除

形式

01 TPEVTDEF-REC.
COPY TPEVTDEF.
01 TPSTATUS-REC.
COPY TPSTATUS.
CALL "TPUNSUBSCRIBE" USING TPEVTDEF-REC TPSTATUS-REC.

機能説明

呼び出し元は TPUNSUBSCRIBE() を使用して、BEA Tuxedo のイベント・ブローカのアクティブなサブスクリプションのリストから、イベントのサブスクリプションまたはイベント・サブスクリプションのセットを削除します。 TPEVTDEF-REC の SUBSCRIPTION-HANDLE は、TPSUBSCRIBE() から返されたイベントのサブスクリプション・ハンドルです。 SUBSCRIPTION-HANDLE をワイルドカード値 -1 に設定すると、呼び出し元プロセスが以前に行った非永続的サブスクリプションをすべて削除するよう TPUNSUBSCRIBE() に指示されます。 非持続タイプのサブスクリプションとは、TPSUBSCRIBE() を呼び出す際に TPEVNOPERSIST をセットした状態で行ったサブスクリプションを指します。持続タイプのサブスクリプションは、TPSUBSCRIBE() から返されたハンドルを使用することによってのみ削除できます。

"-1" ハンドルでは、呼び出し元の直前のインスタンスによってなされたサブスクリプションではなく、この機能を呼び出しているプロセスによってなされたサブスクリプションだけが削除される点に注意する必要があります (たとえば、いったんダウンして再起動したサーバは、最初のサーバによってなされたサブスクリプションをワイルドカードを利用して削除することはできません)。

次に、TPEVTDEF-REC の有効な設定の一覧を示します。

戻り値

TPUNSUBSCRIBE() は正常終了時には、TP-STATUSに [TPOK] を設定します。 また、TPUNSUBSCRIBE() は、TPEVTDEF-REC の EVENT-COUNT に、イベント・ブローカのアクティブなサブスクリプションのリストから削除したサブスクリプションの数を設定します (値は 0 以上)。 EVENT-COUNT に 1 より大きい値がセットされるのは、ワイルドカードの "-1" というハンドルを使用した場合に限られます。 また、 EVENT-COUNT には、TPUNSUBSCRIBE() が異常終了した場合でも 0 より大きい値が設定されることがあります。つまり、ワイルドカード・ハンドルを使用した場合、イベント・ブローカがいくつかのサブスクリプションを正しく削除した後でエラーが発生した可能性があります。

エラー

次の条件が発生すると、TPUNSUBSCRIBE() は異常終了し、TP-STATUS に次のいずれかの値を設定します。 (特に記述した場合を除いては、エラーが呼び出し元のトランザクションに影響を及ぼすことはありません)。

関連項目