PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Previous | Contents

PMDF_start_message_header

Begin the message header of a message which is being enqueued.

VMS FORMAT

status = PMDF_start_message_header (nq_context)

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

C FORMAT

status = PMDFstartMessageHeader (nq_context)

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

ARGUMENTS

nq_context

A message enqueue context created with PMDF_start_message_envelope.

DESCRIPTION

After the message envelope has been constructed by calls to PMDF_add_recipient, the construction of the message header is started with a call to PMDF_start_message_header. Header lines may be written with PMDF_write_header, PMDF_write_line, PMDF_write_text, PMDF_write_from, PMDF_write_date, and PMDF_write_subject. The only mandatory header lines which must be written are the From: and Date: header lines. PMDF will supply all other required header lines.
Return Values
PMDF__OK Normal, successful completion.
PMDF__BADCONTEXT Illegal or corrupt context. Message header not started.

Previous | Next | Contents