Sun Java System Messaging Server 6 2005Q4 MTA Developer's Reference

Description

After a message’s list of envelope recipient addresses has been supplied with mtaEnqueueTo(), the message itself must be supplied. This can be done by repeatedly calling mtaEnqueueWriteLine(). First the message’s header should be supplied, followed by a blank line, followed by any message content. Each call to this routine must supply a single, complete line of the message. The line should not include a line-feed terminator as mtaEnqueueWriteLine() will supply the terminator automatically.

Calling mtaEnqueueWriteLine() terminates the message’s envelope recipient list. Once the routine is called, mtaEnqueueTo() can no longer be called for the same enqueue context.

Return Values

Return Values  

Description  

0

Normal, successful completion. 

MTA_BADARGS

This value is returned for one of the following reasons: 

  1. A NULL value was supplied for the nq_ctx call argument.

  2. An invalid enqueue context was supplied for nq_ctx, or a required argument to an item code was NULL.

MTA_FCREATE

Unable to create a disk file. 

MTA_FIO

Error writing to a disk. 

MTA_ORDER

Call made out of order. No envelope recipient addresses have been supplied. 

MTA_THREAD

Simultaneous use of the enqueue context by two different threads was detected.