imsconnutil (Sun Java System Messaging Server 6 2005Q4 Administration Reference)

Sun Java System Messaging Server 6 2005Q4 Administration Reference

imsconnutil

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

Who is currently logged in on IMAP or Messenger Express (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.

Note –

Do not kill this process while it is operating.

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 [-a|c] [-s service] [-u uid] [-f filename]

Options

The options for this command are:

Option	Description
`-c\|-a`	At least one of `-c` or `-a` 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 IMAP or Messenger Express users currently connected.
`-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