This manual describes the Sun JavaTM System Messaging Server 6 2005Q4 Message Transfer Agent (MTA) Software Development Kit (SDK) and Callable Send facility.
While this document is primarily intended for system programmers writing mail software, system managers wishing to become more familiar with the inner workings of the MTA may also benefit from a casual reading of this manual.
Programmers wishing to write gateways or channels should use the MTA SDK. Programmers writing code merely to send mail will probably find the Callable Send facility sufficient for their needs.
A working knowledge of the following material is essential to programmers writing software that will create electronic mail messages with the MTA SDK:
Sun JavaTM Enterprise System Messaging Server
RFC 2822 - the successor to RFCs 822 and 1123
Understanding this RFC is essential for programmers writing software that creates electronic mail messages with this SDK.
RFCs 2045, 2046, 2047, and 2049
These RFCs are useful for programmers interested in creating MIME compliant messages.
This manual describes two distinct interfaces. Each interface has an introductory chapter and a reference chapter and corresponding appendixes.
Chapter 1, MTA SDK Concepts and Overview provides an overview and description of general concepts of the MTA SDK.
Chapter 2, MTA SDK Programming Considerations describes procedures and run time instructions.
Chapter 3, Enqueuing Messages describes the process of submitting a message to the MTA for delivery.
Chapter 4, Dequeuing Messages describes the process of dequeing messages.
Chapter 5, Decoding Messages describes the process of decoding messages.
Chapter 6, MTA SDK Reference contains definitions of the MTA SDK routines.
Chapter 7, Using Callable Send mtaSend() describes the MTA Callable Send facility which is used to send mail messages from the local host.
Chapter 8, mtaSend() Routine Specification provides syntax and item codes for the mtaSend() routine.
Chapter 9, Error Status Codes Summary describes the error status codes returned by the MTA SDK and mtaSend().
The following table summarizes the books included in the Messaging Server core documentation set.
Table P–1 Messaging Server Documentation Set
Document Title |
Contents |
---|---|
Contains important information available at the time of release of Sun Java System Messaging Server 6 2005Q4. |
|
Sun Java System Messaging Server 6 2005Q4 Administration Guide |
Explains how to administer Messaging Serverand its accompanying software components. |
Sun Java System Messaging Server 6 2005Q4 Administration Reference |
Describes the Messaging Server Message Transfer Agent (MTA) Software Development Kit (SDK) and Callable Send facility. |
Sun Java System Messenger Express 6 2005Q4 Customization Guide |
Explains how to customize the look and feel of Sun JavaTM System Messenger Express. Although the product architecture permits an almost unlimited customization of the static portion of the pages served by the Messenger Express HTTP daemon, this guide focuses on how to perform the most commonly requested customizations. |
The http://docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.
For other server documentation related to deploying Messaging Server, go to the following:
Access Manager documentation: http://docs.sun.com/app/docs/coll/1292.1
Calendar Server documentation: http://docs.sun.com/app/docs/coll/1313.1
Communications Express documentation: http://docs.sun.com/app/docs/coll/1312.1
Directory Server documentation: http://docs.sun.com/app/docs/coll/1316.1
Instant Messaging documentation: http://docs.sun.com/app/docs/coll/1309.1
Messaging Server documentation: http://docs.sun.com/app/docs/coll/1312.1
The following table describes the default paths and file names that are used in this book.
Table P–2 Default Paths and File Names
Placeholder |
Description |
Default Value |
---|---|---|
msg_svr_base |
Represents the base installation directory for Messaging Server. |
Solaris systems: /opt/SUNWmsgsr Linux systems: /opt/sun/messaging |
The following table describes the typographic changes that are used in this book.
Table P–3 Typographic Conventions
Typeface |
Meaning |
Example |
---|---|---|
AaBbCc123 |
The names of commands, files, and directories, and onscreen computer output |
Edit your .login file. Use ls -a to list all files. machine_name% you have mail. |
AaBbCc123 |
What you type, contrasted with onscreen computer output |
machine_name% su Password: |
AaBbCc123 |
A placeholder to be replaced with a real name or value |
The command to remove a file is rm filename. |
AaBbCc123 |
Book titles, new terms, and terms to be emphasized (note that some emphasized items appear bold online) |
Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. |
The following table shows default system prompts and superuser prompts.
Table P–4 Shell Prompts
Shell |
Prompt |
---|---|
C shell on UNIX and Linux systems |
machine_name% |
C shell superuser on UNIX and Linux systems |
machine_name# |
Bourne shell and Korn shell on UNIX and Linux systems |
$ |
Bourne shell and Korn shell superuser on UNIX and Linux systems |
# |
Microsoft Windows command line |
C:\ |
The following table explains symbols that might be used in this book.
Table P–5 Symbol Conventions
Symbol |
Description |
Example |
Meaning |
---|---|---|---|
[ ] |
Contains optional arguments and command options. |
ls [-l] |
The -l option is not required. |
{ | } |
Contains a set of choices for a required command option. |
-d {y|n} |
The -d option requires that you use either the y argument or the n argument. |
${ } |
Indicates a variable reference. |
${com.sun.javaRoot} |
References the value of the com.sun.javaRoot variable. |
- |
Joins simultaneous multiple keystrokes. |
Control-A |
Press the Control key while you press the A key. |
+ |
Joins consecutive multiple keystrokes. |
Ctrl+A+N |
Press the Control key, release it, and then press the subsequent keys. |
-> |
Indicates menu item selection in a graphical user interface. |
File -> New -> Templates |
From the File menu, choose New. From the New submenu, choose Templates. |
The docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. Books are available as online files in PDF and HTML formats. Both formats are readable by assistive technologies for users with disabilities.
To access the following Sun resources, go to http://www.sun.com:
Downloads of Sun products
Services and solutions
Support (including patches and updates)
Training
Research
Communities (for example, Sun Developer Network)
Third-party URLs are referenced in this document and provide additional, related information.
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 or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the full document title and part number. The part number is a 7-digit or 9-digit number that can be found on the book's title page or in the document's URL. For example, the part number of this book is 819-2652.