9 166 MESSAGE_BOX_APPEND

9.166 MESSAGE_BOX_APPEND

Þ Note: Built-In Function Rules.

Appends one or more items to the message box assembly area. A new message line is not started. These items would normally be displayed by the MESSAGE_BOX_SHOW, Built-In Function at some later time.

For use with

LANSA for i NO Visual LANSA for Windows YES Visual LANSA for Linux NO

 

Arguments

No Type Req/ Opt Description Min Len Max Len Min Dec Max Dec 1 X Req First item to be appended to the message box assembly area 1 256 0 9 2 - 10 X Opt Subsequent items to be appended to the message box assembly area 1 256 0 9

 

Return Values

There are no Return Values

Technical Notes

• This Built-In Function does not cause a new message line to be started. It is designed to append information to existing message lines.

• All items (including the first one) are separated, by a single blank from the preceding item.

• Items are converted to left aligned strings and trailing blanks are truncated. A completely blank/null item is converted to a single blank.

• The message box message assembly area can contain at most 4096 characters (including any automatically inserted blanks or control characters). Once the assembly area reaches its maximum size all in progress or subsequent add or append operations are ignored. No notification or error is given when this situation arises. 

Examples

Refer to 9.168 MESSAGE_BOX_SHOW