PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Set message fragmentation thresholds.

VMS FORMAT

status = PMDF_set_limits

(nq_context, max_blocks, max_lines, max_to)

C FORMAT

status = PMDFsetLimits

(nq_context, max_blocks, max_lines, max_to)

int PMDFsetLimits (nq_context, max_blocks, max_lines, 
                   max_to) 
         PMDF_nq **nq_context; 
         int       max_blocks; 
         int       max_lines; 
         int       max_to; 

ARGUMENTS

nq_context

A message enqueue context created with PMDF_start_message_envelope.

max_blocks

Non-negative integer specifying the maximum number of blocks (header + body) per message. A value of zero implies no limit.

max_lines

Non-negative integer specifying the maximum number of message lines (header + body) per message. A value of zero implies no limit.

max_to

Non-negative integer specifying the maximum number of envelope To: addresses per message. A value of zero implies no limit.

DESCRIPTION

PMDF may be instructed to fragment "large" messages into multiple messages. Large is taken by PMDF to mean exceeds max_blocks blocks, exceeds max_lines message lines, or exceeds max_to envelope To: addresses. All of these limits are simultaneously imposed. When either max_blocks or max_lines is exceeded, the message is fragmented into multiple messages using MIME's message/partial mechanism. MIME compliant mailers receiving the message may automatically re-assemble the message upon receipt of all of the pieces. (PMDF channels must be marked with the defragment keyword for automatic message re-assembly to occur.) When the max_to limit is exceeded, the message is merely broken into multiple copies, each copy with an envelope To: address list of length less than or equal to max_to. Note that the size of a block in bytes is given by the PMDF option file entry BLOCK_SIZE. When not specified in an option file, the default value of 1024 bytes is used. The function PMDF_get_block_size should be used to determine the current block size. Settings chosen with PMDF_set_limits only affect the specified message enqueue context and may be changed with further calls to PMDF_set_limits. By default, no limits are imposed: max_blocks = max_lines = max_to = 0.