MR/2 ICE - An Internet EMail Client for OS/2 PM. Copyright (c) 1996, Knightware Software Company. All rights reserved. A WORD BEFORE YOU START MR/2 ICE is an internet e-mail program. Accordingly, before running MR/2 ICE you must have set up OS/2 so that it can connect to the internet. The relevant software and information is provided with the version of OS/2 that you are running. Apart from the software, you will also need to have a valid connection to the internet through a provider. Your Internet Service Provider ("ISP") will have provided you with the relevant information required. For the remainder of these instructions, it is assumed that you are already able to connect to the internet, that is, that you have installed the OS/2 internet software (including the dialer) and that you have been given all the necessary information from your ISP. MR/2 ICE will use information contained in your OS/2 internet set-up to automatically configure itself. Do not be alarmed when you see a message about your "tcpos2.ini" MR/2 ICE knows what it is doing. There are a few (not many) things which you will need to do. These are set out below. It is suggested that you read this through before starting the set up so that you know what will happen. If you want to jump right in, you can keep this screen open, move it by dragging the blue line at the top with your mouse and make it smaller by dragging the sides with your mouse. That way you can keep this text open on the screen while you do your set up. If the windows overlap you can switch between this screen and the MR/2 ICE screen by clicking on the screen you want to see with your left mouse button ("LMB"). INSTALLATION MR/2 ICE is designed to be easy to set up and run. Once you are familiar with the basic operation you will find that there are plenty of sophisticated features which allow you customize your set up and optimize you mail operations. For the moment I am just concerned to get you up and running as easily as possible. As this text is likely to be read by users with differing experience with computers in general and OS/2 in particular, please excuse me if this text appears to be too simple or too complicated. Either way I hope that you will find something of use in it. MR/2 ICE QUICK START Here are the simple instructions on installing MR/2 Internet Cruiser Edition (MR/2 ICE): Step One: Create a directory on your hard drive (any partition) and unzip the MR/2 ICE archive in it. Step Two: Type in MR2I to start the configuration of MR/2 ICE. Since you are starting MR/2 ICE for the first time, the Network Configuration Screen will be shown. MR/2 ICE will read the TCPOS2.INI file, which is located in the tcpip/etc directory as a hidden file. MR/2 ICE will display the message "Reading from TCPOS2.INI". Do not worry, this is not an error. You will also get a message relating to "Default Font Bug Test". Again do not be alarmed. MR/2 ICE is just checking to see that the default font will work with your computer, If there is a problem, simply follow the instructions on your screen. Step three: The TCPOS2.INI file may not contain enough information to complete the page. You will be asked, in some cases, which method to use to send and receive mail. POP3 is the most common method of retrieving mail and SMTP is the most common method to send mail. If you received a software package from your Internet Service Provider (ISP), it may contain a file on how to set up other software packages. Please take the time to completely read your ISP's documentation. If you still do not have all the information you need to complete this page, please contact your ISP's technical support personnel. Note: The address for your ISP's POP and SMTP servers might not be the same. It is possible that the Personal Address Settings "From" box will be incomplete in that it may start with the "@" symbol (for example: "@secant.com"). If this occurs, fill in the details you have been given by your ISP (or which you might have in your dialer information). For example, I would fill in "nick" to complete the address: nick@secant.com. Do not worry if you miss this, MR/2 ICE will prompt you to fill it in before leaving the page. Step four: Setting up your preferences. Using the mouse, click LMB (left mouse button) on the USER PREFERENCES tab. This will switch the notebook page to the settings you, as the user, can change. Notice that the top part of the page is for automatic mail handling. The default is to automatically check for new mail and to automatically send new mail when created. The default time to check for new mail is two minutes. You can change any of these settings by checking or unchecking the settings. To check or uncheck click LMB on the relevant box. The tick will appear or disappear. If the tick is there, the item is "checked". The time interval is changed by clicking in the box and then typing in the amount of time you want to wait while on line with your ISP. You can change the choices here at any time. Unless there is something that you specifically do want or do not want, I suggest you stick with the default settings (the "default" is what is already pre-selected). The only item I want to comment on here is the first item under "Default settings". This is "Remove messages from server after they are fetched". You will notice that this box is not selected (it does not have a tick). This means that when you get a message, your ISP will keep a copy in your "mailbox". This can be useful if you are only trying out MR/2 ICE because the messages will remain there to be retrieved using your other e-mail program. It is also useful if you want to read mail in one place (e.g. your office) but you want to keep all your e-mail files somewhere else (e.g. at home). In that case you can check your messages at work and use another computer at home to download and file. The only thing to be aware of is that, if you NEVER remove the messages from your ISP, one day, your mail box will get too full to accept new messages. This is easy to deal with from the MR/2 ICE main window. Click on "Messages" and then "Purge messages from server". That will clear out the mail your ISP is holding for you. Step five: Since MR/2 ICE will now work without you having to change any other settings, click on the left hand corner of the window twice to close it. MR/2 ICE will switch to the Main Window/In Box which should contain a couple of messages from yours truly, Nick Knight. For now we will ignore these messages. CONNECTING Since MR/2 ICE does not contain a built-in dialer (at least not yet!) you must use a dialer program. If you are not logged on to the Internet you will not be able to send or receive mail. The Internet Access Kit that comes with OS/2 Warp is a good program to use for this purpose. As mentioned at the beginning of this file, it has been assumed that you have already configured your dialer and you are able to log on. At this time, please start it and dial your ISP. MR/2 ICE will either pick up any mail that is waiting for you or, depending on the configuration choices you may have made, you can press "F2" to instruct MR/2 ICE to check for new mail. When your dialer logs on to the Internet, you may have the following message at the bottom left of the MR/2 ICE screen "POP3 service unavailable:" followed by the name of your POP server. Pressing "F2" will cause the program to search for mail and this message will change to indicate that MR/2 ICE is checking for new mail. If you need to find a particular message, the file name for it is on the right hand side of the menu bar. The file is physically located in a sub-directory called MAIL under the directory you installed MR/2 ICE to. If you cannot get the program to work, or if you want further information on MR/2 ICE please use your WWW browser and search my home page at http://nick.secant.com/mr2ice. There you will find the latest version of MR/2 ICE and a Frequently Asked Question page. I hope there will also be a complete downloadable manual available soon. BASIC OPERATIONS Now that you can receive mail, try to send yourself a message. You can create a new message by selecting either the blank message icon (the first one on the left hand side) or the message drop down menu (Alt and M keys) then N for New. Fill in the message header window with your address as the "to" address, then press the TAB key to get to the subject and fill in that window with whatever the message subject is. If you fail to fill in the "to" address line, MR/2 ICE will note that it is unable to send the message and returns you to the header edit window. However, all MR/2 ICE will do if you fail to put in a subject is give you a warning and then ask you through a dialog box if you want to continue or return. Now you are at the message edit window. Type in your message and then press either the SEND button or ALT and S keys at the same time. This will place the message in the outbound queue. Either the message will be send immediately, or the next time you connect to your ISP, depending on the setting you selected for automatic message handling. You can reply to any message that you receive that contains a valid "from" address. Just click on the reply button, and you should be able to use the same steps as you did when sending a message. Notice that the text in the message you received is put in the message edit window with a ">" next to it. This is called quoting. Do not quote excessively. It wastes time to quote back to the sender such items as their signature and other lines placed at the bottom of a message. 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 highlighted. Press the "Delete" key on your keyboard and the highlighted text is removed. The simple editor included with MR/2 ICE allows you to toggle back to the original message (the "<" button) and then forward to the reply (the ">" button). It also allows you to split the screen and show both windows at the same time (the "-" button"). While reading messages, you can click on Navigate. This brings down a menu of many options you can use. If you prefer to use the keyboard, pressing the alt and N keys together will also select the Navigate menu. On the right hand side of all menus are the appropriate keyboard commands that will complete the operation without using the drop down menu system. The Right Mouse Button (RMB) is used often. Try it inside message index lists, on toolbar buttons, and inside address fields. Selecting message(s). Mark the message(s) you want to open with the mouse and use the RMB to call up the popup menu (or use the main menu). Click on OPEN. Alternately, double click on any single message to open it. Outbox: The Out Box shows all messages sent with status symbols. Unsent messages have a mailbox icon. Sent messages switch to an envelope icon. There is a resend option on the popup menu (RMB) and on the viewer screen. Resending from the viewer screen provides an optional chance to modify the message first. If you want to create a new folder to put specific mail in this is just three clicks away (two, if you are already in the Folders window). Click on the Folders tab, then RMB click on an empty space on the Folders window to pop up the Folders menu. COMMAND LINE OPTIONS If you are just itching to get on and play with MR/2 ICE I suggest you skip the next portion of this file and come back to it later if necessary. It is not required reading before you can get up and running. If you close this file now, I hope you enjoy MR/2 ICE. However if you would like to know more ... I still hope you enjoy the program but here is some additional information ... MR/2 ICE provides many more features than are needed just to get started. The following section deals with command line options that you might want to use. Command line switches: /Iinifile Specifies a file where user interface settings (e.g., toolbar visibility and position, window positions) are kept. The default is mr2i.ini. /Mmailcfg Specifies the file in which to keep and access your EMail configuration. /S Suppresses the polling and delivery of email. No network access is attempted. /T Toolbar-less operation. Bypasses the crash caused by some bug in Soft & GUI's CmdLine.exe. /L Logs activity to mr2i.log - debugging information. Use this option if you experience problems using MR/2 ICE. I would like for you to include the log segment concerns the problem. This will aid in troubleshooting your problem by me. /Fn Select a default font for custom control windows. (Necessary only if problems appear in install) /Pnnn Specify an alternate Pop3 port. (Default is 110) /- Minimize on start /X Poll for new mail, exit. /XS Poll for new mail, send any queued mail, exit. This option is very useful for use with REXX scripts. /Cn Overrides the OS/2 Code page setting to n. /B Advanced option: TCP/IP buffer sizes. Defaults to 24000. Some systems cannot handle this many buffers and MR/2 ICE crashes. /Qfile Will add the named file to the MR/2 ICE outbox and exit. File is assumed to be a properly formed message file. You can force MR/2 to attempt to send the message via use of the /XS flag. /Euser@domain Starts MR/2 ICE and immediately invokes a new message to the address specified. For use by a third-party address book program still under construction. Command-line control of a running copy of MR/2 ICE: The commands above will actually cause an existing instance of MR/2, if found, to do the desired work. I went the extra step of support this for multiple accounts, so specifying an account should talk to the right copy of MR/2 ICE. So, using the /Q option to queue a file actually puts it in the outbox of a running copy, and proceeds to send it. Using the /E option causes a New Message header screen to pop to the desktop from a running copy of ICE. Also: /Qfile - as described above /Euser@domain - as described above /+ will restore and bring focus to a minimized/buried copy of MR/2 ICE. /- will minimize an existing, running copy of MR/2 ICE.