SEND_MESSAGE
|
Syntax: |
SEND_MESSAGE(<Username
des Empfängers>, <Computername des Empfängers>, <Programmname des
Empfängers>, <Absender>, <Nachricht> [,<Klangdatei>, <Wiederholen>[,<Klangdatei übertragen>[,<Beenden>]]]])
|
||||||||||||||||||
|
|
|
||||||||||||||||||
|
Bedeutung: |
Verschickt eine Nachricht über den Ebus-2T-Server
an die am Ebus-2T-Server laufenden Programme. Durch <Username des Empfängers>,
<Computername des Empfängers> und <Programmname des Empfängers>
werden die Empfänger der Nachricht festgelegt. Bei jedem dieser Parameter
kann auch der Leerstring "" angegeben werden. Der Leerstring
bedeutet alle Usernamen, alle Computernamen bzw. alle Programmnamen. Die Nachricht wird an alle Programme geschickt,
die die Bedingungen <Username des Empfängers>, <Computername des
Empfängers> und <Programmname des Empfängers> erfüllen, mit Ausnahme
des sendenden Programms. (Eine Nachricht kann nicht an sich selbst gesendet
werden!) Ist <Absender> <> "", so
wird vor der Nachricht folgende Zeile eingefügt:
Nachricht von <Absender> <Nachricht> legt den Text der Nachricht
fest. Ein Zeilenumbruch im Text wird durch die Variable EBUS_LINEFEED$ festgelegt. Beim Empfänger wird ein Fenster mit der
<Nachricht>, die durch Drücken des OK-Buttons quittiert werden muss,
angezeigt. Als <Klangdatei> kann ein Dateiname oder
eine URL-Adresse angegeben werden. Ist <Klangdatei übertragen> = 0, so
muss der Empfänger (Client) auf die <Klangdatei> zugreifen können. Ist <Klangdatei übertragen> <> 0, so
wird die <Klangdatei> vom Ebus-2T-Server zum Client übertragen. Die
<Klangdatei> muss sich im Arbeitsverzeichnis des Ebus-2T-Servers
befinden. Ist eine <Klangdatei> angegeben, so wird die
<Klangdatei> beim Empfänger abgespielt. Ist <Wiederholen>
<> 0, so wird die <Klangdatei> so lange wiederholt, bis der Empfänger
den OK-Button drückt. Achtung: In Html-Programmen hat <Klangdatei> keine
Wirkung. Ist <Beenden> = 1, so werden alle Programme,
die die Nachricht erhalten, beendet. SEND_MESSAGE liefert als Ergebnis die Anzahl der
benachrichtigten Empfänger. SEND_MESSAGE liefert -1, falls ein Fehler auftrat. Diese Funktion ist nur unter Java bei
2T-Programmen verfügbar, in allen anderen Fällen liefert sie als Ergebnis
stets -1. |
||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||
|
Beispiel: |
/* Nachricht an alle Faktura-Programme senden ANZAHL% = SEND_MESSAGE("","","Faktura_2T","Administrator",
"Bitte Programm sofort beenden !" + EBUS_LINEFEED$
+
"Die Datensicherung soll gestartet werden.") |