home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / -seriously_amiga- / comms / other / aemail151 / files.lha / ARexx.lha / Addtogrp.readme < prev    next >
Text File  |  1998-03-21  |  3KB  |  71 lines
  1. Name: Addtogrp.aem
  2.  
  3. TO BE USED BY REGISTERED USER'S ONLY
  4.  
  5. This ARexx script is used to add To:  and cc:  names from a received
  6. message to a group entry in the Address Book.  This is particularly useful
  7. when there are multiple to:  and cc:  addresses.
  8.  
  9.                              HOW TO IMPLEMENT
  10.                              ----------------
  11.  
  12. This script is probably best placed in your REXX: directory.  If you wish
  13. to modify this script please note the following items:
  14.  
  15.     "name1" is used as a variable instead of "name".  If "name" were used
  16.         the AEMail ARexx command "NEXT NAME" would not execute properly
  17.         since NAME would be interpreted as the "name" variable.
  18.  
  19.     Note the use of "'" surrounding the name1 variable.  This will pass the
  20.         single quote to AEMail surrounding the name extracted from the To:
  21.         or "cc:" string.  AEMail will strip the single quote preserving any
  22.         double quotes which might surround the name.  If you were to use
  23.         '"' instead of "'", the proper action would not occur.
  24.  
  25.  
  26.                                 HOW TO USE
  27.                                 ----------
  28.  
  29.  
  30. Before you start the script you will need to display (or select) the
  31. message that has the multiple To:  or cc:  addresses.  If a message is not
  32. selected you will get an error that says "No message is selected".
  33.  
  34. When the script is called you will be prompted for a group nickname.  If
  35. the group nickname does not exist you will be asked if you want to create
  36. it, enter a new name, or cancel.  If you wish to create it, the group will
  37. be created when the first email address is processed.  You will be
  38. immediately prompted, however, for the Group Description and if you want to
  39. set the Send Header Only flag when the group is created.  If you want
  40. quotes surrounding the group description, they should be entered with the
  41. group description string.
  42.  
  43. If the nickname is already used for an individual, you will be given an
  44. opportunity to reentering the nickname or cancelling.
  45.  
  46. If you cancel the "Enter Group Nickname" requester or one of the error
  47. notifications, you will exit from the script and will have to restart it.
  48.  
  49. You will always add the To: string to the Address Book.  After all of the
  50. To: addresses are added and if there is no cc: addresses the following
  51. message will be displayed:
  52.  
  53.     Last To: Name added - no cc: names
  54.  
  55. and the script will end after clicking on "CONTINUE"..
  56.  
  57. If there is a cc: address string you will see the following message
  58. displayed?
  59.  
  60.     Do you want to add cc: names?
  61.  
  62. You will be given a choice of YES or NO.  Clicking on NO will terminate the
  63. script.
  64.  
  65. Clicking on YES will add the cc: names to the Address Book.  After the last
  66. cc: address is added the following message will be displayed:
  67.  
  68.     Last CC: Name added
  69.  
  70. and the script will end after clicking on "CONTINUE".
  71.