<< | Inhaltsverzeichnis | Suchen | >> |
Funktion
Syntax: |
SEND_MESSAGE(<USERNAME>,<COMPUTERNAME>,<PROGRAMMNAME>,<ABSENDER>,<NACHRICHT>) <USERNAME> = <STRING-AUSDRUCK> <COMPUTERNAME> = <STRING-AUSDRUCK> <PROGRAMMNAME> = <STRING-AUSDRUCK> <ABSENDER> = <STRING-AUSDRUCK> <NACHRICHT> = <STRING-AUSDRUCK> |
Bedeutung: |
SEND_MESSAGE verschickt über den
Ebus-2T-Server eine Nachricht an die am Ebus-2T-Server laufenden Programme. Durch <USERNAME>, <COMPUTERNAME> und
<PROGRAMMNAME> 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. <USERNAME> legt den Usernamen des Empfängers
fest. Der Username ist der Name, den die Funktion GET_USERNAME$
liefert. Groß-/Kleinschreibung wird dabei nicht berücksichtigt. <COMPUTENAME> legt den Computernamen der
Empfänger fest. Der Computername ist der Name, den die Funktion GET_COMPUTERNAME$ liefert.
Groß-/Kleinschreibung wird dabei nicht berücksichtigt. <PROGRAMMNAME> bezeichnet den Namen
des Programms, an das die Nachricht gesendet werden soll (z.B. Faktura_2T).
Groß-/Kleinschreibung wird dabei nicht berücksichtigt. Die Nachricht wird an alle Programme
geschickt, die die Bedingungen <USERNAME>, <COMPUTERNAME> und
<PROGRAMMNAME> erfüllen, mit Ausnahme des sendenden Programmes (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 muß,
angezeigt. 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. |
Beispiel: |
/*
Nachricht an alle Faktura-Programme senden ANZAHL% =
SEND_MESSAGE("","","Faktura_2T","Server", "Bitte Programm sofort beenden !"
+ EBUS_LINEFEED$ + "Die Datensicherung soll gestartet
werden.") |