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 ワークステーション・プロセッサ上で利用できます。

使用法

なお、クライアントのシグナル通知は常にシステムによって行われるので、元の通知呼び出しがどこで行われるかにかかわらず、通知の形態は一貫しています。 したがって、シグナル・ベースの通知を使用するには、以下のことが必要です。

アプリケーション管理者の ID は、そのアプリケーションのコンフィギュレーション・ファイルで識別されます。

関連項目