PMDF System Manager's Guide

When the addressing channel processes a message, it scans, from top to bottom, the body of the message for addressing information. Special commands are used to specify addressing information. The rules used for parsing a message are:

1. The addressing information section begins when the first legal addressing command is encountered; any portion of the message body preceding the addressing information is discarded and not included in the subsequent message.
2. Whitespace between addressing commands is ignored; (except see rule 3, below).
3. At least one blank line must separate a printer address (block) from other addresses.
4. The addressing portion of the message is terminated with a stop or end command or when something other than a legal addressing command is encountered; the portion of the message body following the addressing information is the only part of the message body to be mailed to the To: address list.

The syntax of an addressing command is as follows:

:command-name:value

where command-name is the name of the command and value is the addressing information being specified with the command. A delimiter character other than a colon, : , can be chosen with the DELIMITER channel option. See Section 26.1.3.2.

Command names are case insensitive and can include punctuation or spaces or both. The default command names are

• A From: address and Subject:, Comments:, and X-PS-Qualifiers: header lines can be specified with the From, Subject, Comments, PS Qualifiers commands. These commands are primarily intended for use with files routed to an addressing channel via a queue to e-mail symbiont (e.g., PostScript documents printed from a word processor for FAXing via PMDF-FAX). ¹
• Regular mail addresses are specified using any of the synonymous commands To, Cc, Bcc, e-mail, email, PMDF, RFC822.
• Use the "delivery receipt " command to specify an address to which to send delivery receipts. Delivery receipts will be requested of all recipients following this command. Use the command "no delivery receipt " to suppress delivery receipts from subsequently specified recipients. Note that report* channel keywords can affect the interpretation of such delivery receipt requests.
• Printer addresses are built up using the commands shown in Table 26-1.

  Table 26-1 Addressing Channel Printer Commands

  Command name	Printer channel AVPL equivalent
  Recipient's name	AT
  Mail stop	MS
  Printer domain name	no equivalent AVPL item
  Recipient's organization	O
  Recipient's address	OU
  P1-- P8	P1--P8
  Initialization file	SETUP
  Recipient's telephone number	TN
  Username	USERNAME

  In Table 26-1, the command names are listed in the first (left) column and for each command, the portion of a printer channel address which it represents is shown in the second column. The addressing channel will automatically quote items of a printer address which require quoting (e.g., the symbols /, $, and =). See Section 26.6.2 for further information on printer channel addressing conventions. In building up a printer address, the printer domain name (e.g., printer.example.com) must be specified. If the DEFAULT_DOMAIN channel option has been used to establish a default domain for use with FAX or printer addresses, then the printer domain name can be omitted, in which case the default domain name will instead be used.

• The addressing information can be terminated with a stop or end command, e.g.:

  :stop:

  The use of either of these two commands is optional in most cases. Only when PostScript files are being routed to an addressing channel via a queue to e-mail symbiont is their use mandatory.