Try OpenEdge Now
skip to main content
Developing WebSpeed Applications
SpeedScript : WebSpeed API functions : Message handling
 

Message handling

A number of WebSpeed API functions facilitate message queuing and output. They interact with a message queue that allows you to organize messages into named groups. The following table lists these functions.
Table 2. Message API functions
Function
Return type
Description
available-messages
LOGICAL
Returns TRUE if there are any messages queued for a specified group or for all groups.
get-messages
CHARACTER
Returns any messages queued for a specified group or for all groups. Optionally deletes the messages from the queue.
get-message-groups
CHARACTER
Returns a comma-separated list of groups for which there are queued messages.
output-messages
INTEGER
Outputs messages to the Web that have been queued by queue-message and returns the number of messages output. Includes options to format the output and to specify a specific group of messages or all messages.
queue-message
INTEGER
Queues a message for later output by output-messages and returns the message number in the queue. Optionally associates the message with a specified group.
The definitions for these functions reside in install-path/src/web/method/message.i.
* Generating messages directly
* Generating messages with a custom tag