Added use cases for deleting logs and emptying cache.
Added use cases for getting list of idle users and of active users (where online = active + idle), getting number (rather than list) of registered/disabled/online/active/idle users, getting list of disabled users, getting user statistics.
Per a vote of the Jabber Council, advanced status to Active.
Addressed Council feedback: folded add blacklist use case into edit blacklist use case; folded add whitelist use case into edit whitelist use case; changed jid-single to jid-multi in many of the use cases; added accountjid field to change password use case; removed grant administrative privileges and revoke administrative privileges use cases (need edit admin list use case only); added max_items field to get active users and get registered users use case.
Added use case for editing message of the day.
Further clarified message of the day per list discussion.
Changed firstname to given_name.
Added note clarifying concept of message of the day.
Changed command naming requirement from MUST to SHOULD.
Added several more use cases; defined complete protocol flows; specified XMPP Registrar considerations.
Initial version.
It may be helpful to enable an administrator to retrieve the number of registered users who are online at any one moment. By "online user" is meant any user or account that currently has at least one active or connected resource as defined in &rfc3920bis; and &rfc3921bis; (whether that user is actively sending XML stanzas or is idle). The command node for this use case SHOULD be "http://jabber.org/protocol/admin#get-online-users-num".
+It may be helpful to enable an administrator to retrieve the number of registered users who are online at any one moment. By "online user" is meant any user or account that currently has at least one connected or available resource as specified in RFC 3920 and RFC 3921, whether that user is actively sending XML stanzas or is idle. The command node for this use case SHOULD be "http://jabber.org/protocol/admin#get-online-users-num".
A sample protocol flow for this use case is shown below.
A service may allow an administrator to delete a log related to the service (e.g., a server log, a personal conversation log, or a discussion log from a multi-user chat room). The command node for this use case SHOULD be "http://jabber.org/protocol/admin#deletelog".
-A sample protocol flow for this use case is shown below.
-Unless an error occurs (see the Error Handling section below), the service SHOULD return the appropriate form.
-A service may allow an administrator to empty cached information related to a service (e.g., the history of a chat room). The command node for this use case SHOULD be "http://jabber.org/protocol/admin#emptycache".
-A sample protocol flow for this use case is shown below.
-Unless an error occurs (see the Error Handling section below), the service SHOULD return the appropriate form.
-For the syntax of these errors, see &xmppcore;. Naturally, other errors may be returned as well (e.g., &internalserver; if the service cannot be shut down).
+For the syntax of these errors, see &xep0086;. Naturally, other errors may be returned as well (e.g., &internalserver; if the service cannot be shut down).
The ability to complete the administrative tasks specified herein MUST NOT be granted to users who lack service-level administrative privileges.
@@ -2755,9 +2595,6 @@