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
• Length
  
  Number of characters that should 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

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)

See also: