GET_ATT_SUBSTR

Script Function: Supplies part of the message text in a notification

Syntax

GET_ATT_SUBSTR (CALL_TEXT, Begin, Length)

Syntax	Description/Format
CALL_TEXT	Name of the attribute whose value should be partially read Format: AE name or script variable Allowed value: "CALL_TEXT"
Begin	Position where reading should be started Format: Number or script variable
Length	Number of characters to be read Format: Number or script variable. Note: Starting with v11, if you specify a length greater than the actual length of the message text, you will get an error message.

Syntax

Description/Format

CALL_TEXT

Name of the attribute whose value should be partially read
Format: AE name or script variable
Allowed value: "CALL_TEXT"

Begin

Position where reading should be started
Format: Number or script variable

Length

Number of characters to be read
Format: Number or script variable.

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
Part of the message text " " - The specified area is not within the message text.

Note: This script function can only be used in the Process page of a Notification. It supplies part of the message text in a notification.

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

Example

The following example shows how to read the first 20 characters of the message text.

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