Equinox Online Help - Language Reference - A to Z
DisplayMessage |
|||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Applies to | |||||||||||||||||||||
Syntax | DisplayMessage MessageExpression [, Destination] [, NameExpression] | ||||||||||||||||||||
Action | [Statement] Sends a display message to a specified user (or users) | ||||||||||||||||||||
Scope | Usable anywhere. | ||||||||||||||||||||
Notes | This function sends a display message directly to a specified user (or users). The message is displayed on the user's screen. The message is supplied as the first argument, MessageExpression. The second and third arguments, Destination and NameExpression, identify the user or users to which the message is directed. Destination may take one of the following values:
If the message is not accepted for transmission, then an error number is stored in the SysError system workarea. Note that messages sent to connections or users who are not logged in will not be accepted. |
||||||||||||||||||||
Category | Messages | ||||||||||||||||||||
See Also | DeleteAllMessages, DeleteMessage, MessageID, MessageMaxLength, MessageQueueSize, MessageRetrieved, MessagesWaiting, QueueMessage, RetrieveMessage | ||||||||||||||||||||
Example | The first example requests a connection number from the system supervisor. DisplayMessage "What is your connection no?", ToUser, "spvr" The next example sends a message which may be directed to any user. DisplayMessage "Is anybody out there?", ToAnyone The last example sends a message to a user who is locking a record and preventing access by other users. DisplayMessage "Please close your current record!", ToLocker |