home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMMUNIC / EMMA22.ZIP / WHATSNEW < prev   
Encoding:
Text File  |  1990-07-02  |  6.4 KB  |  148 lines
  1.                                     Emma 2.1
  2.                                     ========
  3.  
  4.                                Documentation Update
  5.  
  6.                                  by Pete Maclean
  7.                                  -- ---- -------
  8.  
  9. This short document describes the changes to Emma made since version 1.7.  A 
  10. full user guide for the program is available separately.
  11.  
  12. As well as a few new features, this edition of Emma has substantial improvements 
  13. in various types of error handling.  For example, it now copes gracefully with a 
  14. disk-full condition and will not leave fragments of aborted messages cluttering 
  15. up your MAIL.IN file.
  16.  
  17.  
  18. New Features
  19. --- --------
  20.  
  21. (*).  Three options are available on the 'M' command:  send-only, 
  22. attachment-overwrite and ASCII-mode.  Each option is selected by including a key 
  23. letter in a string argument.
  24.  
  25. In send-only mode, Emma sends MCI any outgoing mail without downloading INBOX 
  26. messages.  The feature is selected thus:
  27.  
  28.      M    "S"
  29.  
  30. Send-only mode is intended for users with secretaries who create and dispatch 
  31. mail but who do not handle incoming messages.
  32.  
  33. Normally, when Emma receives an attachment with a name that matches an existing 
  34. file, it generates a new name for the attachment of the form ATTACHED.xxx.  By 
  35. selecting attachment-overwrite mode, you instruct Emma to store attachments 
  36. under their original names even if such files already exist.  This option is 
  37. useful for those people who update remote files by MCI.  You select this option 
  38. by editing your 'M' command to read
  39.  
  40.      M    "O"
  41.  
  42. Finally, Emma's ASCII mode is provided for users of WordStar and similar editors 
  43. that bend high bits to their own uses.  The effect of selecting this option, by
  44.  
  45.      M    "A"
  46.  
  47. is that all messages are stripped down to 7-bit characters before transmission.  
  48. (This stripping applies specifically and only to message texts and not to 
  49. attached files.)
  50.  
  51. You may combine options as in this example:
  52.  
  53.      M    "AOS"
  54.  
  55. The option letters may appear in the string in any order.
  56.  
  57.  
  58. (*).  The K command tells Emma to transmit a standard BREAK signal on the COM 
  59. port.  (A BREAK consists of approximately 385 milliseconds of SPACE.)  It is 
  60. included for compatibility with certain foreign packet switch networks that 
  61. require such a signal as a trigger for setting PAD parameters.
  62.  
  63.  
  64. (*).  Suppose you love Emma but are wary about keeping your MCI password in a 
  65. script file that someone else might look at.  Or suppose that you use Emma on a 
  66. portable PC and need a different dialing code every time you run it.  Emma can 
  67. help.  Place a question mark in front of any string argument and Emma displays 
  68. it on the screen as a prompt for you to type in the "real" string you want used.  
  69. For example, to avoid putting your password in your EMMA.CSF file, you could set 
  70. up the appropriate section of it as follows:
  71.  
  72.      R  15   "name:"
  73.      T       "your_username"
  74.      T       "/batch:1ST/"
  75.      T     ? "^M^JPlease type your password (and press Enter):  "
  76.      T       "^M"
  77.      R 20    "COM^M^J"
  78.  
  79. You can use this facility with any script command although it is not obviously 
  80. useful with any but 'T'.  Note that while you press Enter to terminate the 
  81. string that you type in, the Enter itself (i.e. a carriage return) is not 
  82. included in the string.  You may type in strings of up to 80 characters; 
  83. anything typed beyond this limit is quietly ignored.
  84.  
  85. You can use the Escape key to abort a session while typing a string just as you 
  86. can at any other time.
  87.  
  88. You can even go one step further with this mechanism.  When Emma reads the 
  89. response to a prompt, it reads standard input (not the keyboard directly).  Thus 
  90. you can redirect input from a file.  For example, set up your EMMA.CSF with null 
  91. prompts (?"") and create a file, RESPONSE, containing the responses, one per 
  92. line.  Then start Emma with the command:
  93.  
  94.      EMMA <RESPONSE
  95.  
  96. This would allow you, for instance, to set up a totally generic script file for 
  97. Emma then have some other application query the user for dialing code, username, 
  98. password, etcetera, write that information out to a file and then invoke Emma as 
  99. above (perhaps via a batch file).
  100.  
  101.  
  102.  
  103. Troubleshooting Tips for Users with MNP Modems
  104. --------------- ---- --- ----- ---- --- ------
  105. With an MNP modem, Emma should be perfectly reliable.  If it proves not to be 
  106. then consider the following possible problems:  (1) You are not configuring the 
  107. modem so that it establishes an MNP connection with MCI.  (2) You have the modem 
  108. configured for the wrong type of flow control.  Emma uses Control-S/Control-Q 
  109. flow control.  If you set the modem for hardware flow control or any other 
  110. flow-control option then you are very likely to see errors.  (3) If your PC is 
  111. on a LAN the network software may steal sufficient processor time that Emma 
  112. misses characters coming in on the serial port.  Should you suspect this, verify 
  113. it by temporarily unloading the network software and seeing what happens.
  114.  
  115.  
  116.  
  117. Notes for International Users
  118. ----- --- ------------- -----
  119. Emma is the only publicly available agent software for MCI Mail that is 
  120. "internationalized."  As such, it has users all over Europe and Asia.
  121.  
  122. To use Emma from a foreign location, you will likely need to make substantial 
  123. modifications to a script in order to complete the connection.  The most 
  124. important thing to remember in doing so is that the connection must be set up 
  125. with no echoing.  This is different from terminal-mode connections and may 
  126. entail changing PAD parameters for foreign packet switch networks.
  127.  
  128. Should Emma give you the diagnostic:
  129.  
  130.      ***Protocol failure: unrecognized message received***
  131.  
  132. after completing a login to MCI, it is almost certain that echoing is the 
  133. problem.  Determine what has to be done to turn it off.
  134.  
  135. Emma does not operate correctly with Canada's DataPac.
  136.  
  137.                        *   *   *   *   *   *   *   *
  138.  
  139. Emma is Copyright (C) 1989 Ziff Davis Communications Co.
  140.  
  141. This document is Copyright (C) 1989, 1990 Pete Maclean.  It may be freely 
  142. distributed with Emma as long as no additions, deletions, or alterations are 
  143. made.  All other rights reserved.
  144.  
  145. NOTICE: Emma was developed, in part, using, with permission, proprietary, trade 
  146. secret information of MCI Telecommunications Corporation.  The user agrees to 
  147. use this program only for the purpose of communicating with MCI Mail.
  148.