What it is
----------
Some e-mail programs insert the full path name of a file into an e-mail
when attaching a file to the e-mail message.  This is incorrect, and will
cause PMMail to be unable to detach the attachment.

This program is designed to examine an e-mail message and remove the
complete path from the attachment name, leaving just the file name.

The Attach program is supplied as both OS/2 and Windows executables.

     OS       Executable Name
     --       ---------------
     OS/2     oAttach.exe
     Windows  wAttach.exe

__________________________________________________________________________

Installation
------------
Copy the appropriate executable to your PMMail directory (where the
PMMail.exe/PMMailW.exe file is)

__________________________________________________________________________

Usage
-----
Depending upon your needs there are two methods of usage, either via a
"Message Receive Hook" which will get called for every message you
receive, or a "Message Filter" which will call the program for those
messages the filter determines needs to be scanned.

There are two sets of instructions, the first set for Windows-95/NT,
and the second set for OS/2.  While the instructions are essentially
the same, the terminology has changed between the two programs.

__________________________________________________________________________

Windows-95/NT Instructions
--------------------------

Message Receive Hook
--------------------
This method will call the Attach program once for every message you
receive.  If you have multiple accounts you will need to do these
steps for each account:

1. Open the Properties for your e-mail account.
2. Select the "Hooks" tab (last tab on the right, it may be hidden)
3. Find the entry labeled "Message receive hook".  Click on the
   box to put a check mark in it.
4. In the "Program Location" field type the name of the executable you
   are using (wAttach.exe)
5. Click on the OK box at the bottom.


Message Filter
--------------
This method will create a message filter which will call the Attach
program once for each message that the filter determines needs it.
Generally this should be used only if you know exactly where the
attachments come from (ie: Compuserve) and you don't want to call
the Attach program for every message that arrives.

1. Open the Properties for your e-mail account.
2. Select the "Filters" tab.
3. Click on the "New" button on the right.
4. In the "Description" field type a name for this, for
   example, "Attach Filter".
5. In the "Search" field select the field that will contain the
   data which will identify the message as needing to be scanned,
   for example: "<Header>" if the text will be somewhere in the header.
6. In the "For" field put the text that will uniquely identify
   a message as needing to be scanned, for example, "Compuserve".
7. Under the "Type" box click on "Incoming" to enable this filter
   for incoming messages.
8. Under "Actions" select "User Hook (background)"
9. After you select the "User Hook" entry a new entry field will
   appear to the right.  Enter the name of the executable you are
   using (wAttach.exe).
10. Click the OK button at the bottom to save the new filter.
11. Click the OK button at the bottom to close the "Properties" window.

__________________________________________________________________________

OS/2 Instructions
-----------------

Message Receive Exit
--------------------
This method will call the Attach program once for every message you
receive.  If you have multiple accounts you will need to do these
steps for each account:

1. Open the Settings for your e-mail account.
2. Select the "REXX" tab (second tab from the right, it may be hidden)
3. Find the entry labeled "Message Receive Exit".  Click on the
   box to put a check mark in it.
4. In the "Script to run" field type the name of the executable you
   are using (oAttach.exe).
5. Click on the OK box at the bottom.


Message Filter
--------------
This method will create a message filter which will call the Attach
program once for each message that the filter determines needs it.
Generally this should be used only if you know exactly where the
attachments come from (ie: Compuserve) and you don't want to call
the Attach program for every message that arrives.

1. Open the Settings for your e-mail account.
2. Select the "Filters" tab.
3. Click on the "New" button on the right.
4. In the "Description" field type a name for this, for
   example, "Attach Filter".
5. In the "Search" field select the field that will contain the
   data which will identify the message as needing to be scanned,
   for example: "<Header>" if the text will be somewhere in the header.
6. In the "For" field put the text that will uniquely identify
   a message as needing to be scanned, for example, "Compuserve".
7. Under the "Type" box click on "Incoming" to enable this filter
   for incoming messages.
8. Under "Actions" select "Rexx Exit (background)"
9. After you select the "Rexx Exit" entry a new entry field will
   appear to the right.  Enter the name of the executable you are
	using (oAttach.exe).
10. Click the OK button at the bottom to save the new filter.
11. Click the OK button at the bottom to close the "Settings" window.

