bea ホーム | 製品 | dev2dev | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > Tuxedo > Tuxedo COBOL リファレンス > セクション 3(cbl) - COBOL 関数 |
Tuxedo COBOL リファレンス
|
名前
TPNOTIFY()−クライアント識別子により通知を送信する
形式
01 TPSVCDEF-REC.
COPY TPSVCDEF.
01 TPTYPE-REC.
COPY TPTYPE.
01 DATA-REC.
COPY User data.
01 TPSTATUS-REC.
COPY TPSTATUS.
CALL "TPNOTIFY" USING TPSVCDEF-REC TPTYPE-REC DATA-REC TPSTATUS-REC.
機能説明
TPNOTIFY() は、サーバが個々のクライアントに任意通知型メッセージを送信できるようにします。
TPSVCDEF-REC 内の CLIENTID には、以前のあるいは現在のサービス呼び出しの TPSVCDEF-REC から保存されたクライアント識別子が入ります。
DATA-REC は、送信するメッセージであり、TPTYPE-REC 内の LEN は、送信する DATA-REC の大きさを指定します。ただし、DATA-REC が長さの指定を必要としないタイプのレコードの場合は、LEN は無視されます (0 でかまいません)。TPTYPE-REC 内の REC-TYPE が SPACES の場合は、DATA-REC および LEN は無視され、要求はデータ部なしで送信されます。
TPNOTIFY() が正常終了した場合、メッセージはシステムに渡され、指定されたクライアントに送信されます。TPACK() が設定されていた場合、正常終了は、クライアントがメッセージを受信したことを意味します。さらに、クライアントが任意通知型のメッセージ・ハンドラに登録している場合は、ハンドラが呼び出されます。
次に、TPSVCDEF-REC の有効な設定の一覧を示します。
戻り値
TPNOTIFY() は正常終了時には、TP-STATUS に [TPOK] を設定します。
エラー
次の条件が発生すると、TPNOTIFY() は異常終了し、TP-STATUS に次の値を設定します。
関連項目
TPBROADCAST(3cbl)、TPCHKUNSOL(3cbl)、TPINITIALIZE(3cbl)、TPSETUNSOL(3cbl)、TPTERM(3cbl)
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |