PMDF Programmer's Reference Manual

PMDFabortMessage

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.

Contents

Index