Write a line of text to a message being enqueued.
status = PMDF_write_line (nq_context, line)
status = PMDFwriteLine (nq_context, line, line_len)
int PMDFwriteLine(PMDF_nq **nq_context, char *line, int line_len)
nq_contextA message enqueue context created with
lineLine of text to write to the message. Length can not exceed 65,535 bytes.
line_lenLength in bytes of line.
Text can be written to a message using
PMDFwriteText. The only difference between these two routines is that
PMDFwriteLinealways appends a record terminator, line feed, to the end of each line it outputs.
PMDFwriteTextdoes not: it is left to callers of
PMDFwriteTextto include record terminators, where appropriate, in their output. Each line written with
PMDFwriteLinewill appear as a single line (record) in the message being composed. For this reason,
PMDFwriteLineis often more convenient to use than
PMDFwriteText. However, programs which loop reading lines from a queued message and writing them to a new message should use
PMDFwriteTextin their loop. This is more efficient than
PMDFwriteLinewhich will needlessly strip away and then re-append a record terminator for each line read and written.
PMDF__OK Normal, successful completion. PMDF__BADCONTEXT Illegal or corrupt context. Line not written. PMDF__INVSTRDES Invalid string descriptor for line: descriptor has an invalid value in its DSC$B_CLASS field. Line not written.