PMDF Programmer's Reference Manual
PMDF-PRM-6.0


Previous | Contents

PMDF_alias_no_expansion

Inhibit the expansion of aliases for all subsequent recipient addresses.

VMS FORMAT

status = PMDF_alias_no_expansion (nq_context)

argument information
Argument Data type Access Mechanism
nq_context context pointer read/write reference

C FORMAT

status = PMDFaliasNoExpansion (nq_context)

argument information
int PMDFaliasNoExpansion (nq_context) 
         PMDF_nq **nq_context; 

ARGUMENTS

nq_context

A message enqueue context created with PMDF_start_message_envelope.

DESCRIPTION

Generally, expansion of aliases should never be inhibited. However, there is at least one situation where alias expansion must be inhibited. That situation arises when a message being dequeued needs to be re-enqueued to the same channel with a subset of its envelope recipient list. That is done by enqueuing a new message, inhibiting alias expansion, specifying only the envelope addresses of the desired subset, ending the envelope, and then copying the message content verbatim with PMDF_copy_message.
Return Values
PMDF__OK Normal, successful completion.


Previous | Next | Contents