Automation Engine Script Guide > Ordered by Function > Read or Modify Objects > :PUT_ATT_APPEND

:PUT_ATT_APPEND

Script Statement: Extends the notification's message text at runtime.

Syntax

:PUT_ATT_APPEND CALL_TEXT = Text

Syntax	Description/Format
CALL_TEXT	The name of the attribute whose value should be appended. Format: AE name and script variable Allowed value: "CALL_TEXT"
Text	The text that should be attached to the existing message text. Format: script literal, number, script variable or script function

Comments

This script statement can only be used in the Process tab of a Notification object. It appends the specified text to the end of the message text.

The existing message text remains the same because this script statement does not change the Notification object. The extended message text is only valid for the notification's particular execution.

The following peculiarities apply if you use blanks (see also: examples):

Blanks that are used at the end of the text should be appended are truncated.
If the text only consists of blanks, they will be ignored.

Note that the length of the text that you pass on must not exceed 8,000 characters for technical reasons concerning the databaseA database is an organized collection of data including relevant data structures..

Examples

The following example stores the current time in the script variable and put it to the READ buffer. Subsequently, a notification is activated.

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

The notification reads the script variable's value from the READ buffer. The current time is appended to the notification's message text.

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

The following examples serve to explain the use of blanks. The notification's message text is "Start checking the".

1) The text is correctly printed because a leading blank is inserted. Note that blanks are not automatically inserted.

:PUT_ATT_APPEND CALL_TEXT = " Server processes"

Output:

Start checking the Server processes

2) Blanks that are used at the end of texts are truncated as the following example shows:

:PUT_ATT_APPEND CALL_TEXT = " Server "
:PUT_ATT_APPEND CALL_TEXT = "processes"

Output:

Start checking the Serverprocesses

3) If a text only consists of blanks, these blanks are also ignored.

:PUT_ATT_APPEND CALL_TEXT = " Server"
:PUT_ATT_APPEND CALL_TEXT = " "
:PUT_ATT_APPEND CALL_TEXT = "processes"

Output:

Start checking the Serverprocesses

Script element	Description
:ADD_ATT	Adds recipients to a notification at runtime.
:REMOVE_ATT	Removes notification recipients at runtime.
:PUT_ATT	This is used to change the value of an attribute during generation.
GET_ATT	This function returns the values of a task's attributes during generation.
GET_ATT_SUBSTR	Supplies part of a notification's message text.