TPNOTIFY(3cbl)

名前

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 に次の値を設定します。

関連項目