home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / prmtopmm.zip / AConvert.TXT < prev    next >
Text File  |  1996-05-06  |  7KB  |  149 lines
  1.  
  2. *************************************************************************
  3. *     NOTE THIS DISCLAIMER (much as I hate to, I have to say this)      *
  4. *************************************************************************
  5. *  THIS UTILITY WAS CREATED AS A SERVICE TO THE OS/2 USER COMMUNITY.    *
  6. *  IT IS SUPPLIED "AS IS", AND WITHOUT ANY WARRANTIES WHATSOEVER.       *
  7. *  I DO NOT ACCEPT ANY RESPONSIBILITY FOR ANY LOSS OR DAMAGE, PHYSICAL, *
  8. *  FINANCIAL, MENTAL, OR OTHERWISE, THAT RESULTS FROM THE USE OF        *
  9. *  THIS SCRIPT.  Smegging lawyers... I hate saying that.                *
  10. *************************************************************************
  11.  
  12. Version 1.0  First Release
  13.  
  14. *************************************************************************
  15.  
  16.  
  17. 1.0  Introduction                      **********************************
  18.  
  19. The utility in the package will:
  20.  
  21.   1) translate Post Road Mailer Address Books into PMMail v1.5 addresses
  22.      and books.
  23.  
  24.  
  25. This utility was written by and is copyrighted by Tom Kusterer and
  26. it is freeware.  Feel free to distribute the utility to anyone and use
  27. or abuse it.  Just give credit where credit is due...
  28.  
  29. -------------------------------------------------------------------------
  30.  
  31. 2.0  Address Book Conversion Description  *******************************
  32.  
  33. So that one can understand what I did to perform the address book
  34. conversion, I'll explain a few things as I understand them...
  35.  
  36. The Post Road Mailer (tm) holds both e-mail addresses and groups in
  37. address books.  Each address book is a separate file with the extension
  38. ADR.  All of the files are contained in the Post Road Mailer directory.
  39. Each address book entry can contain quite a bit of information:
  40. First name, last name, organization, up to 5 e-mail addresses, two
  41. telephone numbers, a fax number, and a note.
  42.  
  43.  !!!!!!!!    NOTE:   PRM Address Group Bug    !!!!!!!!!!!!!!!!!!!!!!!!!!
  44.  !                                                                     !
  45.  !  Summary:  e-mail address(es) in a group are not updated when you   !
  46.  !            change the e-mail address of the corresponding address   !
  47.  !            book.                                                    !
  48.  !                                                                     !
  49.  !  Example:  You create a group consisting of                         !
  50.  !   Smeg  rimmer@reddwarf.jmc.com   and                               !
  51.  !   Head  kryton@reddwarf.jmc.com                                     !
  52.  !                                                                     !
  53.  !  from your JMC address book.  If you go to the address book and     !
  54.  !  change Smeg's e-mail to arnold@reddwarf.jmc.com the group will     !
  55.  !  still say rimmer@reddwarf.jmc.com.                                 !
  56.  !                                                                     !
  57.  !!!!!!!!  END NOTE:   PRM Address Group Bug  !!!!!!!!!!!!!!!!!!!!!!!!!!
  58.  
  59. This bug causes problems when resolving group entries back to address
  60. book entries.  After converting, you might have book(s) that are missing
  61. one or more members.  Sooooo, if you have some groups that might have 
  62. screwed up address.  Recreate the group before converting to PMMail.
  63.  
  64. The biggest hurdle in creating this converter was the binary format
  65. of the Post Road Mailer address books.  Needless to say, a hex-editor
  66. came in very, very useful...
  67.  
  68.                      *      *      *
  69.  
  70. PMMail holds its e-mail addresses and books in two files in the Tools 
  71. directory.  The address file is ADDR.DB.  The book file is BOOKS.DB
  72. Both of the files are ASCII...
  73.  
  74. Each address entry contains a a whole slew of information;  e-mail
  75. address, full name, alias, personal info, notes, and references to
  76. which book(s) this entry belongs.
  77.  
  78.                      *      *      *
  79.  
  80. Now, how I decided to do this conversion.  For e-mail address entries:
  81.  
  82. 1).  The first name and last name are combined and used as the full
  83.      name.
  84. 2).  Each e-mail address for a given PRM address book entry is given
  85.      a separate entry in the PMMail address file.
  86. 3).  The alias used for each e-mail address is either the nickname in
  87.      the PRM address file entry for that e-mail address, or, if a nick-
  88.      name doesn't exist, the last name is used.
  89. 4).  The personal information from PRM was transferred as follows:
  90.      organization -> company
  91.      phone #1 -> business phone
  92.      phone #2 -> home phone
  93.      fax -> home  & business fax
  94. 5).  The PRM note was directly moved to the PMM note.
  95. 6).  Finally, none of the PRM address are added to the RMB menu.
  96.  
  97. For groups/books:
  98.  
  99. 1).  Each PRM address book will become a PMMail address book.
  100. 2).  Every group from each PRM address book will become a seperate 
  101.      PMMail address book.
  102.  
  103.  
  104.  
  105. -------------------------------------------------------------------------
  106.  
  107. 3.0  Instructions                      **********************************
  108.  
  109.  
  110. Here are the steps you should take:
  111.  
  112. 1).  Make sure neither PMMail nor PRM are running.
  113.  
  114. 2).  Make backup copies of the ADDR.DB and BOOKS.DB files in the 
  115.      <SouthSIde Software>\Tools directory.  
  116.      (i.e.   copy *.DB *.DB0 will do it...)
  117.  
  118. 3).  Run PRMtoPMM.  It will ask for the Post Road Mailer location.
  119.      Input the path without the last '\'.  Next, it will then ask 
  120.      for the SouthSide Software directory.  Input the path to the 
  121.      directory containing both the PMMAIL and TOOLS directories.  
  122.      (i.e. d:\southsde)
  123.  
  124. 4).  Let the utility run.
  125.  
  126. 5).  Start PMMail v1.5 and see if your addresses and books are correct.
  127.      If they're not, restore the backups (aren't you glad you made them).
  128.  
  129. -------------------------------------------------------------------------
  130.  
  131. Oh yes, if you find that this program saved you a great deal of time AND
  132. you are incredibly wealthy and in an insanely generous mood... send me
  133. a $4000.  I have two kids I need to put through college...  If you're
  134. just wealthy and only feeling moderately generous, send me $100.
  135.  
  136. Otherwise, take a second to send me a post card.  My address is:
  137.  
  138. Tom Kusterer
  139. 7935 Brightmeadow Ct.
  140. Ellicott City, MD  21043  USA
  141.  
  142. I'd like to see where this program goes.  
  143.  
  144. -------------------------------------------------------------------------  
  145.  
  146. Compliments, complaints, and anything else... or, if, God forbid,
  147. you have any problems.  E-mail me at kustetl1@aplcomm.jhuapl.edu
  148. I'll try to work out solutions...
  149.