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 FAX or 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 28.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.
• FAX addresses are built up using the commands shown in Table 28-1.

  Table 28-1 Addressing Channel FAX Commands

  Transmit after	AFTER
  Recipient's name	AT
  Authorization code	AUTH
  FAX gateway address	no equivalent AVPL item
  FAX telephone number	FN
  FAX modem's telephone number	FSI
  Recipient's organization	O
  Recipient's address	OU
  Initialization file	SETUP
  My FAX telephone number	SFN
  My telephone number	STN
  Recipient's telephone number	TN
  My organization	TTI

  In Table 28-1, the command names are listed in the first (left) column and for each command, the portion of a PMDF-FAX address which it represents is shown in the second column. The addressing channel will automatically quote items of a FAX address which require quoting (e.g., the symbols /, $, and =). See <REFERENCE>(HEAD2_FAXADDRESSFORMATS) for further information on PMDF-FAX addressing conventions. In building up a FAX address, both a FAX telephone number and FAX gateway address (e.g., text-fax.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 FAX gateway address can be omitted, in which case the default domain name will instead be used.

• Printer addresses are built up using the commands shown in Table 28-2.

  Table 28-2 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 28-2, 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 28.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.