PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Defer a message for later processing.

VMS FORMAT

status = PMDF_defer_message

(dq_context, increment, reason)

C FORMAT

status = PMDFdeferMessage

(dq_context, increment, reason, reason_len)

int PMDFdeferMessage (dq_context, increment) 
         PMDF_dq **dq_context; 
         int       increment; 
         char     *reason; 
         int       reason_len; 

ARGUMENTS

dq_context

A message dequeue context created with PMDF_dequeue_initialize.

increment

If true, the message's retry count will be incremented; otherwise, the retry count will be left unchanged.

reason

Optional text string describing why the message is being deferred. The length of this string should not exceed BIGALFA_SIZE bytes.

reason_len

Length in bytes of reason.

DESCRIPTION

NOTE: Although still supported, this routine is now obsolete. Use the PMDF_dequeue_message_end routine instead. PMDF_defer_message may be called to defer processing of the currently accessed message. The deferred message will be left in PMDF's message queues for processing by a subsequent processing job. If the message continues to remain in the message queues long enough, it will be returned by PMDF's message return system. See the message return and bouncing discussions in the PMDF System Manager's Guide for further details on this subject. When a message is deferred, no notification messages will be generated despite any prior calls to PMDF_recipient_disposition. This is because deferring a message with PMDF_defer_message causes all of the message's recipient addresses to be deferred for later reprocessing.