Multiuser Lingo Dictionary > Multiuser Lingo Dictionary > delete

 

delete

Syntax

system.movie.delete ["movieName"]
system.movie.delete ["movieName1", "movieName2", "movieName3"]
system.group.delete ["groupName"]
system.group.delete ["groupName1", "groupName2", "groupName3"]
system.user.delete ["userID"]
system.user.delete ["userID1", "userID2", "userID3"]

Description

Multiuser Server command; when movie is specified, immediately deletes all instances of the given movie or movies from the server. New connections to that movie are still possible if the disable command has not been called.

If group is specified, the given group(s) is deleted from the server. This does not delete the users who occupied the group.

If user is specified, the given user(s) is immediately disconnected from the server. To disconnect several users, send a list of users.

The server responds with a message that has the same object and command in the #sender parameter and the same #subject and #contents.

Note: There is also a delete command in the general Lingo Dictionary that is applied to chunk expressions. It should not be confused with the Multiuser Server delete command, which is always used in the context of a sendNetMessage() command.

Examples

This statement deletes all instances of the movie TankWars on the server:

errCode = gMultiuserInstance.sendNetMessage("system.movie.delete", "anySubject" "TankWars")

To delete more than one movie, use a list containing the movie names:

errCode = gMultiuserInstance.sendNetMessage("system.movie.delete", "anySubject" ["TankWars", "TicTacToe", "Checkers"])

This statement deletes the group @RedTeam from the server:

errCode = gMultiuserInstance.sendNetMessage("system.group.delete", "anySubject" "@RedTeam")

This statement disconnects the user BillyJoe from the server:

errCode = gMultiuserInstance.sendNetMessage("system.user.delete", "anySubject", "BillyJoe")

See also

sendNetMessage(), disable