: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

• :PUT_ATT_APPEND
  
  Extends the message text of a Notification at runtime
• CALL_TEXT
  Name of the attribute whose value should be appended
  Format:AE name or script variable
  Allowed value: CALL_TEXT
• 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.
    
  Format: script literal, number, script variable, or script function

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

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

:PUT_ATT_APPEND CALL_TEXT = " Server processes"

Output:

Start checking the Server processes

2) 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

3) 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

See also: