home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / emma22.zip / EMMA.DOC < prev    next >
Text File  |  1990-09-27  |  27KB  |  602 lines

  1.                                     Emma
  2.                                     ====
  3.  
  4.                          Documentation for version 2.2
  5.  
  6.                               by Pete Maclean
  7.                               -- ---- -------
  8.  
  9. (Note for users updating to 2.2:  a summary of new features is given at the end 
  10. of this document.  There is also a new section on using Emma with an MNP modem.)
  11.  
  12. I have prepared this document to accompany Emma, the PC/MS-DOS version of my MCI 
  13. Mail utility published by PC Magazine.  While this document is intended to be a 
  14. complete user's guide to Emma, users may also benefit from reading my original 
  15. article about it in PC Magazine (Issue 19, November 14, 1989).
  16.  
  17. Each time you run Emma it attempts to connect to MCI Mail, upload any messages 
  18. you have prepared to your outbox, and download any messages waiting in your 
  19. inbox.  Emma can handle messages of all kinds including those to be sent to fax 
  20. machines, telex machines, Internet mailboxes and CompuServe subscribers.
  21.  
  22. Without a program like Emma, one connects to MCI Mail in what is called 
  23. "terminal mode."  Terminal-mode operation involves a lot of manual work and 
  24. bypasses one of MCI's most powerful features, the ability to ship arbitrary 
  25. files to other MCI subscribers.  Emma connects to MCI Mail in a different manner 
  26. called "batch mode."  With Emma, you never have to manually interact with MCI's 
  27. computers; Emma becomes your own private MCI agent.
  28.  
  29. Thanks to a script-file mechanism, Emma can be configured for use in any part
  30. in the world.  It already has supporters in Canada, Hong Kong, Taiwan and many 
  31. European countries.  If you are using it outside the U.S.A., you may have to 
  32. write your own script file or find another user who has created a suitable one.  
  33. Emma correctly handles messages that contain accented letters and other 
  34. characters from the extended PC character set (that is, with codes of 128 and 
  35. above).
  36.  
  37. Emma has one major limitation compared to other agent programs:  it has no 
  38. built-in error-correction capability.  Thus it is an ideal utility only for 
  39. those people with suitable error-correcting modems, specifically modems that 
  40. support MNP.  Without such a modem, you should consider using Emma only if you 
  41. normally experience a negligible number of transmission errors when connecting 
  42. to MCI Mail.  Emma does have error-detection capability and guarantees that when 
  43. it completes delivery of a message that message will be free of errors.  Should 
  44. a transmission error intrude, Emma aborts the session.  No data is lost in such 
  45. an event, but any message being transferred at the time must be transferred 
  46. again.
  47.  
  48.  
  49.  
  50. Before you use Emma
  51. ------ --- --- ----
  52. Emma is designed to operate with modems that use the Hayes AT Standard Command 
  53. Set.  Should you have a modem that requires a different command set, you can 
  54. still Emma but you will have to write a special script to enable it to work with 
  55. that modem.
  56.  
  57. Before running Emma for the first time, you must customize a script for the 
  58. program to follow in connecting to MCI Mail.  You will do best to start off with 
  59. one of the standard script files included in this package.  Select one as 
  60. follows:
  61.  
  62.           MNP.CSF      if you have an MNP modem, otherwise
  63.           800.CSF      if you connect, or plan to connect, to MCI Mail on a
  64.                           tollfree number,
  65.           LOCAL.CSF    if you connect, or plan to, via a local telephone number,
  66.           TYMNET.CSF   if you want to connect to MCI Mail via TYMNET.
  67.      or   DATAPAC.CSF  to connect via Canada's DataPac network
  68.  
  69. Use the DOS COPY command to copy the selected file to a file called EMMA.CSF.  
  70. Then edit EMMA.CSF according to the instructions contained within it.
  71.  
  72.  
  73.  
  74. Running Emma
  75. ------- ----
  76. Early versions of Emma required a companion program, Bess, to provide 
  77. communication services.  Bess has now been integrated into Emma providing extra 
  78. convenience for almost all users.
  79.  
  80. To run Emma, enter at the DOS prompt:
  81.  
  82.           C>emma
  83.  
  84. Emma must be able to find its script, EMMA.CSF, so normally you need to be in 
  85. the directory where that file resides.  
  86.  
  87. An alternate method is to set up a batch file to take care of the whole job.  I 
  88. use a batch file that looks like this:
  89.  
  90.  
  91.           CD \MCI
  92.           EMMA
  93.  
  94. The first command switches to the directory where I manage my electronic mail.  
  95. I call my batch file 1.BAT so, at any DOS prompt, all I have to do is type a 
  96. '1' and press Enter.
  97.  
  98. Once logged into the MCI Mail system, Emma looks for messages to be uploaded.  
  99. It searches the current directory for files named with an extension of "OUT".  
  100. Hence every message you create should be stored on such a file, e.g., PETE.OUT, 
  101. SALLY.OUT, etc.  When Emma has successfully delivered a message to MCI it 
  102. renames the corresponding file to give it an extension of "MLD" (for mailed).
  103.  
  104. Having completed any uploads, Emma downloads any waiting messages and appends 
  105. them to a file called MAIL.IN.  As each message is transferred, Emma displays 
  106. the envelope on your screen so that you can know at once who has sent you mail.  
  107. If you miss any of this information, there is no loss since it is all preserved 
  108. in MAIL.IN.
  109.  
  110. Once Emma has completed its work, you can inspect any new messages by reading 
  111. MAIL.IN with a word processor or a browsing program.  You may want to extract 
  112. certain messages and save them on other files.  After reading your mail it's a 
  113. good idea to delete or rename MAIL.IN so that when you next connect to MCI that 
  114. file will contain only your new mail.
  115.  
  116.  
  117.  
  118. Preparing Outgoing Messages
  119. --------- -------- --------
  120. The format of outgoing messages is described in a separate document file, 
  121. COMPOSE.DOC.
  122.  
  123.  
  124.  
  125. Things to remember when running Emma
  126. ------ -- -------- ---- ------- ----
  127.  
  128. * When you run Emma it must be able to find its script file, EMMA.CSF.
  129.  
  130. * You can abort a session at any time by pressing the Escape key.  Emma
  131.   ignores any other keyboard input.
  132.  
  133. * If your modem is not powered on or is disconnected, Emma will probably
  134.   complain about a timeout error.  This is because it sends a command to
  135.   the modem and receives no response.
  136.  
  137. * If MCI Mail sends an error message to Emma that message will be 
  138.   displayed on your screen.  The only things that MCI is likely to complain
  139.   about are:
  140.                - misformatted envelopes
  141.                - messages directed to unknown addressees
  142.                - messages with ambiguous addressees
  143.                - data damaged by transmission errors
  144.  
  145. * If MCI Mail rejects a message then Emma terminates the session.  Any
  146.   other messages awaiting transmission are left as they are.  Correct the
  147.   problem or rename the message before running Emma again.
  148.  
  149. * A "checksum error" is an almost certain indication of a transmission
  150.   error.  If you see one reported, try running Emma again.  If the error
  151.   happens again, you are probably getting connections that are too noisy.
  152.  
  153. * If you suffer a lot of aborted sessions because of transmission errors a
  154.   good trick to get cleaner connections is to run at a lower speed.  For
  155.   example, should you get frequent failures at 2400 bps, try 1200.  Message
  156.   transfer will take a little longer but, as long as you connect directly
  157.   to MCI Mail, the cost will be the same.
  158.  
  159. * After you upload a long message or attachment, it may take MCI a considerable
  160.   time to respond, close to two minutes in the worst cases.  This effect is
  161.   internal to MCI Mail; there is nothing that Emma can do to expedite matters.
  162.   If you send a file of several kilobytes, be patient waiting for the
  163.   transaction to complete.  Do not assume that the session is hung if nothing
  164.   happens for a while.
  165.  
  166. * Without an MNP modem it is unwise to use Emma to send messages or attached
  167.   files that exceed 10 KB.  The chances of the transmission being aborted by
  168.   an error grow with the length of the transaction.  Likewise, if you want to
  169.   transfer several files of substantial size as attachments, you should attach
  170.   each one to a separate message.
  171.  
  172. * Be very careful if you use WordStar to edit MAIL.IN.  Should you do a save
  173.   to MAIL.IN then WordStar pads the end of the file with Control-Zs, characters
  174.   that some programs including WordStar interpret as end of file markers.  If
  175.   Emma then appends further messages to MAIL.IN these messages appear after
  176.   the Control-Zs so that WordStar will fail to "see" them.  This phenomenon
  177.   may occur with certain other editors as well.
  178.  
  179.   To be safe, no matter what editor/word processor you use, it is very good
  180.   practice to clear out and delete MAIL.IN each time you read your new mail.
  181.   And in particular never do a save to MAIL.IN.
  182.  
  183.  
  184.  
  185. Writing Scripts
  186. ------- -------
  187. Emma needs a script file for four purposes:
  188.  
  189.      1. To tell it which COM port and what line speed (1200, 2400,...) to use.
  190.  
  191.      2. To give it the sequence of modem commands and expected responses 
  192.         required to connect to MCI Mail.
  193.  
  194.      3. To tell it how to login to the MCI systems, which means providing
  195.         your username and password.
  196.  
  197.      4. To inform it of other options that you may choose.  See the discussion
  198.         of "Advanced Options" below for details of these.
  199.  
  200. Normally, Emma looks for a script file called EMMA.CSF ("CSF" for connect 
  201. script file), but you can override that by providing Emma with an alternate 
  202. name as a command-line argument.  For example:
  203.  
  204.           C:\MCI>EMMA REG
  205.  
  206. tells Emma to use the script on file REG.CSF.  The extension of a script file 
  207. is assumed to be "CSF".
  208.  
  209. Script files are composed of simple commands written one per line as in the 
  210. following example:
  211.  
  212.           C     "Calling MCI Mail on an 800 number^M^J"
  213.           P  1  "2400"
  214.           T     "ATDT1-800-234-6245^M"
  215.           R 40  "CONNECT"
  216.           B
  217.           D  2
  218.           T     "^M"
  219.           R 25  "name:"
  220.           T     "username/batch,1ST/password^M"
  221.           M
  222.           R 10  "CLR DTE^M^J"
  223.  
  224. This is a barebones script to connect to MCI and run a mail-exchange session.  
  225. It serves as an illustration of the most important commands but, in practice, 
  226. you would want a slightly fuller script such as one of those distributed with 
  227. Emma.
  228.  
  229. Each command is identified by a single letter.  Here is a complete list:
  230.  
  231.           B - autoset bps
  232.           C - display a comment
  233.           D - delay for a number of seconds
  234.           K - sends a BREAK signal
  235.           L - enable logging of the session to a file (see advanced options)
  236.           M - conduct a mail-exchange session with MCI
  237.           P - configure the COM port to be used for communication
  238.           Q - select quick mode (see advanced options)
  239.           R - wait for an expected reply to arrive
  240.           S - specify an alternate message separator (see advanced options)
  241.           T - transmit a given string
  242.  
  243. With these descriptions it should be easy to figure out how the sample script 
  244. works although you may have to guess a few things.
  245.  
  246. Any command may take up to two arguments:  a numeric argument written as a 
  247. decimal integer and a string enclosed in double quotes.  Command letters and 
  248. arguments are separated by white space, that is spaces and/or tabs.
  249.  
  250. The command:
  251.  
  252.           P  1  "2400"
  253.  
  254. tells Emma to use COM1 and set the speed to 2400 bps.  Every script must contain 
  255. a 'P' command which should appear before any 'T' or 'R' commands.
  256.  
  257. The command:
  258.  
  259.           T     "ATDT1-800-234-6245^M"
  260.  
  261. tells Emma to transmit the given string, a dial command for the modem in this 
  262. example.  Any control characters that are required in strings must be expressed 
  263. using the common keyboard-equivalent notation.  Thus:
  264.  
  265.           ^M   means a carriage return (Control-M or Enter)
  266.           ^J   signifies a linefeed (Control-J)
  267.           ^L   indicates a formfeed (Control-L)
  268.           ^P   indicates a DLE (Control-P) used as an escape code by some PSNs.
  269.  
  270. and so on.  Emma ignores any literal control characters included in strings.  
  271. There is one exception to this rule:  horizontal tabs are accepted.
  272.  
  273. The command:
  274.  
  275.           R 25  "name:"
  276.  
  277. tells Emma to wait up to 25 seconds for the strings "name:" to come from MCI.  
  278. If the expected characters do not turn up in the allotted time, Emma aborts the 
  279. session with a timeout diagnostic.
  280.  
  281. The 'B' command is for the benefit of speed-adjusting modems.  It tells Emma to 
  282. look at the characters arriving from the modem and to decode a speed if such is 
  283. present.  A typical modem response would be "CONNECT 1200".
  284.  
  285. The 'M' command initiates a session between Emma and MCI Mail using MCI's 
  286. proprietary mail-exchange protocol.
  287.  
  288. The operation of the rest of the basic commands should be evident from the 
  289. above example.  More advanced commands are described below.
  290.  
  291. You should never have to write a script from scratch.  But if you connect to 
  292. MCI internationally or have a weird modem, you will need to edit one of the 
  293. scripts provided.
  294.  
  295.  
  296.  
  297. Advanced Options
  298. -------- -------
  299.  
  300. (*).  You may include comment lines in script files for documentation purposes.  
  301. Emma recognizes any line that starts with an asterisk or a semicolon as a 
  302. comment.  Don't confuse these internal comments with the external kind, that is 
  303. comments that are written to the user's screen via the 'C' command.
  304.  
  305.      C    "This is a comment that is written to the screen^M^J"
  306.      *    This is an internal comment that Emma ignores
  307.  
  308.  
  309. (*).  Emma can be run in an optional quick mode designed to minimize connection 
  310. times for those users who have to pay hefty line charges.  In quick mode, Emma 
  311. disconnects very quickly from MCI when there are no messages to be delivered; it 
  312. does not wait for all the commentary that MCI usually sends indicating the 
  313. numbers of messages sent and received.  Quick mode is selected by including a 
  314. 'Q' command in your script file.  Here is an example:
  315.  
  316.      Q    "There are no messages waiting in your INBOX^M^J"
  317.  
  318. The argument is a string defining a line that Emma can recognize as signifying 
  319. that MCI has no messages waiting for download.  The string must include one 
  320. entire line including the terminating CR and LF.  When Emma spots the given 
  321. line, and if it has no messages to upload, then it terminates the session.  Most 
  322. users who want to use quick mode will do best by copying the above example 
  323. exactly.
  324.  
  325. I chose to require that the user include the line explicitly in the 'Q' command 
  326. because wiring it into the program might lead to incompatibilities with 
  327. foreign-language versions and future revisions of MCI's system.
  328.  
  329. There is a means that Emma could use to determine automatically the number of 
  330. INBOX messages, but taking advantage of that would substantially increase the 
  331. connect time!
  332.  
  333. The 'Q' command may be placed anywhere in your EMMA.CSF before the 'M' command.
  334.  
  335.  
  336. (*).  You may select how messages are separated in the MAIL.IN file.  By 
  337. default, Emma adds three blank lines after each message.  If you want something 
  338. different then add an 'S' (for separator) command to your script file.  The 
  339. argument is a string defining the separator text.  Here is one example:
  340.  
  341.     S  "^M^J*************************************************************^M^J"
  342.  
  343. The 'S' command may be placed anywhere in your EMMA.CSF before the 'M' command.
  344.  
  345.  
  346. (*).  Three options are available on the 'M' command:  send-only, 
  347. attachment-overwrite and ASCII-mode.  Each option is selected by including a key 
  348. letter in a string argument.
  349.  
  350. In send-only mode, Emma sends MCI any outgoing mail without downloading INBOX 
  351. messages.  The feature is selected thus:
  352.  
  353.      M    "S"
  354.  
  355. Send-only mode is intended for users with secretaries who create and dispatch 
  356. mail but who do not handle incoming messages.
  357.  
  358. Normally, when Emma receives an attachment with a name that matches an existing 
  359. file, it generates a new name for the attachment of the form ATTACHED.xxx.  By 
  360. selecting attachment-overwrite mode, you instruct Emma to store attachments 
  361. under their original names even if such files already exist.  This option is 
  362. useful for those people who update remote files by MCI.  You select this option 
  363. by editing your 'M' command to read
  364.  
  365.      M    "O"
  366.  
  367. Finally, Emma's ASCII mode is provided for users of WordStar and similar editors 
  368. that bend high bits to their own uses.  The effect of selecting this option, by
  369.  
  370.      M    "A"
  371.  
  372. is that all messages are stripped down to 7-bit characters before transmission.  
  373. (This stripping applies specifically and only to message texts and not to 
  374. attached files.)
  375.  
  376. You may combine options as in this example:
  377.  
  378.      M    "AOS"
  379.  
  380. The option letters may appear in the string in any order.
  381.  
  382.  
  383. (*).  Emma's screen output can be redirected allowing the program to be used in 
  384. a more automated fashion.  You can, for example, invoke Emma from a batch file 
  385. and have it run "silently," that is with no screen output.  You can discard the 
  386. output completely by redirecting it to the null device, e.g.
  387.  
  388.                     EMMA >NUL:
  389.  
  390. Or you can redirect it to a file, e.g.
  391.  
  392.                     EMMA > OUTPUT
  393.  
  394. Warning:  don't carelessly redirect to a file named, say, EMMA.OUT.  Emma would, 
  395. of course, treat that file as a message to be sent to MCI.
  396.  
  397.  
  398. (*).  For the benefit of those who want to invoke it from batch files, Emma 
  399. terminates with one of the following exit codes:
  400.  
  401.           0 => Emma completed successfully but received no new mail
  402.           2 => file i/o error (no new mail received)
  403.           3 => script error (no new mail received)
  404.           4 => user interrupt, i.e. user pressed Esc  (no new mail received)
  405.           5 => timeout (no new mail received)
  406.           6 => protocol error (no new mail received)
  407.  
  408.           100 => Emma completed successfully and received some new mail
  409.           102 => file i/o error (after new mail was received)
  410.           103 => script error (after new mail was received)
  411.           104 => user interrupt (after new mail was received)
  412.           105 => timeout (after new mail was received)
  413.           106 => protocol error (after new mail was received)
  414.  
  415. Note that exit codes 1 and 101 are not used.  Emma adds 100 to whatever exit 
  416. code it would otherwise use if it has downloaded any new messages to MAIL.IN.  
  417. See the file, SAMPLE.BAT, for a model of how you might use these exit codes.
  418.  
  419.  
  420. (*).  Emma can create a transcript of each session it conducts with MCI Mail.  
  421. If you want a transcript for troubleshooting or any other reason, you must tell 
  422. Emma by adding an 'L' command to your .CSF file.  The argument is the name of 
  423. the file to which you want the log written, for example:
  424.  
  425.      L    "emma.log"
  426.  
  427. It is best to put this command near the beginning of the script file.  In future 
  428. versions, I may add options for selecting different levels of logging.
  429.  
  430.  
  431. (*).  The K command tells Emma to transmit a standard BREAK signal on the COM 
  432. port.  (A BREAK consists of approximately 385 milliseconds of SPACE.)  It is 
  433. included for compatibility with certain foreign packet switch networks that 
  434. require such a signal as a trigger for setting PAD parameters.
  435.  
  436.  
  437. (*).  Suppose you love Emma but are wary about keeping your MCI password in a 
  438. script file that someone else might look at.  Or suppose that you use Emma on a 
  439. portable PC and need a different dialing code every time you run it.  Emma can 
  440. help.  Place a question mark in front of any string argument and Emma displays 
  441. it on the screen as a prompt for you to type in the "real" string you want used.  
  442. For example, to avoid putting your password in your .CSF file, you could set up 
  443. the appropriate section of it as follows:
  444.  
  445.      R  15   "name:"
  446.      T       "your_username"
  447.      T       "/batch:1ST/"
  448.      T     ? "^M^JPlease type your password (and press Enter):  "
  449.      T       "^M"
  450.      R 20    "COM^M^J"
  451.  
  452. You can use this facility with any script command although it is not obviously 
  453. useful with any but 'T'.  Note that while you press Enter to terminate the 
  454. string that you type in, the Enter itself (i.e. a carriage return) is not 
  455. included in the string.  You may type in strings of up to 80 characters; 
  456. anything typed beyond this limit is quietly ignored.
  457.  
  458. You can use the Escape key to abort a session while typing a string just as you 
  459. can at any other time.
  460.  
  461. You can even go one step further with this mechanism.  When Emma reads the 
  462. response to a prompt, it reads standard input (not the keyboard directly).  Thus 
  463. you can redirect input from a file.  For example, set up your EMMA.CSF with null 
  464. prompts (?"") and create a file, RESPONSE, containing the responses, one per 
  465. line.  Then start Emma with the command:
  466.  
  467.      EMMA <RESPONSE
  468.  
  469. This would allow you, for instance, to set up a totally generic script file for 
  470. Emma then have some other application query the user for dialing code, username, 
  471. password, etcetera, write that information out to a file and then invoke Emma as 
  472. above (perhaps via a batch file).
  473.  
  474.  
  475.  
  476. Using Emma with an MNP Modem
  477. ----- ---- ---- -- --- -----
  478. With a properly configured MNP modem, Emma should work with perfect reliability.  
  479. Unfortunately, setting up your MNP modem with all the correct options may not be 
  480. trivial, especially since there is no uniformity among modems for the AT 
  481. commands that select MNP features.  Start with the MNP.CSF model script 
  482. provided, and make sure that your modem is sent the appropriate commands to 
  483. select:
  484.  
  485.      Flow control:  local birectional XON/XOFF.
  486.  
  487.      Disable bps-rate adjustment.
  488.  
  489.      Reliable mode (forces modem to make an MNP link or nothing).
  490.  
  491.      Enable data compression during MNP connections.
  492.  
  493. Note that the last option is usually a default but the other three are not.
  494.  
  495. By disabling the bps-rate adjustment, you can take advantage of higher 
  496. throughput thanks to MNP compression.  If you select this option then set the 
  497. port speed to a bps rate higher than that of the modem, for example 9600.  Also 
  498. be sure that you do not have a B command in your .CSF script.  Should Emma 
  499. complain about overrun errors then reduce the port speed; on slow PCs, Emma may 
  500. not be able to keep pace with 9600 bps.
  501.  
  502.  
  503.  
  504. Troubleshooting Tips
  505. --------------- ----
  506. If MCI finds faults with a message, an explanation will be displayed on your 
  507. screen.  (Unless, of course, you have redirected Emma's screen output.)
  508.  
  509. The most common problems are with misformatted envelopes.  For a message to be 
  510. delivered, the subscriber must be exactly identified.  If you address a message 
  511. to a name that's not unique, the IDs of all MCI subscribers with the name are 
  512. listed:  
  513.  
  514.       At least one problem with envelope 
  515.       608 More than 1 MCI Mail user matches recipient information
  516.       MCI ID   Name         Organization       Location
  517.       000-0000 Zoltan Shah  Whizzo Chocolate   New York, NY
  518.       111-1111 Zoltan Shah  Sunshine Desserts  Fresno, CA
  519.  
  520. Select the right one and edit your message to include the ID.  Remember that the 
  521. name should be separated from the ID by a slash, as in Zoltan Shah/111-
  522. 1111.  In fact, an ID alone is a perfectly acceptable address.
  523.     
  524. If MCI objects to something else in the envelope of a message, you may receive 
  525. a response such as:
  526.  
  527.      At least one problem with envelope 
  528.      610 Improper information in the envelope 
  529.      SUBJECT:  EMMA
  530.      This text is part of the message...
  531.  
  532. In this case, the blank line needed to terminate the envelope is missing.  Other 
  533. causes might be a mistyped keyword or the appearance of lines in an order that 
  534. MCI cannot handle.
  535.  
  536. Some errors offend MCI so much that it stops responding, such as a message with 
  537. two or more addresses on a line.  A message may be addressed to any number of 
  538. people, but each address must be on a separate To: or Cc: line.
  539.  
  540. And, if you receive either a Checksum error or Malformed data message, you can 
  541. be almost certain that a transmission error has ruined your session.  Just try 
  542. again.
  543.  
  544. With an MNP modem, Emma should be perfectly reliable.  If it proves not to be 
  545. then consider the following possible problems:  (1) You are not configuring the 
  546. modem so that it establishes an MNP connection with MCI.  (2) You have the modem 
  547. configured for the wrong type of flow control.  Emma uses Control-S/Control-Q 
  548. flow control.  If you set the modem for hardware flow control or any other 
  549. flow-control option then you are very likely to see errors.  (3) If your PC is 
  550. on a LAN the network software may steal sufficient processor time that Emma 
  551. misses characters coming in on the serial port.  Should you suspect this, verify 
  552. it by temporarily unloading the network software and seeing what happens.
  553.  
  554.  
  555.  
  556. Notes for International Users
  557. ----- --- ------------- -----
  558. Emma is the only publicly available agent software for MCI Mail that is 
  559. "internationalized."  As such, it has users all over Europe and Asia.
  560.  
  561. To use Emma from a foreign location, you will likely need to make substantial 
  562. modifications to a script in order to complete the connection.  The most 
  563. important thing to remember in doing so is that the connection must be set up 
  564. with no echoing.  This is different from terminal-mode connections and may 
  565. entail changing PAD parameters for foreign packet switch networks.
  566.  
  567. Should Emma give you the diagnostic:
  568.  
  569.      ***Protocol failure: unrecognized message received***
  570.  
  571. after completing a login to MCI, it is almost certain that echoing is the 
  572. problem.  Determine what has to be done to turn it off.
  573.  
  574.  
  575.  
  576. New Features In Version 2.2
  577. --- -------- -- ------- ---
  578. Version 2.2 brings two new features to Emma:  DataPac compatibility and 
  579. saving/restoring of the COM port.
  580.  
  581. The standard way of connecting to MCI Mail from Canada is via DataPac and then 
  582. through a gateway to TYMNET.  Earlier versions of Emma failed to operate via 
  583. DataPac due to some strange echoes apparently produced by that network.  The new 
  584. version is designed to discard these stray echoes and is accompanied by a script 
  585. file, DATAPAC.CSF, designed for such access.
  586.  
  587. Emma now saves the entire state of the COM port that it uses and restores that 
  588. state before terminating.  This feature was added for users who run Emma in a 
  589. multitasking environment such as DESQview.
  590.  
  591.                        *   *   *   *   *   *   *   *
  592.  
  593. Emma is Copyright (C) 1989 Ziff Davis Communications Co.
  594.  
  595. This document is Copyright (C) 1989, 1990 by Pete Maclean.  It may be freely 
  596. distributed with Emma as long as no additions, deletions, or alterations are 
  597. made.  All other rights reserved.
  598.  
  599. NOTICE: Emma was developed, in part, using, with permission, proprietary, trade 
  600. secret information of MCI Telecommunications Corporation.  The user agrees to 
  601. use this program only for the purpose of communicating with MCI Mail.
  602.