PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Previous | Contents

PMDF_set_receipt_addresses

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

VMS FORMAT

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 FORMAT

status = PMDFsetReceiptAddresses

(nq_context, read_address, read_address_len, delivery_address, delivery_address_len)

argument information 
int PMDFsetReceiptAddresses (nq_context, read_address, 
                             read_address_len, 
                             delivery_address, 
                             delivery_address_len) 
         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 PMDF_start_message_envelope.

read_address

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

read_address_len

Length in bytes of read_address.

delivery_address

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

delivery_address_len

Length in bytes of delivery_address.

DESCRIPTION

PMDF_set_receipt_addresses may 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 may be overridden by other receipt request mechanisms or suppressed in response to PMDF_receipt_control 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 may be further changed by additional calls to PMDF_set_receipt_addresses.
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.

Previous | Next | Contents