Last Update:            29-AUG-2007
Operating System:       OpenVMS
Component:              PMDF Shared Library
Base Level Required:    PMDF V6.3
Other Requirements:	none

Platform                Subdirectory            File(s) to download
--------                ------------            --------------------
OpenVMS Alpha           [.VMS.ALPHA_EXE]        PMDFSHR.EXE
OpenVMS I64             [.VMS.IA64_EXE]         PMDFSHR.EXE
OpenVMS VAX             [.VMS.VAX_EXE]          PMDFSHR.EXE


General info
------------
     You will need to have a License PAK with a release date after the date of
  PMDFSHR.EXE or libpmdf.so to run PMDF.  Note that this may apply to other
  images as well.

     Patches may be obtained from the anonymous FTP account on
  ftp.pmdf.process.com.  Use FTP to connect to the host ftp.pmdf.process.com
  and login as the user anonymous.  Use your e-mail address as the login 
  password.

     Move to the pmdf_63_patches subdirectory:

        ftp> cd pmdf_63_patches

     Patches will be located in platform-specific sub-trees, as follows:

        Platform        Subdirectory
        --------        ------------
        OpenVMS         vms

     When FTPing images, be sure to FTP them as binary.  Before retrieving
  such an image with the GET command, be sure to put your FTP into binary
  mode with a command such as TYPE IMAGE or TYPE BINARY.


Change history
---------------
29-Aug-2007 (ident V6.3-x13)
  Fixed a regression on pre-V7 VMS Alpha and Vax versions.

1-JUN-2007 (ident V6.3-x11)
  Changed the mailing list tag separator from a space to a vertical bar,
  allowing multi-word tags. (D/E 10374)

1-JUN-2007 (ident V6.3-x11)
  Addressed a problem with delivering messages to msgstore accounts by retrying
  to gain access to the required files multiple times if they are locked.
  (d/e 10372)

1-JUN-2007 (ident V6.3-x11)
  Fixed a problem with messages going through the PMAS channel being counted
  twice. (D/E 9272)

1-JUN-2007 (ident V6.3-x11)
  Added support for chained TLS certificates. Requires TLSSHR.EXE V6.3-X11.
  (D/E 8704)

21-JUL-2006 (ident V6.3-x3)
  Fixed a problem with pmdf cnbuild detecting when pmdf.cnf exceeds the
  channel table size. (D/E 10347)

21-JUL-2006 (ident V6.3-x3)
  The popstore/msgstore option REJECT_OVER_QUOTA now works and applies
  to both popstore and msgstore accounts. It is applied by the operation
  of the validatelocalmsgstore channel keyword. (D/E 10314)

21-JUL-2006 (ident V6.3-x3)
  Added code to be able to handle disconnects during an SMTP session more
  gracefully, returning non-delivery notices for addresses that are known
  to be bad before PMDF retries to send the message later. (D/E 10278)

21-JUL-2006 (ident V6.3-x3)
  Fixed a problem with using the Sieve filter file redirect command where
  the ORIG_SEND_ACCESS mapping table anti-relay entries could trigger
  incorrectly. (D/E 9903)

21-JUL-2006 (ident V6.3-x3)
  Fixed a problem with the mailbox filters web interface in creating the
  filter file when popstore is in use with USERNAME_STYLE=2. [VMS only]
  (D/E 9711)

21-JUL-2006 (ident V6.3-x3)
  The validatelocalmsgstore channel keyword (which is the default for the
  msgstore channel) now does the following during the SMTP dialogue:
  checks to see if the username is listed in the msgstore forward database,
  checks the msgstore/popstore account for the DISMAIL flag, implements the
  REJECT_OVER_QUOTA option.
  (D/E 8988)


Installation
------------
OpenVMS

	Before installing a new PMDFSHR.EXE, issue the following command:
 
		$ PMDF SHUTDOWN DISPATCHER
 
	Failure to issue the above command could result in the current
	processes not recognizing commands (i.e., RESTART and SHUTDOWN) with
	the new PMDFSHR.EXE in place.

	PMDFSHR.EXE needs to be copied to the PMDF_EXE: directory and then
	installed with the command:

		$ INSTALL REPLACE PMDF_SHARE_LIBRARY

	on all members of the OpenVMS cluster running out of the affected PMDF
	directory tree.

	In some cases new versions of PMDFSHR.EXE may alter the format of
	compiled configurations. When this happens recompilation and
	reinstallation are also necessary:

		$ PMDF CNBUILD
		$ INSTALL REPLACE PMDF_CONFIG_DATA

	The first command need only be done once for each hardware (VAX, Alpha,
	and I64); the latter must be done on every cluster member that runs
	PMDF. Failure to recompile and install the configuration after
	installing new versions of PMDFSHR.EXE may lead to "compiled
	configuration version mismatch" errors.

	Next, be sure to start the dispatcher by issuing the following command:
 
		$ PMDF STARTUP DISPATCHER

        Sites running in PMDF-MR TS Replacement mode (mrif_* channels) should
        remember to stop and then start their allin1 senders/fetchers processes
        after putting the new image (and recompiling the configuration as
        needed)  into place.