home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / mr2i201.zip / INSTALL.TXT < prev    next >
Text File  |  1999-11-21  |  16KB  |  354 lines

  1. MR/2 ICE - An Internet EMail Client for OS/2 PM.
  2.  
  3. Copyright (c) 1996-1999, Knightware Software Company.
  4. All rights reserved.
  5.  
  6.  
  7. A WORD BEFORE YOU START 
  8.  
  9. MR/2 ICE is an internet e-mail program. Accordingly, before running 
  10. MR/2 ICE you must have set up OS/2 so that it can connect to the 
  11. internet. The relevant software and information is provided with the 
  12. version of OS/2 that you are running.
  13.  
  14. Apart from the software, you will also need to have a valid 
  15. connection to the internet through a provider. Your Internet Service 
  16. Provider ("ISP") will have provided you with the relevant 
  17. information required.
  18.  
  19. For the remainder of these instructions, it is assumed that you are 
  20. already able to connect to the internet, that is, that you have 
  21. installed the OS/2 internet software (including the dialer) and that 
  22. you have been given all the necessary information from your ISP.
  23.  
  24. MR/2 ICE will use information contained in your OS/2 internet set-up 
  25. to automatically configure itself. Do not be alarmed when you see a 
  26. message about your "tcpos2.ini" MR/2 ICE knows what it is doing. 
  27. There are a few (not many) things which you will need to do. These 
  28. are set out below.
  29.  
  30. It is suggested that you read this through before starting the set 
  31. up so that you know what will happen. If you want to jump right in, 
  32. you can keep this screen open, move it by dragging the blue line at 
  33. the top with your mouse and make it smaller by dragging the sides 
  34. with your mouse. That way you can keep this text open on the screen 
  35. while you do your set up. If the windows overlap you can switch 
  36. between this screen and the MR/2 ICE screen by clicking on the 
  37. screen you want to see with your left mouse button ("LMB").
  38.  
  39. INSTALLATION
  40.  
  41. MR/2 ICE is designed to be easy to set up and run. Once you are 
  42. familiar with the basic operation you will find that there are 
  43. plenty of sophisticated features which allow you customize your set 
  44. up and optimize you mail operations.
  45.  
  46. For the moment I am just concerned to get you up and running as 
  47. easily as possible. As this text is likely to be read by users with 
  48. differing experience with computers in general and OS/2 in 
  49. particular, please excuse me if this text appears to be too simple 
  50. or too complicated. Either way I hope that you will find something 
  51. of use in it.
  52.  
  53. MR/2 ICE QUICK START
  54.  
  55. Here are the simple instructions on installing MR/2 Internet Cruiser 
  56. Edition (MR/2 ICE):
  57.  
  58. Step One:
  59.  
  60. Create a directory on your hard drive (any partition) and unzip the 
  61. MR/2 ICE archive in it.
  62.  
  63. Step Two: 
  64.  
  65. Type in MR2I to start the configuration of MR/2 ICE.  Since you are 
  66. starting MR/2 ICE for the first time, the Network Configuration 
  67. Screen will be shown.
  68.  
  69. MR/2 ICE will read the TCPOS2.INI file, which is located in the 
  70. tcpip/etc directory as a hidden file.  MR/2 ICE will display the 
  71. message "Reading from TCPOS2.INI".  Do not worry, this is not an 
  72. error.
  73.  
  74. You will also get a message relating to "Default Font Bug Test". 
  75. Again do not be alarmed. MR/2 ICE is just checking to see that the 
  76. default font will work with your computer,
  77.  
  78. If there is a problem, simply follow the instructions on your 
  79. screen.
  80.  
  81. Step three:  
  82.  
  83. The TCPOS2.INI file may not contain enough information to complete 
  84. the page.
  85.  
  86. You will be asked, in some cases, which method to use to send and 
  87. receive mail.
  88.  
  89. POP3 is the most common method of retrieving mail and SMTP is the 
  90. most common method to send mail.
  91.  
  92. If you received a software package from your Internet Service 
  93. Provider (ISP), it may contain a file on how to set up other 
  94. software packages.
  95.  
  96. Please take the time to completely read your ISP's documentation.
  97.  
  98. If you still do not have all the information you need to complete 
  99. this page, please contact your ISP's technical support personnel.
  100.  
  101. Note: The address for your ISP's POP and SMTP servers might not be 
  102. the same.
  103.  
  104. It is possible that the Personal Address Settings "From" box will be 
  105. incomplete in that it may start with the "@" symbol (for example: 
  106. "@secant.com"). If this occurs, fill in the details you have been 
  107. given by your ISP (or which you might have in your dialer 
  108. information).
  109.  
  110. For example, I would fill in "nick" to complete the address: 
  111. nick@secant.com.
  112.  
  113. Do not worry if you miss this, MR/2 ICE will prompt you to fill it 
  114. in before leaving the page.
  115.  
  116. Step four:  
  117.  
  118. Setting up your preferences.  Using the mouse, click LMB (left mouse 
  119. button) on the USER PREFERENCES tab.  This will switch the notebook 
  120. page to the settings you, as the user, can change.
  121.  
  122. Notice that the top part of the page is for automatic mail handling.  
  123. The default is to automatically check for new mail and to 
  124. automatically send new mail when created.  The default time to check 
  125. for new mail is two minutes.
  126.  
  127. You can change any of these settings by checking or unchecking the 
  128. settings.  To check or uncheck click LMB on the relevant box. The 
  129. tick will appear or disappear. If the tick is there, the item is 
  130. "checked". The time interval is changed by clicking in the box and 
  131. then typing in the amount of time you want to wait while on line 
  132. with your ISP.
  133.  
  134. You can change the choices here at any time. Unless there is 
  135. something that you specifically do want or do not want, I suggest 
  136. you stick with the default settings (the "default" is what is 
  137. already pre-selected). 
  138.  
  139. The only item I want to comment on here is the first item under 
  140. "Default settings". This is "Remove messages from server after they 
  141. are fetched". You will notice that this box is not selected (it does 
  142. not have a tick). This means that when you get a message, your ISP 
  143. will keep a copy in your "mailbox". This can be useful if you are 
  144. only trying out MR/2 ICE because the messages will remain there to 
  145. be retrieved using your other e-mail program. 
  146.  
  147. It is also useful if you want to read mail in one place (e.g. your 
  148. office) but you want to keep all your e-mail files somewhere else 
  149. (e.g. at home). In that case you can check your messages at work and 
  150. use another computer at home to download and file. The only thing to 
  151. be aware of is that, if you NEVER remove the messages from your ISP, 
  152. one day, your mail box will get too full to accept new messages. 
  153. This is easy to deal with from the MR/2 ICE main window. Click on 
  154. "Messages" and then "Purge messages from server". That will clear 
  155. out the mail your ISP is holding for you.
  156.  
  157. Step five:  
  158.  
  159. Since MR/2 ICE will now work without you having to change any other 
  160. settings, click on the left hand corner of the window twice to close 
  161. it. MR/2 ICE will switch to the Main Window/In Box which should 
  162. contain a couple of messages from yours truly, Nick Knight.  For now 
  163. we will ignore these messages.
  164.  
  165. CONNECTING
  166.  
  167. Since MR/2 ICE does not contain a built-in dialer (at least not 
  168. yet!) you must use a dialer program. If you are not logged on to the 
  169. Internet you will not be able to send or receive mail. The Internet 
  170. Access Kit that comes with OS/2 Warp is a good program to use for 
  171. this purpose. As mentioned at the beginning of this file, it has 
  172. been assumed that you have already configured your dialer and you 
  173. are able to log on.
  174.  
  175. At this time, please start it and dial your ISP. MR/2 ICE will 
  176. either pick up any mail that is waiting for you or, depending on the 
  177. configuration choices you may have made, you can press "F2" to 
  178. instruct MR/2 ICE to check for new mail.
  179.  
  180. When your dialer logs on to the Internet, you may have the following 
  181. message at the bottom left of the MR/2 ICE screen "POP3 service 
  182. unavailable:" followed by the name of your POP server. Pressing "F2" 
  183. will cause the program to search for mail and this message will 
  184. change to indicate that MR/2 ICE is checking for new mail.
  185.  
  186. If you need to find a particular message, the file name for it is on 
  187. the right hand side of the menu bar.  The file is physically located 
  188. in a sub-directory called MAIL under the directory you installed 
  189. MR/2 ICE to.
  190.  
  191. If you cannot get the program to work, or if you want further 
  192. information on MR/2 ICE please use your WWW browser and search my 
  193. home page at http://nick.secant.com/mr2ice.  There you will find the 
  194. latest version of MR/2 ICE and a Frequently Asked Question page. I 
  195. hope there will also be a complete downloadable manual available 
  196. soon.
  197.  
  198. BASIC OPERATIONS
  199.  
  200. Now that you can receive mail, try to send yourself a message.  You 
  201. can create a new message by selecting either the blank message icon 
  202. (the first one on the left hand side) or the message drop down menu 
  203. (Alt and M keys) then N for New.  Fill in the message header window 
  204. with your address as the "to" address, then press the TAB key to get 
  205. to the subject and fill in that window with whatever the message 
  206. subject is.
  207.  
  208. If you fail to fill in the "to" address line, MR/2 ICE will note 
  209. that it is unable to send the message and returns you to the header 
  210. edit window.  However, all MR/2 ICE will do if you fail to put in a 
  211. subject is give you a warning and then ask you through a dialog box 
  212. if you want to continue or return.
  213.  
  214. Now you are at the message edit window.  Type in your message and 
  215. then press either the SEND button or ALT and S keys at the same 
  216. time.  This will place the message in the outbound queue.  Either 
  217. the message will be send immediately, or the next time you connect 
  218. to your ISP, depending on the setting you selected for automatic 
  219. message handling.
  220.  
  221. You can reply to any message that you receive that contains a valid 
  222. "from" address.  Just click on the reply button, and you should be 
  223. able to use the same steps as you did when sending a message.  
  224. Notice that the text in the message you received is put in the 
  225. message edit window with a ">" next to it.  This is called quoting.  
  226.  
  227. Do not quote excessively.  It wastes time to quote back to the 
  228. sender such items as their signature and other lines placed at the bottom of a message. 
  229.  
  230. Please note that MR/2 ICE supports selective quoting. However if you find that your reply contains more of the original message than is desirable, you can easily delete portions of unwanted quotes by using your mouse, holding down LMB while you drag the mouse across the text you do not want. Release LMB when you get to the end of the passage you wish to remove. The text is now  
  231. highlighted. Press the "Delete" key on your keyboard and the 
  232. highlighted text is removed.
  233.  
  234. The simple editor included with MR/2 ICE allows you to toggle back 
  235. to the original message (the "<" button) and then forward to the 
  236. reply (the ">" button).  It also allows you to split the screen and 
  237. show both windows at the same time (the "-" button"). 
  238.  
  239. While reading messages, you can click on Navigate.  This brings down 
  240. a menu of many options you can use. If you prefer to use the 
  241. keyboard, pressing the alt and N keys together will also select the 
  242. Navigate menu. On the right hand side of all menus are the 
  243. appropriate keyboard commands that will complete the operation 
  244. without using the drop down menu system.
  245.  
  246. The Right Mouse Button (RMB) is used often.  Try it inside message 
  247. index lists, on toolbar buttons, and inside address fields.
  248.  
  249. Selecting message(s).  Mark the message(s) you want to open with the 
  250. mouse and use the RMB to call up the popup menu (or use the main 
  251. menu).  Click on OPEN.  Alternately, double click on any single     
  252. message to open it.
  253.         
  254. Outbox:  The Out Box shows all messages sent with status symbols. 
  255. Unsent messages have a mailbox icon.  Sent messages switch to an 
  256. envelope icon.  There is a resend option on the popup menu (RMB) and 
  257. on the viewer screen.  Resending from the viewer screen provides an 
  258. optional chance to modify the message first.
  259.  
  260. If you want to create a new folder to put specific mail in this is 
  261. just three clicks away (two, if you are already in the Folders 
  262. window).  Click on the Folders tab, then RMB click on an empty space 
  263. on the Folders window to pop up the Folders menu.
  264.  
  265. COMMAND LINE OPTIONS
  266.  
  267. If you are just itching to get on and play with MR/2 ICE I suggest 
  268. you skip the next portion of this file and come back to it later if 
  269. necessary. It is not required reading before you can get up and 
  270. running. If you close this file now, I hope you enjoy MR/2 ICE. 
  271. However if you would like to know more ... I still hope you enjoy 
  272. the program but here is some additional information ...
  273.  
  274. MR/2 ICE provides many more features than are needed just to get 
  275. started. The following section deals with command line options that 
  276. you might want to use. 
  277.  
  278. Command line switches:
  279.  
  280.         /Iinifile   Specifies a file where user interface
  281.                     settings (e.g., toolbar visibility and
  282.                     position, window positions) are kept.
  283.                     The default is mr2i.ini.
  284.                 
  285.         /Mmailcfg   Specifies the file in which to keep and
  286.                     access your EMail configuration.
  287.                 
  288.         /S          Suppresses the polling and delivery of
  289.                     email.  No network access is attempted.
  290.                     
  291.         /T          Toolbar-less operation.  Bypasses the crash
  292.                     caused by some bug in Soft & GUI's CmdLine.exe.
  293.                     
  294.         /L          Logs activity to mr2i.log - debugging
  295.                     information.  Use this option if you experience 
  296.                     problems using MR/2 ICE. I would like for you to 
  297.                     include the log segment concerns the problem. This 
  298.                     will aid in troubleshooting your problem by me.
  299.  
  300.         /Fn         Select a default font for custom control 
  301.                     windows. (Necessary only if problems appear in 
  302.                     install)
  303.                     
  304.         /Pnnn       Specify an alternate Pop3 port. (Default is 110)
  305.         
  306.         /-          Minimize on start
  307.  
  308.         /X          Poll for new mail, exit.
  309.         
  310.         /XS         Poll for new mail, send any queued mail, exit. 
  311.                     This option is very useful for use with REXX 
  312.                     scripts.
  313.         
  314.         /Cn         Overrides the OS/2 Code page setting to n.
  315.         
  316.         /B          Advanced option: TCP/IP buffer sizes.  Defaults 
  317.                     to 24000.  Some systems cannot handle this many 
  318.                     buffers and MR/2 ICE crashes.
  319.         
  320.         /Qfile      Will add the named file to the MR/2 ICE outbox 
  321.                     and exit.  File is assumed to be a properly 
  322.                     formed message file.  You can force MR/2 to 
  323.                     attempt to send the message via use of the /XS 
  324.                     flag.
  325.         
  326.         /Euser@domain
  327.         
  328.                     Starts MR/2 ICE and immediately invokes a new 
  329.                     message to the address specified.  For use by a 
  330.                     third-party address book program still under 
  331.                     construction. 
  332.  
  333.  
  334. Command-line control of a running copy of MR/2 ICE:  The commands 
  335. above will actually cause an existing instance of MR/2, if found, to 
  336. do the desired work.  I went the extra step of support this for 
  337. multiple accounts, so specifying an account should talk to the right 
  338. copy of MR/2 ICE.  So, using the /Q option to queue a file actually 
  339. puts it in the outbox of a running copy, and proceeds to send it. 
  340. Using the /E option causes a New Message header screen to pop to the 
  341. desktop from a running copy of ICE.  Also:
  342.     
  343.         /Qfile  - as described above
  344.         
  345.         /Euser@domain - as described above        
  346.  
  347.         /+  will restore and bring focus to a minimized/buried 
  348.             copy of MR/2 ICE.
  349.             
  350.         /-  will minimize an existing, running copy of MR/2 ICE.
  351.         
  352.  
  353.  
  354.