<< Inhaltsverzeichnis Suchen >>

SEND_MESSAGE

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.")