Skip to main content
Version: Next

SEND MESSAGE TO REMOTE USER

SEND MESSAGE TO REMOTE USER ( message {; userSession} )

ParameterTypeDescription
messageTextText sent to user
userSessionTextUser's session ID

Description

The SEND MESSAGE TO REMOTE USER command sends a message to all remote users or to a specific remote user.

In message, pass the text of the message to be displayed. It will be displayed as an alert or a notification on the screen of the session user(s).

The optional userSession parameter can be used to designate a specific user by passing their session ID. You can retrieve the session ID with the Process activity command. If userSession is omitted, the message is sent to all users.

Note: This command can only be executed on 4D Server. If the method calling the command is executed locally on a remote client or on 4D single user, SEND MESSAGE TO REMOTE USER does nothing.

Example

You want to send a message to all users, then send a message to a specific user:

  // Method to be executed on server
 var $message : Text
 var $element : Object
 var $userCol : Collection
 
  // retrieve session information
 $userCol:=(Get process activity(Sessions only)).sessions
 
  // send message to all users
 $message:="A maintenance operation is scheduled for 10pm. The server will be restarted. Please log out before 10pm."
 SEND MESSAGE TO REMOTE USER($message)
 
  // send message to a single user, "Vanessa"
 $message:="Hello Vanessa"
 $userCol:=Get process activity(Sessions only).sessions.query("systemUserName = :1";"Vanessa")
 For each($element;$userCol)
    SEND MESSAGE TO REMOTE USER($message;$element.ID)
 End for each

See also

DROP REMOTE USER

Properties

Command number1632
Thread safe