&CONCAT

The &CONCAT built-in function returns a string that is the concatenation of the supplied data.

This built-in function has the following format:

&CONCAT { var | const var | const ... var | const }

&CONCAT provides a means of concatenating or joining multiple variables or constants, to form a single variable to a maximum length of 256 characters.

&CONCAT is a built-in function and must be used to the right of an assignment statement. Multiple variables or constants is concatenated with a single &CONCAT statement.

Operands:

var: Specifies a system or user variable.
const: Specifies a constant value.

Examples: &CONCAT

&FLOOR = 03
&BLDG = HQ
&LOCATION = &CONCAT &BLDG &FLOOR
              -* &LOCATION is set to HQ03
&SRCHKEY = &CONCAT 55 LOCN &LOCATION
              -* &SRCHKEY is set to 55LOCNHQ03

Notes:

The total sum of the concatenated variables or constants cannot exceed the maximum size for one variable-any data for concatenation which exceeds 256 characters is truncated.

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