TPPOST(3cbl)


	BEA ホーム \| イベント \| ソリューション \| パートナ \| 製品 \| サービス \| ダウンロード \| ディベロッパ・センタ \| WebSUPPORT
	e-docs \| サイトマップ \| 検索 \| PDF版 \| お問い合わせ \| 用語集

Tuxedo ホーム \| BEA Tuxedo COBOL リファレンス \| 先頭へ \| 前へ \| 次へ \| 目次

TPPOST(3cbl)

名前

TPPOST() - イベントを通知する

形式

01 TPEVTDEF-REC.
 COPY TPEVTDEF 
 
01 TPTYPE-REC.
 COPY TPTYPE. 
 
01 DATA-REC.
 COPY User data. 
 
01 TPSTATUS-REC.
 COPY TPSTATUS. 
 
CALL "TPPOST" USING TPEVTDEF-REC TPTYPE-REC DATA-REC TPSTATUS-REC.

機能説明

呼び出し元は、イベントおよび関連データを通知するために TPPOST() を使用します。イベントの名前は TPEVTDEF-REC の EVENT-NAME で指定され、ポストされるデータは DATA-REC に含まれます。通知されるイベントおよびそのデータは、EVENT-NAME がそのサブスクリプション条件を満たし、DATA-REC がそのオプションのフィルタ規則に適合するすべてのサブスクライバに対し、BEA Tuxedo のイベント・ブローカによってディスパッチされます。

EVENT-NAME の文字長は最大 31 文字で、SPACES であってはなりません (スペースで埋めることはできません)。また、ドット (".") は BEA Tuxedo システムによって定義されるイベントの頭文字として使用されるため、EVENT-NAME の最初の文字にはドットを使用することはできません。

DATA-REC はポストされるレコードであり、そのタイプを指定することができます。イベントとともにポストされる DATA-REC のデータ長は、TPTYPE-REC の LEN で指定されます。ただし、DATA-REC が長さの指定を必要としないタイプのレコードである場合 LEN は無視されます (0 でかまいません)。 DATA-REC がデータ長を指定する必要のあるタイプのレコードである場合は、LEN を 0 にセットすることはできません (0 にセットした場合はデータはポストされません)。 TPTYPE-REC の REC-TYPE が SPACES の場合は、DATA-REC と LEN は無視され、データをともなわずにイベントだけがポストされます。

TPPOST() をトランザクション内で使用する場合、トランザクションの境界は、イベント・ブローカによって通知されるサーバおよび安定記憶域のメッセージ・キュー、またはそのいずれかを含むように拡張されます。トランザクショナル・ポストでは、ポストされたイベントを受け取ったことがポスト元のトランザクションに通知される場合 (サーバやキューなど) と、通知されない場合 (クライアントなど) があります。

ポスト元がトランザクション内にあり、TPTRAN が設定されると、通知されるイベントはトランザクション・モードでイベント・ブローカに渡されます。これは、イベント・ブローカがイベントをポスト元のトランザクションの一部としてディスパッチできるようにするためです。ブローカは、サブスクリプションの実行時に TPEVTDEF-REC の TPEVTRAN をセットしたサービス・ルーチンや安定記憶キューのサブスクリプションに対してのみトランザクション・イベント通知を送出します。クライアント通知、およびサブスクリプション時に TPEVTDEF-REC の TPEVNOTRAN を設定したサービス・ルーチンや安定記憶域キューのサブスクリプションも、イベント・ブローカによってディパッチされますが、これらはポスト側プロセスのトランザクションの一部としては処理されません。

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

TPNOTRAN

呼び出し元がトランザクション・モードにあり、このフラグがセットされている場合は、イベントのポストは呼び出し元のトランザクションについては実行されません。このフラグ設定を使用するトランザクション・モードの呼び出し元は、依然としてトランザクション・タイムアウトの対象となります (それ以外はなし)。イベントのポストが正しく実行されなかった場合、呼び出し元のトランザクションには影響はありません。TPNOTRAN または TPTRAN が設定されていなければなりません。

TPTRAN

呼び出し元がトランザクション・モードにあり、このフラグがセットされている場合は、イベントのポストは呼び出し元のトランザクションに関して実行されます。呼び出し元がトランザクション・モードにない場合、この設定は無視されます。TPNOTRAN または TPTRAN が設定されていなければなりません。

TPNOREPLY

TPPOST() に対し、イベント・ブローカが EVENT-NAME に対するすべてのサブスクリプションを処理するまで待ってから戻る必要はないことを知らせます。 TPNOREPLY を設定すると、TPPOST() が正常終了するかどうかにかかわらず、TPEVTDEF-REC の EVENT-COUNT は 0 に設定されます。呼び出し元がトランザクション・モードにある場合は、TPTRAN も設定するときには、この設定は使用できません。 TPNOREPLY または TPREPLY が設定されていなければなりません。

TPREPLY

TPPOST() に対し、すべてのサブスクリプションが処理されてから戻るよう指示します。 TPREPLY を設定すると、ルーチンは正常終了時には [TPOK] を返し、EVENT-NAME に関してイベント・ブローカによってデイスパッチされたイベント通知の数が TPEVTDEF-REC の EVENT-COUNT に設定されます。呼び出し元がトランザクション・モードにあり、TPTRAN がセットされている場合は、このフラグを設定する必要があります。 TPNOREPLY または TPREPLY が設定されていなければなりません。

TPNOBLOCK

ブロッキング条件が存在する場合は、イベントはポストされません。このような条件が発生すると、呼び出しは失敗し、TP-STATUS は [TPEBLOCK] に設定されます。TPNOBLOCK または TPBLOCK が設定されていなければなりません。

TPBLOCK

TPBLOCK がセットされ、ブロッキング条件が存在する場合は、呼び出し元はブロッキング条件が消失するか、またはタイムアウト (トランザクション・タイムアウト、またはブロッキング・タイムアウト) が発生するまでブロックします。 TPNOBLOCK または TPBLOCK が設定されていなければなりません。

TPNOTIME

この設定は、呼び出し元が無制限にブロックでき、ブロッキング・タイムアウトの影響を受けないようにすることを指定します。トランザクション・タイムアウトは引き続き発生する可能性があります。TPNOTIME または TPTIME が設定されていなければなりません。

TPTIME

このフラグは、ブロッキング条件が存在し、ブロッキング時間に達すると、呼び出し元がブロッキング・タイムアウトを受け取ることを示します。TPNOTIME または TPTIME が設定されていなければなりません。

TPSIGRSTRT

ルーチン内部のシステム・コールがシグナルによって中断された場合、中断されたシステム・コールは再発行されます。 TPNOSIGRSTRT または TPSIGRSTRT が設定されていなければなりません。

TPNOSIGRSTRT

関数内部のシステム・コールが信号によって中断されると、そのシステム・コールは再度実行されることはなく、呼び出しは異常終了し、TP-STATUS は [TPGOTSIG] にセットされます。 TPNOSIGRSTRT または TPSIGRSTRT が設定されていなければなりません。

戻り値

TPPOST() は正常終了時には、TP-STATUS に [TPOK] を設定します。また、EVENT-COUNT にはイベント・ブローカが EVENT-NAME に関してディスパッチしたイベント通知 (つまり、そのイベント表現が EVENT-NAME に対して有効であると評価され、かつそのフィルタ規則が DATA-REC に対して有効であると評価されたサブスクリプションのためのポスト) の数が入ります。終了時に TP-STATUS が [TPESVCFAIL] に設定された場合、EVENT-COUNT には、イベント・ブローカが EVENT-NAME に関してディスパッチした非トランザクション・イベント通知の数が入ります。