Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Messaging Server 6 2004Q2 Administration Reference 

About This Guide

This manual provides reference information about the Beta version of Sun™ Java System Messaging Server product. Messaging Server provides a powerful and flexible cross-platform solution to the email needs of enterprises and messaging hosts of all sizes using open Internet standards.

Use this manual as a companion to the Messaging Server Administration Guide. The administrator’s guide describes how to configure, maintain, monitor, and troubleshoot Messaging Server. This Administration Reference provides information about command-line utilities and configuration files. This information enables you to configure, maintain, monitor, and troubleshoot Messaging Server.

Topics covered in this chapter include:

Who Should Read This Book

This manual is intended for highly or moderately technical network administrators with experience in UNIX® or Windows NT. These administrators will be configuring, administering, and maintaining Messaging Server. Architects and developers may also use the Messaging Server Administration Reference. This manual is not intended for end users.

What You Need to Know

This book assumes that you are responsible for configuring, administering, and maintaining the Messaging Server software and that you have a general understanding of the following:

How This Book is Organized

This book contains the following chapters:

Document Conventions

Monospaced Font

Monospaced font is used for any text that appears on the computer screen or text that you should type. It is also used for filenames, distinguished names, functions, and examples.

Bold Monospaced Font

Bold monospaced font is used to represent text within a code example that you should type.

Italicized Font

Italicized font is used to represent text that you enter using information that is unique to your messaging server. It is used for server paths and names and account IDs.

For example, throughout this document you will see path references of the form:


In these situations, msg_svr_base represents the directory path in which you install the server. For example, if you install your server in the directory /opt/SUNWmsgsr, then msg_svr_base refers to /opt/SUNWmsgsr.

Italicized font is also used for variables within the synopsis of a command line utility. For example, the synopsis for the imadmin admin remove command is:

imadmin admin remove -D login -l userid -n domain -w password [-d domain]

  [-h] [-i inputfile] [-p idaport] [-X idahost] [-s] [-v]

In the above example, the italicized words are arguments for their associated option. For example, in the -w password option, you would substitute the Top-Level Administrator’s password for password when you enter the imadmin admin remove command.

Square or Straight Brackets

Square (or straight) brackets [] are used to enclose optional parameters. For example, in this manual you will see the usage for the readership command described as follows:

readership [-d days] [-p months]

It is possible to run the readership command by itself as follows to start the Messaging Server installation:


However, the presence of [-d days] and [-p months] indicate that there are additional optional parameters that may be added to the readership command. For example, you could use readership command with the -d option to count the number of people who have read messages in a shared folder within the indicated number of days:

readership -d 10

Command Line Prompts

Command line prompts (for example, % for a C-Shell, or $ for a Korn or Bourne shell) are not displayed in the examples. Depending on which operating system environment you are using, you will see a variety of different command line prompts. However, you should enter the command as it appears in the document unless specifically noted otherwise.

Platform-specific Syntax

Note that the examples in this book use the UNIX C shell. If necessary, make appropriate adjustments to your preferred shell.

Related Third-Party Web Site References

Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Where to Find Related Information

In addition to this guide, Messaging Server comes with supplementary information for administrators as well as documentation for end users and developers. Use the following URL to see all the Messaging Server documentation:

Listed below are the additional documents that are available:

The Sun Java System Messaging Server product suite contains other products such as Sun ONE Console, Directory Server, and Administration Server. Documentation for these and other products can be found at the following URL:

In addition to the software documentation, see the Sun Java System Messaging Server Software Forum for technical help on specific Messaging Server product questions. The forum can be found at the following URL:

Where to Find This Book Online

You can find the Messaging Server Administration Reference online in PDF and HTML formats. To find this book, use this URL:

Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.