9 166 MESSAGE_BOX_APPEND

LANSA Technical

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