Parameters
| Parameter | Data Type | Description |
|---|---|---|
| MessageText | String | Message content. If omitted, an empty line is added to the message frame. |
Return Values
None
Use
Allowed in all component types except Dynamic and Static Server Pages.
Description
The putmess statement appends MessageText to the text already present (if any) in the message frame. (The contents of the message frame are available to the application with the function $putmess.)
The putmess statement is ignored in a receiveMessage trigger if the user is currently in the message frame when the receiveMessage trigger is activated.
You can dump the contents of the message frame to a file when using the Debugger.
Batch Mode
In batch mode, the putmess statement writes the message directly to the screen or batch log file, depending on your operating system settings.
Putting Message Information in the Message Frame
The following example shows how the putmess statement is used to put message information in the message frame:
operation exec CUSTNAME.CUSTOMER = $1 COUNTRY.CUSTOMER = $2 retrieve if ($status < 0) putmess "Retrieve problem. No printout." apexit ; end application else print "SALESLASER","A" putmess "Printout sent to LaserJet II" endif end; exec
