PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Set the NOTARY flags for the next envelope recipient address.

VMS FORMAT

status = PMDF_set_recipient_flags

(nq_context, notary_flags)

C FORMAT

status = PMDFsetRecipientFlags

(nq_context, notary_flags)

int PMDFsetRecipientFlags (dq_context, notary_flags) 
         PMDF_nq **nq_context; 
         int       notary_flags; 

ARGUMENTS

nq_context

A message enqueue context created with PMDF_start_message_envelope.

notary_flags

Longword integer containing NOTARY flag bits.

DESCRIPTION

PMDF mail messages carry per recipient NOTARY information in their envelope. This information is aligned with the NOTARY SMTP extension as described in RFC 1891 and describes failure and success handling requested by the sender (e.g., send a delivery receipt, send failure notifications but do not include return of content, never send any form of notifications, etc.). By default, when an envelope recipient address is enqueued, PMDF assigns it the NOTARY handling PMDF_RECEIPT_FAILURES + PMDF_RECEIPT_DELAYS which indicates that non-delivery notifications (NDNs) should be generated for delivery failures and delays. To select, for a given envelope recipient address, different handling characteristics or to propogate NOTARY flags from a previous dequeue operation, call PMDF_set_recipient_flags prior to calling PMDF_add_recipient. The notary_flags argument is a bit mask whose bits are given in Table 1-6 . Note that PMDF_RECEIPT_NEVER and PMDF_RECEIPT_FAILURES may not both be set. If both are set, then PMDF_RECEIPT_NEVER will be ignored. Similarly, if both PMDF_RECEIPT_HEADER and PMDF_RECEIPT_NOHEADER are set, then PMDF_RECEIPT_NOHEADER is ignored. When neither are set, then notifications will include full return of content (RET=FULL).