Copyright © Cloud Software Group, Inc. All Rights Reserved

SCREENMSG

Displays the given message in the message area of the specified screen. (C)

Invocation

CALL SCREENMSG(name, msg)

 

name	The name of the screen or window. Its syntax is C (fixed-length character string) with length 16.
msg	A character string specifying the message. Its syntax can be C, V (variable-length character string), or W (double-byte character).

Usage Notes

•	The message is visible the next time the screen appears.

•	The message field is located on the last row of the physical screen.

•	The message is truncated to fit the width of a screen.

•	There is no effect if the screen does not exist.

•	To set attributes for the message area of a screen, use the $SETATTRIBUTE tool, leaving the table argument blank and setting the field argument to @MESSAGE.

•	To set the color for the message area of a screen, use the $SETCOLOUR tool, leaving the table argument blank and setting the field argument to @MESSAGE.

Example

The following rule sets a new screen message for the example screen and displays the screen with the new screen message:

---

 

SCREENMSG_1;

_

_ ------------------------------------------------------------------------

_ ------------------------------------------------------------+-----------

_ CALL SCREENMSG('EMPLOYEE_SCR', | 1

_ 'THIS IS THE NEW SCREEN MESSAGE'); |

_ DISPLAY EMPLOYEE_SCR; | 2

_ ------------------------------------------------------------------------

---

 

Resulting Output

Executing this rule displays the following message at the bottom of the screen:

---

 

Employee Name Employee#

------------- ---------

THIS IS THE NEW SCREEN MESSAGE

---

 

Copyright © Cloud Software Group, Inc. All Rights Reserved