Test -header utility

Test message header processing.

Syntax
imsimta test -header

Parameters
None.

Description
The  utility parses header lines,  optionally performing certain types of  header trimming, and outputs the  processed header lines (including, prior to MS 7.0u4, a PostScript  version). The utility may either read header lines from a file (  ) or from the command line  (in that case prompting with  ). The output takes the general form: --- Output with options --- parsed&#x3e; header-line-1 parsed&#x3e; header-line-2 ... --- PS --- PostScript-output --- After decode/encode and no options --- parsed&#x3e; header-line-1 parsed&#x3e; header-line-2 ... though as of MS 7.0u4, the PostScript output is optional and will not be included unless   is explicitly specified. The " " section of the output is what results from performing any relevant header trimming specified  via the   switch. The " " section of the output shows canonicalization effects on header field names and header field values,  but does not include effects of   header trimming  unless   has been specified.

Specify the alignment point for header lines, analogous to the   channel option; the default is 0, which causes header lines not to be  aligned.

,  (default)
causes application of any relevant header trimming directives specified via the      switch, applying such trimming to the underlying header structure. Note that not all trim options make sense to apply to the underlying header  structure, as some trim options relate to output, not to the underlying  header storage. So for instance trim options such as RELABEL, and  LINELENGTH,  are not relevant (and will not occur) with. is only relevant when   has been specified (  has no  effect unless   has been specified), so    cannot sensibly be combined with   ; (as of MS 7.0u4, indeed the combination is an  error).

,   (default)
The default is.

,  (default)
The default is.

,  (default)
(New in MS 7.0u4) When  is specified, the output  includes, prior to the "After applying options" output: --- Dump of header --- dump of header structure

,  (default)
The default  switch corresponds to the    channel option, while the   switch corresponds to the    channel  option.

Specify the increment used when attempting to fold header lines, analogous to the    channel option; the default is 20.

,  (default)
Specifying  causes   to be  ignored, and forces. (As of MS 7.0u4, attempting to specify either   or   with    is an error.)

Specify the length at which to wrap header lines, analogous to the   channel option and the  LINELENGTH header trimming option;  the default is 80.

,  (default)
The  switch specifies a  header trimming option file  to open, read, and parse. Options relevant to output of header lines will be shown when   is not specified; if    is specified then only those options affecting  the  underlying header structure (header structure storage) will take  effect. (In particular, with  set, only  ADD, FILL,  and PRECEDENCE will take effect. In contrast, with the default  , then options such as  RELABEL and LINELENGTH will  also take effect.)   can not be combined with   ; (indeed, as of MS 7.0u4 specifying both is an  error).

,  (default)
(New in MS 7.0u4)  (the default as of MS  7.0u4) disables the outputting of a PostScript version of the header  lines. Specifying  causes the PostScript  version to be output; prior to MS 7.0u4, this was not controllable with  the PostScript version always being output.

,  (default)
Specifying  causes the MTA to use a different way of  reading header information. The results with vs. should always be identical; report to Oracle if differences are seen. is ignored if   has been specified; (indeed, as of MS 7.0u4  attempting to specify both is an error). is the default.

(default),
Control whether or not to trim trailing white space off header lines. The default is, meaning to perform such white space  trimming.

Examples
header&#x3e; CoNtEnT-TrAnsFeR-eNcOdInG: bAsE64 header&#x3e; --- After applying options --- parsed&#x3e; Content-transfer-encoding: bAsE64 --- PS --- /Courier-Bold findfont 10 scalefont /Courier findfont 10 scalefont /SHOW_HEADERS where {pop (Content-transfer-encoding: bAsE64) SHOW_HEADERS} {35 720 moveto exch dup setfont (Content-transfer-encoding:) show exch dup setfo nt ( bAsE64) show} ifelse pop pop --- After decode/encode and no options --- parsed&#x3e; Content-transfer-encoding: BASE64 header&#x3e; Ctrl-D # The above example from an older version (when the PostScript was included by default) shows the canonicalization of the  Content-transfer-encoding: header line field name, and field value. --- Output with options --- parsed&#x3e; Message-id: &#x3c;01NYWMSLISS600H4Y@domain.com&#x3e; parsed&#x3e; Date: Mon, 14 Mar 2011 14:18:50 -0700 (PDT) parsed&#x3e; From: John Doe &#x3c;jdoe@domain.com&#x3e; parsed&#x3e; To: Jane Brown &#x3c;jbrown@domain.com&#x3e; parsed&#x3e; Subject: New report --- After decode/encode and no options --- parsed&#x3e; Received: from localhost by host.domain.com parsed&#x3e; (Oracle Communications Messaging Exchange Server 7u5-2.03 64bit) parsed&#x3e; (built Feb  6 2011) with ESMTP id &#x3c;0G8P00B01ZFNUV@domain.com&#x3e; parsed&#x3e; for jbrown@domain.com (ORCPT jbrown@domain.com); Mon, parsed&#x3e; 14 Mar 2011 15:47:47 -0800 (PDT) parsed&#x3e; Date: Mon, 14 Mar 2011 15:47:47 -0800 (PDT) parsed&#x3e; From: John Doe &#x3c;jdoe@domain.com&#x3e; parsed&#x3e; Subject: New report parsed&#x3e; To: Jane Brown &#x3c;jbrown@domain.com&#x3e; parsed&#x3e; Message-id: &#x3c;01NYWMSLISS600H4Y@domain.com&#x3e; parsed&#x3e; MIME-version: 1.0 parsed&#x3e; Content-type: MULTIPART/MIXED # The above example shows applying the default header trimming file, , used when constructing DSNs; see  Sample distributed   file. Note that such trimming has removed the Received:, MIME-version:, and Content-type: header lines, and moved the  Message-Id: header line above the other retained header lines.
 * 1) ./imsimta test -header
 * 1) ./imsimta test -header -options=IMTA_TABLE:return_header.opt -input=sample_headers.txt

See also:
 * Header option files
 * headerlabelalignment Option
 * Header option file format
 * headerfoldremove Option
 * headerfoldpreserve Option
 * headerlineincrement Option
 * headerlinelength Option
 * MTA command line utilities