PMDF System Manager's Guide

Contents

Preface
Preface	Preface
Part 1
Part 1	Part 1
Chapter 1
1	Structure and Overview
1.1	The Structure of PMDF
1.2	The PMDF Configuration File: Channels and Rewrite Rules
1.2.1	Channels
1.2.2	Domain Rewriting Rules
1.3	Enabling PMDF to Receive Messages
1.4	Processing Jobs
1.4.1	Immediate Message Submission Jobs
1.4.2	Manually Starting an Immediate Message Submission Job
1.4.3	The Periodic Message Delivery Retry Job
1.4.3.1	Adjusting Periodic Delivery Retry Job Frequency
1.4.3.2	Clean Up Tasks Performed by the Periodic Delivery Job
1.4.4	Returning Undeliverable Messages
1.4.4.1	Adjusting Return Job Frequency
1.4.4.2	Clean Up Tasks Performed by the Return Job
1.4.5	Managing Processing Job Execution on OpenVMS
1.4.6	Running Processing Jobs Under a Username Other than SYSTEM on OpenVMS
1.5	Storage of Message Files on Disk
1.5.1	Channel Queue Formats
1.5.2	Message File Structure
1.6	Other Important Files
1.7	Installation Environment: Logicals (OpenVMS), Tailor File (UNIX), Registry (NT)
1.8	Compliance with Standards
Chapter 2
2	The Configuration File: Domain Rewrite Rules & the Channel/Host Table
2.1	Structure of the Configuration File
2.1.1	Blank Lines in the Configuration File
2.1.2	Comments in the Configuration File
2.1.3	Continuation Lines in the Configuration File
2.1.4	Including Other Files in the Configuration File
2.2	Domain Rewriting Rules
2.2.1	The Purpose of Domain Rewriting Rules
2.2.2	Location and Format of Domain Rewriting Rules
2.2.3	Application of Domain Rewriting Rules to Addresses
2.2.3.1	Extraction of the First Host/domain Specification
2.2.3.2	Scanning the Rewrite Rules
2.2.3.3	Applying the Rewrite Rule Template
2.2.3.4	Finishing the Rewriting Process
2.2.3.5	Rewrite Rule Failure
2.2.3.6	Syntax Checks After Rewriting
2.2.3.7	Handling of Domain Literals
2.2.4	Patterns and Tags
2.2.4.1	A Rule to Match Percent Hacks
2.2.4.2	A Rule to Match Bang-style (UUCP) Addresses
2.2.4.3	A Rule to Match Any Address
2.2.4.4	Tagged Rewrite Rule Sets
2.2.5	Templates
2.2.5.1	Ordinary Rewriting Templates, A@B or A%B@C
2.2.5.2	Repeated Rewritings Template, A%B
2.2.5.3	Specified Route Rewriting Templates, A@B@C or A@B@C@D
2.2.5.4	Case Sensitivity in Rewrite Rule Templates
2.2.6	Template Substitutions and Rewrite Rule Control Sequences
2.2.6.1	Username and Subaddress Substitution, $U, $0U, $1U
2.2.6.2	Host/domain and IP Literal Substitutions, $D, $H, $nD, $nH, $L
2.2.6.3	Literal Character Substitutions, $$, $%, $@
2.2.6.4	LDAP Query URL Substitutions, $]...[
2.2.6.5	General Database Substitutions, $(...)
2.2.6.6	Apply Specified Mapping, ${...}
2.2.6.7	Customer-supplied Routine Substitutions, $[...]
2.2.6.8	Single Field Substitutions, $&, $!, $*, $#
2.2.6.9	Unique String Substitutions
2.2.6.10	Source Channel-specific Rewrite Rules, $M, $N
2.2.6.11	Destination Channel-specific Rewrite Rules, $C, $Q
2.2.6.12	Direction and Location-specific Rewrites, $B, $E, $F, $R
2.2.6.13	Host Location-specific Rewrites, $A, $P, $S, $X
2.2.6.14	Changing the Current Tag Value, $T
2.2.6.15	Controlling Error Messages Associated with Rewriting, $?
2.2.7	Rewrite Rules Example
2.2.8	Testing Domain Rewriting Rules
2.2.9	Handling Large Numbers of Rewrite Rules
2.2.10	Using Rewrites to Illegal Addresses
2.2.11	Other Address Manipulations
2.3	The Channel/host Table
2.3.1	Overview
2.3.2	Channel Definitions: the Channel/host Table
2.3.2.1	First Line: Channel Name and Keywords
2.3.2.2	Second Line: System Name and Local Host Alias
2.3.2.3	Additional Lines: Systems Reachable via the Channel
2.3.3	Envelope vs. Header Addresses: Channel-level Name Translations
2.3.4	Channel Table Keywords
2.3.4.1	Address Types and Conventions (822, 733, uucp, header_822, header_733, header_uucp)
2.3.4.2	Address Interpretation (bangoverpercent, nobangoverpercent)
2.3.4.3	Routing Information in Addresses (exproute, noexproute, improute, noimproute)
2.3.4.4	Short Circuiting Rewriting of Routing Addresses (routelocal)
2.3.4.5	Address Rewriting Upon Message Dequeue (connectalias, connectcanonical)
2.3.4.6	Channel-specific Rewrite Rules (rules, norules)
2.3.4.7	Channel Directionality (master, slave, bidirectional)
2.3.4.8	Channel Operation Type (submit)
2.3.4.9	Channel Service Periodicity (immediate, immnonurgent, immnormal, immurgent, periodic, period)
2.3.4.10	Message Size Affecting Priority (urgentblocklimit, normalblocklimit, nonurgentblocklimit)
2.3.4.11	Priority of Messages to be Handled by Periodic Jobs (minperiodicnonurgent, minperiodicnormal, minperiodicurgent, maxperiodicnonurgent, maxperiodicnormal, maxperiodicurgent)
2.3.4.12	Immediate Delivery Job Service Actions (serviceall, noserviceall)
2.3.4.13	Channel Connection Information Caching (cacheeverything, cachesuccesses, cachefailures, nocache)
2.3.4.14	Number of Addresses or Message Files to Handle per Service Job or File (addrsperjob, filesperjob, maxjobs)
2.3.4.15	Multiple Addresses (multiple, addrsperfile, single, single_sys)
2.3.4.16	Expansion of Multiple Addresses (expandlimit, expandchannel, holdlimit)
2.3.4.17	Multiple Subdirectories (subdirs)
2.3.4.18	Service Job Queue Usage and Job Deferral (queue, nonurgentqueue, normalqueue, urgentqueue, after)
2.3.4.19	Deferred Delivery Dates (deferred, nodeferred)
2.3.4.20	Undeliverable Message Notification Times (notices, nonurgentnotices, normalnotices, urgentnotices)
2.3.4.21	Returned Messages (sendpost, nosendpost, copysendpost, errsendpost)
2.3.4.22	Warning Messages (warnpost, nowarnpost, copywarnpost, errwarnpost)
2.3.4.23	Postmaster Returned Message Content (postheadonly, postheadbody)
2.3.4.24	Delivery Receipt Request Style (reportboth, reportheader, reportnotary, reportsuppress)
2.3.4.25	Passing Read Receipt Requests to the VMS MAIL Mailbox (OpenVMS) (readreceiptmail)
2.3.4.26	Gold-Mail Compatible Read Receipts (OpenVMS) (goldmail, nogoldmail)
2.3.4.27	Including Altered Addresses in Notification Messages (includefinal, suppressfinal)
2.3.4.28	Protocol Streaming (streaming)
2.3.4.29	Triggering New Threads in Multi-threaded SMTP Channel (threaddepth)
2.3.4.30	PMDF Channel Queue Directories' Locations (logicaldisk, nologicaldisk)
2.3.4.31	Channel Protocol Selection (smtp, nosmtp)
2.3.4.32	SMTP EHLO Command (ehlo, checkehlo, noehlo)
2.3.4.33	Sending an SMTP ETRN Command (sendetrn, nosendetrn)
2.3.4.34	Receiving an SMTP ETRN Command (allowetrn, blocketrn, disableetrn, domainetrn, silentetrn)
2.3.4.35	Sending an SMTP VRFY Command (domainvrfy, localvrfy, novrfy)
2.3.4.36	Responding to SMTP VRFY Commands (vrfyallow, vrfydefault, vrfyhide)
2.3.4.37	TCP/IP Port Number and Interface Address (interfaceaddress, port)
2.3.4.38	TCP/IP Nameserver and MX Record Support (mx, nomx, nodns, defaultmx, randommx, nonrandommx, nameservers, defaultnameservers)
2.3.4.39	Specify a Last Resort Host (lastresort)
2.3.4.40	Reverse DNS lookups on incoming SMTP connections ( identnone, identnonelimited, identnonenumeric, identnonesymbolic, forwardchecknone, forwardchecktag, forwardcheckdelete)
2.3.4.41	Verify that the domain on the MAIL FROM: line is in the DNS (mailfromdnsverify, nomailfromdnsverify)
2.3.4.42	Select an alternate channel for incoming mail (switchchannel, allowswitchchannel, noswitchchannel)
2.3.4.43	SMTP authentication and SASL ( client_auth, maysasl, maysaslclient, maysaslserver, mustsasl, mustsaslclient, mustsaslserver, nosasl, nosaslclient, nosaslserver, saslswitchchannel, nosaslswitchchannel )
2.3.4.44	Use authenticated address from SMTP AUTH in header (authrewrite)
2.3.4.45	Transport Layer Security (maytls, maytlsclient, maytlsserver, musttls, musttlsclient, musttlsserver, notls, notlsclient, notlsserver, tlsswitchchannel)
2.3.4.46	MS Exchange gateway channels (msexchange, nomsexchange)
2.3.4.47	Host name to use when correcting incomplete addresses (remotehost, noremotehost, defaulthost, nodefaulthost)
2.3.4.48	Normalizing messages that lack any recipient headers (missingrecipientpolicy)
2.3.4.49	Strip illegal blank recipient headers (dropblank)
2.3.4.50	Eight bit capability (eightbit, eightnegotiate, eightstrict, sevenbit)
2.3.4.51	Automatic character set labelling (charset7, charset8, charsetesc)
2.3.4.52	Restrictions on message line lengths (linelength)
2.3.4.53	Delivering foreign format messages to VMS MAIL (OpenVMS) (foreign, noforeign)
2.3.4.54	Conversion of application/octet-stream material (convert_octet_stream, noconvert_octet_stream)
2.3.4.55	Channel-specific use of the reverse database (reverse, noreverse)
2.3.4.56	Inner header rewriting (noinner, inner)
2.3.4.57	Restricted mailbox encoding (restricted, unrestricted)
2.3.4.58	Additional message header lines in VMS MAIL (headerbottom, headerinc, headeromit)
2.3.4.59	Trimming message header lines (headertrim, noheadertrim, headerread, noheaderread, innertrim, noinnertrim)
2.3.4.60	Encoding header (ignoreencoding, ignoremessageencoding, ignoremultipartencoding, interpretencoding, interpretmessageencoding, interpretmultipartencoding)
2.3.4.61	Generation of X-Envelope-to: header lines (x_env_to, nox_env_to)
2.3.4.62	Envelope to address in Received: header (receivedfor, noreceivedfor, receivedfrom, noreceivedfrom)
2.3.4.63	Postmaster address (aliaspostmaster, returnaddress, noreturnpersonal, returnpersonal, noreturnpersonal)
2.3.4.64	Blank envelope return addresses (returnenvelope)
2.3.4.65	Mapping Reply-to: header (usereplyto)
2.3.4.66	Mapping Resent- headers when gatewaying to non RFC 822 environments (useresent)
2.3.4.67	Comments in address message headers (commentinc, commentomit, commentstrip, commenttotal, sourcecommentinc, sourcecommentomit, sourcecommentstrip, sourcecommenttotal)
2.3.4.68	Personal names in address message headers (personalinc, personalomit, personalstrip, sourcepersonalinc, sourcepersonalomit, sourcepersonalstrip)
2.3.4.69	Alias file and alias database probes (aliaslocal)
2.3.4.70	Validating local part of address (validatelocalnone, validatelocalsystem, validatelocalmsgstore)
2.3.4.71	Subaddresses (subaddressexact, subaddressrelaxed, subaddresswild)
2.3.4.72	Two or four digit date conversion (datefour, datetwo)
2.3.4.73	Day of week in date specifications (dayofweek, nodayofweek)
2.3.4.74	Automatic splitting of long header lines (maxheaderaddrs, maxheaderchars)
2.3.4.75	Header alignment and folding (headerlabelalign, headerlinelength)
2.3.4.76	Automatic defragmentation of message/partial messages (defragment, nodefragment)
2.3.4.77	Automatic fragmentation of large messages (maxblocks, maxlines)
2.3.4.78	Absolute message size limits (blocklimit, noblocklimit, linelimit, nolinelimit, sourceblocklimit)
2.3.4.79	Specify maximum length header that PMDF will rewrite (maxprocchars)
2.3.4.80	Mail delivery to over quota users (exquota, noexquota, holdexquota)
2.3.4.81	Gateway daemons (daemon)
2.3.4.82	Processing account or Message Router mailbox (user)
2.3.4.83	Multiple gateways on a single channel (multigate, nomultigate)
2.3.4.84	Grey Book address formatting (grey, nogrey)
2.3.4.85	Message logging (logging)
2.3.4.86	Debugging channel master and slave programs (master_debug, nomaster_debug, slave_debug, noslave_debug)
2.3.4.87	Filter file location (filter, nofilter, channelfilter, nochannelfilter, destinationfilter, nodestinationfilter, sourcefilter, nosourcefilter, fileinto, nofileinto)
2.3.4.88	Channel description field (description)
2.3.4.89	Sensitivity checking (sensitivitynormal, sensitivitypersonal, sensitivityprivate, sensitivitycompanyconfidential)
2.3.4.90	Access rights and privileges (network)
2.3.4.91	Directory Channel Lookup Mode (inline, noinline)
2.3.4.92	Detecting Mail Loops (loopcheck)
2.3.4.93	Accepting All Addresses (acceptalladdresses, acceptvalidaddresses)
2.3.4.94	Relaxed Header Termination (relaxheadertermination, norelaxheadertermination)
2.3.4.95	Handle addresses from VMS MAIL (OpenVMS) (addlineaddrs, noaddlineaddrs)
2.3.5	Using defaults and nodefaults channel blocks to simplify configurations
2.3.6	Available channels
2.3.7	Header option files
2.3.7.1	Header option file location
2.3.7.2	Header option file format
2.4	Some example configuration files
2.4.1	A simple configuration file
2.4.2	Routing non-local mail to a central mail hub
2.4.3	Basic configuration for a system on the Internet
2.4.4	Handling systems on a local DECnet (OpenVMS)