9 165 MESSAGE_BOX_ADD

LANSA Technical

9.165 MESSAGE_BOX_ADD

Þ Note: Built-In Function Rules.

Adds one or more items to the message box assembly area as a new message line. 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 added to the message box assembly area

1

256

0

9

2 -10

X

Opt

Subsequent items to be added to the message box assembly area

1

256

0

9

 

 

Return Values

There are no Return Values

Technical Notes

  • The first item in the list of items specified causes a new message line to be started.
  • Subsequent items in the list 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 maximum length of 256 characters is true if the argument is specified as a character variable. However, the maximum length of a character literal is 48 characters.
  • Messages from successive MESSAGE_BOX_ADD commands are added to the message box assembly area. The message box message assembly area can contain at most 4096 characters (including 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.
  • The message assembly area is cleared at completion of a MESSAGE_BOX_SHOW command.

Examples

Refer to 9.168 MESSAGE_BOX_SHOW.