Multiuser Lingo Dictionary > Multiuser Lingo Dictionary > join |  |

join

Syntax

    system.group.join ["@groupName"]

Description

Multiuser Server command; adds the sender to a group. If the group doesn't exist, it is automatically created. If the user already belongs to the group, no error occurs.

The server responds with a message for each group joined, matching the subject of the request message and containing the name of the group successfully joined.

Example

This statement adds the sender to the group @BeatleLovers:

    errCode = gMultiuserInstance.sendNetMessage("system.group.join", "anySubject", "@BeatleLovers")

The server's response looks like this:

    [#errorCode: 0, #recipients: ["userName"], #senderID: "system.group.join", #subject: "anySubject", #content: "@BeatleLovers", #timeStamp: 21765127]

This statement adds the sender to more than one group at the same time by putting the names of the groups in a list:

    errCode = gMultiuserInstance.sendNetMessage("system.group.join", "anySubject", ["@BeatleLovers", "@Photographers", "@Designers"])

The server sends a separate response for each group.

See also

`sendNetMessage()`