:PUT_ATT_APPEND

Script-Anweisung: Erweitert den Meldungstext einer Benachrichtigung zur Laufzeit.

Syntax

: PUT_ATT_APPEND CALL_TEXT = Text

Syntax	Beschreibung/Format
CALL_TEXT	Name des Attributes, dessen Wert erweitert werden soll. Format:AE Name and Script-Variable Zulässiger Wert: "CALL_TEXT"
Text	Text, der dem bestehenden Meldungstext hinzugefügt werden soll. Format: Script-Literal, Zahl, Script-Variable oder Script-Funktion

Diese Script-Anweisung kann nur in der Prozess-Registerkarte eines Benachrichtigungs-Objektes eingesetzt werden. Sie fügt am Ende des Meldungstextes den angegebenen Text hinzu.

Der bestehende Meldungstext wird dadurch nicht geändert, da die Script-Anweisung das Benachrichtigungs-Objekt nicht ändert. Die Erweiterung des Meldungstextes gilt nur für dessen Durchführung.

Bei der Verwendung von Leerzeichen gelten folgende Besonderheiten (siehe auch Beispiele):

Leerzeichen am Ende des hinzuzufügenden Textes werden abgeschnitten.
Besteht der Text nur aus Leerzeichen, werden diese gänzlich ignoriert.

Achtung! Beachten Sie, dass die Länge des übergebenen Texts aus Datenbank-technischen Gründen eine Länge von 8.000 Zeichen nicht überschreiten darf.

Beispiele

Im Beispiel wird die aktuelle Uhrzeit in einer Script-Variablen gespeichert und in den READ-Buffer gestellt. Danach wird ein Benachrichtigungs-Objekt aktiviert.

: SET &TIME# = SYS_TIME ( "HH:MM" )
: PUT_READ_BUFFER TIME# = "&TIME#"
: SET &CALL# = ACTIVATE_UC_OBJECT (CALL, BACKUP.END)

Die Benachrichtigungs-Aufgabe liest den Wert der Script-Variablen aus dem READ-Buffer. Die aktuelle Uhrzeit wird an den Meldungstext der Benachrichtigung angehängt.

: READ &TIME# ,,
: PUT_ATT_APPEND CALL_TEXT = " &TIME#."

Die folgenden Beispiele sollen Ihnen die Behandlungsweise von Leerzeichen demonstrieren. Der Meldungstext der Benachrichtigung lautet "Überprüfung starten für".

1) Der Text wird durch das führende Leerzeichen korrekt ausgegeben. Beachten Sie, dass nicht automatisch ein Leerzeichen eingefügt wird.

: PUT_ATT_APPEND CALL_TEXT = " Serverprozesse"

Ausgabe:

Die Überprüfung der Serverprozesse starten

2) Beachten Sie auch, dass Leerzeichen am Ende des Textes abgeschnitten werden.

: PUT_ATT_APPEND CALL_TEXT = " Server "
: PUT_ATT_APPEND CALL_TEXT = "Prozesse"

Ausgabe:

Das Überprüfen des Serverprozesses starten

3) Besteht der Text nur aus Leerzeichen, wird er ebenfalls ignoriert.

: PUT_ATT_APPEND CALL_TEXT = " Server"
: PUT_ATT_APPEND CALL_TEXT = " "
: PUT_ATT_APPEND CALL_TEXT = "prozesse"