************************
 INSTALLATION ON OPENVMS
************************

Download the kit removedisplay.zip.

Select a directory (or create it) where to unzip the kit.

set default to such directory.

For example, if the directory that you have choosed is device:[myprograms] 
you set such directory as default directory:
$ set default device:[myprograms]

unzip the kit

$ unzip <path-of-the-kit>removedisplay.zip

The following subdir will be created:

[.REMOVE_DISPLAY]
[.REMOVE_DISPLAY.EXE]
[.REMOVE_DISPLAY.OBJ]

to build the executable change the default diretory to
[.REMOVE_DISPLAY]

For example:
$ set device:[myprograms.REMOVE_DISPLAY]

To compile and/or link, from this default directory, run the script BUILD.COM 
with one of the following P1 value:

 ALL      to compile and link
 COMPILE  only to compile
 LINK     only to link
 SCRIPT   only to create the PMDF master script

The directory [.REMOVE_DISPLAY.EXE] contains the channel executable that must
be accessibile from the PMDF.

copy the PMDF master script REMDISPLAY_CUSTOM_MASTER.COM from the directory
[.REMOVE_DISPLAY] to the directory PMDF_COM

Example:
$ copy REMDISPLAY_CUSTOM_MASTER.COM pmdf_com:*.*;

**********************
 INSTALLATION ON LINUX
**********************

Download and unzip the remdisplay.zip file, change directory to
remove_display, run make, and copy the resulting executable to
/pmdf/bin:

  $ unzip remdisplay
  $ cd remove_display
  $ make
  $ cp remove_display_channel /pmdf/bin/


***************
 CONFIGURATION
***************

Add the channel remdisplay to the PMDF configuration.
In the channel section of the PMDF.CNF file, add the following lines:

remdisplay
remdisplay-daemon

On Linux, the remdisplay channel must also be defined for the PMDF
Job Controller. Edit the file /pmdf/table/job_controller.cnf_site
and add these lines:

[CHANNEL=remdisplay]
master_command=/pmdf/bin/remove_display_channel

remdisplay channel could run immediately before the email is delivered to 
the mailbox.
To do so, you should add the following entries to the CONVERSIONS mapping table
(in the file pmdf_table:mappings.)
It is just an example, most depend on your PMDF configuration.

  IN-CHAN=*;OUT-CHAN=msgstore;CONVERT channel=remdisplay,Yes
  IN-CHAN=*;OUT-CHAN=l;CONVERT channel=remdisplay,Yes

Don't forget to rebuild your PMDF configuration, if you are using the compiled
configuration.

To debug the channel, create the file
pmdf_table:remdisplay_option.
and insert the following line into the file:
debug = 1



***************
 HOW IT WORKS
***************

The channel remove the display name from the RFC2822.from header line.
The original RFC2822.from is copied to the header line x-original-from.

For example:

the following header from
  From: DHL customer service <hiss@somedomain.com>
will be rewritten as:
  From: hiss@somedomain.com
and the following header line will be added to the message header:
  x-original-from: DHL customer service <hiss@somedomain.com>

