:PUT_ATT_APPEND

Use the :PUT_ATT_APPEND script statement to extend the message text of a Notification object at runtime.

You can only use it on the Process page of the relevant Notification object. The existing message text remains the same, and :PUT_ATT_APPEND appends the specified text at the end of it. The extended message text is only valid for the particular execution of the Notification object.

Important: For database-specific reasons, the text you pass on must not exceed 8000 characters.

Syntax

:PUT_ATT_APPEND CALL_TEXT = Text

Parameters

Parameter	Description	Format	Allowed Values	Default Value
CALL_TEXT	Name of the attribute whose value should be appended.	AE name or script variable	CALL_TEXT	n.a.
Text	Text to be appended to the existing message text. Notes: Blanks used at the end of the text to be appended are truncated. Blanks are completely ignored if a text only consists of blanks.	script literal, number, script variable, or script function	n.a.	n.a.

Parameter

Description

Format

Allowed Values

Default Value

CALL_TEXT

Name of the attribute whose value should be appended.

AE name or script variable

CALL_TEXT

n.a.

Text

Text to be appended to the existing message text.

Notes:

Blanks used at the end of the text to be appended are truncated.
Blanks are completely ignored if a text only consists of blanks.

script literal, number, script variable, or script function

n.a.

Examples

The following example stores the current time in the script variable and puts it in 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 value of the script variable from the READ buffer. The current time is appended to the message text of the Notification.

:READ &TIME#,,

:PUT_ATT_APPEND CALL_TEXT = " &TIME#."

The following examples explain what happens when you use blanks. The existing message text of the Notification is "Start checking the".

The text is correctly appended when you use a leading blank. Note that blanks are not automatically inserted.

:PUT_ATT_APPEND CALL_TEXT = " Server processes"

Output:

Start checking the Server processes
The leading blank is kept, but the blank that is used at the end of the text is truncated as the following example shows:

:PUT_ATT_APPEND CALL_TEXT = " Server "

:PUT_ATT_APPEND CALL_TEXT = "processes"

Output:

Start checking the Serverprocesses
Blanks are completely ignored if a text only consists of blanks:

:PUT_ATT_APPEND CALL_TEXT = " Server"

:PUT_ATT_APPEND CALL_TEXT = " "

:PUT_ATT_APPEND CALL_TEXT = "processes"

Output:

Start checking the Serverprocesses