PMDF System Manager's Guide


Begin Index

Contents (summary)
Preface Preface
  Part 1
Chapter 1 Structure and Overview
Chapter 2 The Configuration File: Domain Rewrite Rules & the Channel/Host Table
Chapter 3 Aliases, Forwarding, and Centralized Naming
Chapter 4 Mailing Lists and MAILSERV
Chapter 5 The Mapping File
Chapter 6 Character Set Conversions and Message Reformatting
Chapter 7 The PMDF Option File
Chapter 8 Maintaining the Configuration
Chapter 9 The PMDF Process Symbiont (OpenVMS)
Chapter 10 The PMDF Job Controller (UNIX and Windows)
Chapter 11 The PMDF Multithreaded Service Dispatcher
Chapter 12 The PMDF HTTP Server
Chapter 13 POP and IMAP Mailbox Servers
  Part 2
Chapter 14 Connection Authentication, SASL, and Password Management
Chapter 15 PMDF-TLS: Transport Layer Security
Chapter 16 Mail Filtering and Access Control
Chapter 17 The UNIX Local Channel
Chapter 18 The Local, DECnet MAIL, and General MAIL_ Channels (OpenVMS)
Chapter 19 The PMDF User Interface on OpenVMS
Chapter 20 DECnet Channels (OpenVMS and Tru64 UNIX)
Chapter 21 TCP/IP Channels
Chapter 22 Message Manipulation Channels
Chapter 23 BSMTP Channels: MTA to MTA Tunnelling
Chapter 24 PhoneNet Channels (OpenVMS and UNIX)
Chapter 25 UUCP Channels (OpenVMS and UNIX)
Chapter 26 Other Channels
Chapter 27 The PMDF Queue to E-mail Symbiont (OpenVMS)
Chapter 28 E-mail Firewalls and Other E-mail Security Considerations
  Part 3
Chapter 29 Utilities on OpenVMS
Chapter 30 Utilities on UNIX
Chapter 31 Monitoring
Chapter 32 Performance Tuning
Chapter 33 Maintenance and Troubleshooting on OpenVMS
Chapter 34 Maintenance and Troubleshooting on UNIX
  Part 4
  Glossary
  Index
  Figures
  Examples
  Tables


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             Multiple gateways on a single channel (multigate, nomultigate)
             2.3.4.83             Grey Book address formatting (grey, nogrey)
             2.3.4.84             Message logging (logging)
             2.3.4.85             Debugging channel master and slave programs (master_debug, nomaster_debug, slave_debug, noslave_debug)
             2.3.4.86             Filter file location (filter, nofilter, channelfilter, nochannelfilter, destinationfilter, nodestinationfilter, sourcefilter, nosourcefilter, fileinto, nofileinto)
             2.3.4.87             Channel description field (description)
             2.3.4.88             Sensitivity checking (sensitivitynormal, sensitivitypersonal, sensitivityprivate, sensitivitycompanyconfidential)
             2.3.4.89             Access rights and privileges (network)
             2.3.4.90             Directory Channel Lookup Mode (inline, noinline)
             2.3.4.91             Detecting Mail Loops (loopcheck)
             2.3.4.92             Accepting All Addresses (acceptalladdresses, acceptvalidaddresses)
             2.3.4.93             Relaxed Header Termination (relaxheadertermination, norelaxheadertermination)
             2.3.4.94             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)


Previous Next Contents Index