Specify delivery and read receipt request addresses for a message being enqueued.

PASCAL

status = PMDF_set_receipt_addresses

(nq_context, read_address, delivery_address)

argument information

Argument	Data type	Access	Mechanism
nq_context	context pointer	read/write	reference
read_address	descriptor	read	reference
delivery_address	descriptor	read	reference

C

status = PMDFsetReceiptAddresses

(nq_context, read_address, read_address_len, delivery_address, delivery_address_len)

argument information

int PMDFsetReceiptAddresses(PMDF_nq **nq_context, char *read_address, int read_address_len, char *delivery_address, int delivery_address_len)

Arguments

nq_context

A message enqueue context created with PMDFstartMessageEnvelope .

read_address

Address to send a read receipt to. Length can not exceed ALFA_SIZE bytes.

read_address_len

Length in bytes of read_address.

delivery_address

Address to send a delivery receipt to. Length can not exceed ALFA_SIZE bytes.

delivery_address_len

Length in bytes of delivery_address.

Description

PMDFsetReceiptAddresses can be called to set default values for the addresses to which to send read or delivery receipts. If either string has zero length, then no default will be set for the associated receipt address. These addresses will then be used in the construction of read or delivery receipt request header lines whenever a read or delivery receipt is requested for the specified message enqueue context. Note that these default addresses can be overridden by other receipt request mechanisms or suppressed in response to PMDFreceiptControl call with suppress_receipts set true. By default, no read or delivery receipt addresses are set. Settings made with this routine only affect the specified message enqueue context and can be further changed by additional calls to PMDFsetReceiptAddresses .

Return Values

PMDF__OK	Normal, successful completion.
PMDF__BADCONTEXT	Illegal or corrupt context. Receipt addresses not changed.
PMDF__INVSTRDES	Invalid string descriptor for read_address or delivery_address: one or both of the descriptors has an invalid value in its DSC$B_CLASS field. Receipt addresses not changed.
PMDF__STRTRUERR	One or both of the input strings exceeds ALFA_SIZE bytes. Receipt addresses not changed.