imsconnutil (Sun Java System Messaging Server 6.3 Administration Reference)

Sun Java System Messaging Server 6.3 Administration Reference

imsconnutil

Monitors user access of the message store. imsconnutil can provide the following information:

Who is currently logged in on IMAP or or any http web mail client.
The last access time (log in or log out) for a specified user.
For IMAP: lists the authentication method, the IP address from which the user is logged in, the IP address to which the user is connected, and the port on which they are logged to and from.

This command requires root access by the system user, and you may set the configuration variables local.imap.enableuserlist, local.http.enableuserlist, local.enablelastaccess to 1.

Location: msg-svr-base/sbin

Syntax

imsconnutil -c|-a [-s service] [-u uid] [-f filename] 

imsconnutil -k {-u uid | -f filename}

Options

The options for this command are:

Option	Description
`-c\|-a\|-k`	At least one of `-c` or `-a`, or `-k` must be used.
`-a`	Last IMAP, POP, or http web mail client access (log in or log out) of user(s). `-s` does not affect the output of `-a`.
`-c`	List IMAPusers currently connected.
`-k`	Disconnect users from IMAP and POP. Users logged on to Communications Express lose the underlying IMAP connection and, thus, are also disconnected. The `-k` option must be used with either the —u `uid` option to specify users to disconnect or the —f `filename` option to specify the users listed in `filename`. Note that `-k` option may only work if IMAP IDLE is configured.
`-s` `service`	Can specify either imap or http as service to monitor. Only applies to `-c` option. POP is not available because POP users do not typically stay logged on.
`-u` `uid`	Specify a UID to monitor. If -u and -f are not listed, then all users are monitored.
`-f` `filename`	File containing UIDs to monitor. Each UID must be on its own line.
`--v`	Returns version of this tool.
`--h`	Returns usage information.

Examples

The following examples show imsconnutil and some various flags.

Lists every user ID currently logged into IMAP and http.

# imsconnutil -c

Lists last IMAP, POP, or Messenger Express access (log in or log out) of every user ID.

# imsconnutil -a

Lists access history (last log off or log on) of all user IDs. Lists current user IDs logged into IMAP and http.

# imsconnutil -a -c

Lists IMAP users currently logged on the message store.

# imsconnutil -c -s imap

Reveals whether user ID George is logged onto IMAP or not.

# imsconnutil -c -s imap -u George

Reveals whether user ID George is currently logged onto IMAP or Messenger Express, and lists the last time George was logged o or off.

# imsconnutil -c -a -u George

Disconnects the user ID George.

# imsconnutil -k -u George