![]() |
![]() |
|
|
TPBROADCAST(3cbl)
名前
TPBROADCAST() - 名前によって通知をブロードキャストする
形式
01 TPBCTDEF-REC.
COPY TPBCTDEF.
01 TPTYPE-REC.
COPY TPTYPE.
01 DATA-REC.
COPY User data.
01 TPSTATUS-REC.
COPY TPSTATUS.
CALL "TPBROADCAST" USING TPBCTDEF-REC TPTYPE-REC DATA-REC TPSTATUS-REC.
機能説明
tpbroadcast() は、クライアント・プロセスやサーバ・プロセスがシステム内に登録されているクライアントに任意通知型メッセージを送ることができるようにします。 ターゲット・クライアント・セットは、tpbroadcast() に渡されるワイルドカード以外の識別子すべてと一致するクライアントで構成されます。 識別子の指定にワイルド・カードを使用できます。
LMID、USRNAME および CLTNAME は、すべて TPBCTDEF-REC に入り、ターゲット・クライアント・セットの選択に使用する論理識別子です。 論理識別子の SPACES 値は、その引数のワイルドカードとなります。 ワイルドカード引数は、そのフィールドの全クライアント識別子と一致します。 各識別子は、システムが有効とみなすよう定義されたサイズの制約事項を満たさなければなりません。つまり、各識別子の長さは 0 から 30 文字まででなければなりません。
要求のデータ部は、DATA-REC によって識別され、TPTYPE-REC 内の LEN は、送信する DATA-REC の大きさを指定します。 ただし、DATA-REC が長さの指定を必要としないタイプのレコードである場合 LEN は無視されます (0 でかまいません)。 TPTYPE-REC 内の REC-TYPE が SPACES の場合、DATA-REC および LEN は無視され、データ部なしで要求が送られます。
次に、TPBCTDEF-REC の有効な設定の一覧を示します。
戻り値
TPBROADCAST() は正常終了時には、TP-STATUS に [TPOK] を設定します。
エラー
次の条件が発生すると、TPBROADCAST() はブロードキャスト・メッセージをアプリケーション・クライアントに送信せず、TP-STATUS に次の値を設定します。
移植性
TPNOTIFY() に記述されているインターフェイスはすべて、ネイティブ・サイトの UNIX システムベースのプロセッサ上で利用できます。 さらに、ルーチン TPBROADCAST() と TPCHKUNSOL() およびルーチン TPSETUNSOL() は、UNIX および MS-DOS ワークステーション・プロセッサ上で利用できます。
使用法
シグナル・ベースの通知方法を選択したクライアントは、シグナルに関する制約から、システムがシグナルで通知を制御することはできません。 このような状態で通知がなされた場合、システムは、選択されたクライアントに対する通知方法をディップインに切り替えることを示すログ・メッセージを生成し、以後、クライアントにはディップイン方式で通知が行われることになります。 (通知方法の詳細については、UBBCONFIG(5) の中の RESOURCES セクションの NOTIFY パラメータの説明を参照してください)。
なお、クライアントのシグナル通知は常にシステムによって行われるので、元の通知呼び出しがどこで行われるかにかかわらず、通知の形態は一貫しています。 したがって、シグナル・ベースの通知を使用するには、以下のことが必要です。
アプリケーション管理者の ID は、そのアプリケーションのコンフィギュレーション・ファイルで識別されます。
あるクライアントに対してシグナル・ベースの通知方法を選択すると、いくつかの ATMI 呼び出しは異常終了します。TPSIGRSTRT の指定がなければ、任意通知型メッセージを受け取るため、TPGOTSIG() を返します。通知方法の選択については、UBBCONFIG(5) および TPINITIALIZE(3cbl) を参照してください。
関連項目
TPINITIALIZE(3cbl)、TPNOTIFY(3cbl)、TPTERM(3cbl)、UBBCONFIG(5)
![]() |
![]() |
![]() |
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|