GET_ATT_SUBSTR

Use the GET_ATT_SUBSTR script function to retrieve part of the message text of a Notification object. You can only use it on the Process page of the relevant Notification object.

Note: If you use a :PUT_ATT_APPEND script statement before you use this script function, the part is taken from the extended message text. For more information, see :PUT_ATT_APPEND.

Syntax

GET_ATT_SUBSTR (CALL_TEXT, Begin, Length)

Parameters

GET_ATT_SUBSTR
Retrieves part of the message text of a Notification
CALL_TEXT
Name of the attribute whose value should partially be read
Format:AE name or script variable
Allowed value: CALL_TEXT
Begin
Start position for the reading
Format: number of script variable
Important! With the introduction of UTF-8, this parameter refers to the character position and not the byte position. For example, a value of 7 specifies the 7th character, and not necessarily the 7th byte.
Length
Number of characters that should be read
Format: number or script variable
Important! With the introduction of UTF-8, this parameter refers to the number of characters and not the number of bytes. For example, a value of 10 specifies characters, but it can contain ten or more bytes.
Note: Starting with v11, if you specify a length greater than the actual length of the message text, you will get an error message.

Return codes

The script function has the following return codes:

Part of the message text
" "
The specified area does not lie within the message text.

Example

The following example reads the first 20 characters of the message text:

:SET &SECTION# = GET_ATT_SUBSTR(CALL_TEXT,1,20)