Previous Topic: &SOCKET TRANSFER_REQUEST

Next Topic: &SUBSTR


&STR

Returns a string that is the sum of the supplied text.

&STR text text ... text

To return a string made up of nominated text.

&STR is a built-in function and must be used to the right of an assignment statement.

The assigned data commences at the first non-blank following the &STR keyword and includes any following data up to and including the last non-blank character.

&ASISTR differs from &STR in that &STR does not retain blanks that follow the &STR keyword.

Operands:

text text ... text

One or more words or variables to be assigned into the variable to the left of the assignment character (=).

Examples: &STR

&SYSMSG = &STR X11103 INVALID DATA ENTERED  
&1 = &STR &1 MYTEXT &2

Notes:

&STR is ideal for constructing error messages to be displayed using full-screen panels.

The total size of the constructed variable or constant cannot exceed the maximum size for a variable, that is, 256 characters. (If it exceeds the maximum, it will be truncated to 256 characters.)

If &CONTROL DBCS or DBCSN or DBCSP is in effect, &STR is sensitive to the presence of DBCS data.

More information:

&ASISTR