Node:send-message, Next:, Previous:get-unread-confs, Up:Protocol Requests


send-message [53] (1) Recommended


        send-message [53] (( recipient  :   Conf-No;
                             message    :   HOLLERITH ))
                -> ( );

This call sends the message message to all members of recipient using async-send-message. If recipient is 0, the message is sent to all sessions that are logged in.

The message is sent to all members of recipient that are currently logged in, and where the passive and passive-message-invert bits of the Membership-Type (see Membership-Type) don't prevent the message from being delivered.

Example: 

        1 53 4 14HThis is a test
        =1
        1 53 1 14HThis is a test
        :3 12 1 8 14HThis is a test
        =1
        1 53 0 14HThis is a test
        :3 12 0 8 14HThis is a test
        =1
        1 53 5 14HThis is a test
        %1 16 0
        1 53 3 14HThis is a test
        %1 42 0

Error codes

login-first
Login required before issuing this call.
string-too-long
The string message is too long.
undefined-conference
Conference recipient does not exist or is secret.
feature-disabled
The message feature has been disabled in the server.
message-not-sent
The message was not sent for some other reason. Perhaps the recipient is not accepting messages or no member of the recipient was logged on.