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

Return Values

Return Values  



Normal, successful completion. 


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.

  3. A required argument to an item code was NULL.


If MTA_DQ_CONTEXT was specified, then the supplied envelope To: address does not match any envelope recipient address in the queued message represented by the supplied dequeue context. Otherwise, the MTA rejected the envelope recipient address. It could be syntactically invalid, refused by a mapping table, such as SEND_ACCESS. Consider using the MTA_REASON item code.


An invalid item code was specified. 


The call was made out of order: the message’s envelope recipient list has already been terminated by a call to mtaEnqueueWrite() or mtaEnqueueWriteLine().


The supplied envelope To: address or original envelope To: address is too long. Neither may exceed a length of ALFA_SIZE bytes.