Abort a message enqueue context.

PASCAL

status = PMDF_abort_message (nq_context)

argument information

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

C

status = PMDFabortMessage (nq_context)

argument information

int PMDFabortMessage(PMDF_nq **nq_context)

Arguments

nq_context

A message enqueue context created with PMDFstartMessageEnvelope .

Description

PMDFabortMessage aborts the specified message enqueue context, deleting the message associated with that context. The specified enqueue context is no longer usable; a new one can be generated with PMDFstartMessageEnvelope . This routine is typically called when an error occurs while enqueuing a message and the submission needs to be aborted.

Return Values

PMDF__OK

Normal, successful completion.