Contents - Index


 

Use VarAppend to append a specified character value to the end of the current value of a specified variable.

 

VarAppend may also be entered as VarApp[end] or VApp[end].

 

Required Operands

 

DEST is the name of a previously declared varying length character variable.

 

SRC If not enclosed in quotes, SRC is the name of a previously declared character variable which contains the character value to be concatenated. If enclosed in quotes, SRC is the character value itself (up to 253 characters).

The character string represented by SRC is concatenated after the last character in the DEST variable.  If the DEST variable is not large enough to hold the result, the result is truncated.

 

Return Codes

 

OK Successful.

 

Examples

 

Append the contents of variable OPT3 to variable OPT1:

 

   => VAPPEND OPT1,OPT3

 

Append the string "$USR." to variable WORK:

 

   => VAPPEND WORK,'$USR.'