
 This script translates Post Road Mailer Address Books into MR/2 ICE
 addresses and groups.  It was written by and is copyrighted by Tom
 Kusterer and it is freeware.  Feel free to distribute the code to 
 anyone and use or abuse it.  Just give credit where credit is due...

********************************************************
NOTE THIS DISCLAIMER (much as I hate to, I have to say this)
********************************************************
THIS SCRIPT WAS CREATED AS A SERVICE TO THE OS/2 USER COMMUNITY
IT IS SUPPLIED "AS IS", AND WITHOUT ANY WARRANTIES WHATSOEVER.
I DO NOT ACCEPT ANY RESPONSIBILITY FOR ANY LOSS OR DAMAGE, PHYSICAL,
FINANCIAL, MENTAL, OR OTHERWISE, THAT RESULTS FROM THE USE OF
THIS SCRIPT.  Gad I hate saying that.
********************************************************

 So that one can understand what I did to perform the conversion, I'll
 explain a few things as I understand them...

 The Post Road Mailer (tm) holds both e-mail addresses and groups in
 address books.  Each address book is a separate file with the extension
 ADR.  All of the files are contained in the Post Road Mailer directory.
 Each address book entry can contain quite a bit of information:
 First name, last name, organization, up to 5 e-mail addresses, two
 telephone numbers, a fax number, and a note.

 The biggest hurdle in creating this converter was the binary format
 of the Post Road Mailer address books.  Needless to say, a hex-editor
 came in very, very useful...

                     *      *      *

 MR/2 ICE, on the other hand, holds its e-mail addresses in a single file
 with the extension ADR.  You can define other files to be used but that
 doesn't concern this conversion.  In addition, MR/2 ICE holds its group
 definitions in a separate file with the extension GRP.  Both of these
 files are in the MR/2 ICE directory.  And, thankfully, both of these
 files are basically ASCII files.

 Each address entry contains a full name, e-mail address, alias and a
 note.

                     *      *      *

 Now, how I decided to do this conversion.  For e-mail address entries:

 1).  The first name and last name are combined and used.
 2).  Each e-mail address for a given PRM address book entry is given
      a separate entry in the MR/2 address file.
 3).  The alias used for each e-mail address is either the nickname in
      the PRM address file entry for that e-mail address, or, if a nick-
      name doesn't exist.  The last name is used.  If a duplicate alias
      exists, I append a number to new alias.
 4).  Finally, the note for the MR/2 ICE address consists of the PRM
      note, organization, telephone numbers and fax number.  This note
      is attached to each e-mail address entry.

 For groups:

 1).  Every group from each PRM address book is placed in the MR/2 ICE
      group file.  Groups aliases are checked for duplication.
 2).  In addition, for each PRM address book, I allow the user to
      optionally create a MR/2 ICE group consisting of all of the
      addresses in that address book.  The alias for that group is the
      file name minus the extension of that address book.

      An example would probably be helpful.  If you have two PRM address
      books, each containing 5 e-mail addresses and 2 groups.  Say the
      first file is called smeg.adr (with the description "friends") and
      the second is called head.adr (with the description "enemas").

      This converter would add all 10 e-mail addresses to the MR/2 ICE
      address list.  It would add all 4 groups to the MR/2 ICE group
      file.  In addition, if the user says 'yes' to the add address books
      as groups question, it would add a group with the alias 'smeg'
      containing the 5 e-mail addresses and it would add a group with the
      alias 'head' with the other 5 e-mail addresses

      If you don't like these additional groups, then it's easy enough to
      to any one you don't want.

-------------------------------------------------------------------------

Here are the step you should take.

1).  Make backup copies of the MR2I.ADR and MR2I.GRP files in the MR2I
     directory.

2).  Copy the MR2I.ADR and MR2I.GRP files from the MR2I directory to
     a temporary location.

3).  Run PRM2MR2.CMD.  It will ask for the Post Road Mailer location.
     Input the complete location (e.g. D:\PostRoad).  It will ask for
     the MR/2 location.  Input the temporary location of the MR/2 files
     you created in step 2.  Answer whether or not you want to create
     a group for each address book.

4).  Let the script run.

5).  The MR2I.ADR and MR2I.GRP files in the temporary location should
     now be updated.  Since they're ASCII you can open them and look.
     Copy them into the MR2I directory.

6).  Start MR/2 ICE and see if your addresses and groups are correct.
     If they're not, restore the backups (aren't you glad you made them).

------------------------------------------------------------------------

If you have any problems.  E-mail me at kustetl1@aplcomm.jhuapl.edu
I try to work out solutions...

