Sun Java System Messaging Server 6 2005Q4 Administration Reference

imsexport

The imsexport utility exports Sun Java System Messaging Server folders into UNIX /var/mail format folders.

The imsexport utility extracts the messages in a message store folder or mailbox and writes the messages to a UNIX file under the directory specified by the administrator. The file name is the same name as the IMAP folder name. For message store folders that contain both messages and sub-folders, imsexport creates a directory with the folder name and a file with the folder name plus a .msg extension. The folder.msg file contains the messages in the folder. The folder directory contains the sub-folders.

Location: msg_svr_base/sbin

Syntax


imsexport -d dir -u user [-e encoding] [-g] [-s mailbox] [-v mode]

Options

The options for this command are:

Option  

Description  

-d dir

Specifies the destination directory name where the folders will be created and written. This is a required option. 

-e encoding

Specify an encoding option. 

-g

Specifies debugging mode. 

-s mailbox

Specifies the source folder to export. 

-u user

Specifies the message store id for a user. Note that this is not necessarily the login id of the user. The message store id is either userid (for default domain users) or userid@domain (for other users). This is a required option.

-v mode

Specifies verbose mode. The values for mode are 0, 1, and 2. 0 specifies no output. 1 specifies mailbox level output. 2 (default) specifies message level output.

Example

In the following example, imsexport extracts all email for user smith1. smith1 is a valid user account in the Sun Java System Messaging Server message store. User smith1 has three folders on the store: INBOX (the normal default user folder), private, and private/mom. The destination directory will be /tmp/joes_mail.


% imsexport -u smith1 -d /tmp/joes_mail/

imexport then transfers each message store folder into a /var/mail conforming file. Thus you will get the following files: