home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / umsmtp03.zip / ultimail.faq < prev    next >
Internet Message Format  |  1995-04-16  |  25KB
  1. Xref: demon comp.os.os2.networking.tcp-ip:19924
  2. Path: demon!peernews.demon.co.uk!btnet!uunet!gatech!newsjunkie.ans.net!newsgate.advantis.net!news-m01.ny.us.ibm.net!news
  3. From: jslings@ibm.net (Jorgen Slings)
  4. Newsgroups: comp.os.os2.networking.tcp-ip
  5. Subject: UMail LATEST FAQ !
  6. Date: Thu, 30 Mar 95 02:26:23 GMT
  7. Organization: IBM EMEA Internet HelpDesk
  8. Lines: 541
  9. Distribution: world
  10. Message-ID: <3lcfpf$1q3i@news-s01.ny.us.ibm.net>
  11. NNTP-Posting-Host: slip145-68.ut.nl.ibm.net
  12. Keywords: faq umail
  13. X-Newsreader: News Xpress Version 1.0 Beta #2.1
  14.  
  15. UltiMail FAQ
  16. ============
  17.  
  18. Contents:
  19. =========
  20.  
  21. Configuration Questions:
  22.  
  23. [1] How to configure UltiMail Lite to use another provider?
  24. [2] A commented sample of UMAIL.PRO
  25. [3] A commented sample of UMAILSRV.PRO
  26. [4] How to configure UltiMail for SMTP?
  27.  
  28. Using UltiMail:
  29.  
  30. [5] UltiMail command line options
  31. [6] How do I use the pop-up menus?
  32. [7] How can I view new mail?
  33. [8] How can I reply to mail?
  34. [9] How can I create new mail?
  35. [10] How can I send a piece of mail?
  36. [11] How can I add a name to the Address Book?
  37. [12] How can I add a .GIF to my note?
  38. [13] How can I change my signature?
  39. [14] How can I create a new folder?
  40. [15] Why do i not receive always the exact number of pieces of mail
  41.      that the refresh dialog indicates?
  42. [16] What is the ideal splitsize for my messages?
  43. [17] My hard drive is filling up, where could i check to gain some free space?
  44.  
  45. General Questions:
  46. [18] Where can I get the latest updates?
  47.  
  48.  
  49. Subject: [1] How to configure UltiMail Lite to use another provider?
  50. ====================================================================
  51.  
  52. If you already have a way to connect to a service provider, other than the
  53. Advantis or SlipPM dialers, then this information might interest you.
  54.  
  55. UltiMail Lite uses a series of profiles, each overriding the previous one
  56. with its information.
  57. 1) There is UMAIL.PRO, the 'UltiMail Client' profile, which has information
  58.    about how things get displayed, who you are, and how to contact your
  59.    mail provider.
  60. 2) UMAILSRV.PRO, the 'UltiMail Server' profile, which contains the information
  61.    about where your mail is stored and, if you use a POP3 server, how to
  62.    contact that server to get your mail.
  63. 3) TCPOS2.INI, which overrides information in the the above two profiles.
  64.    Note: If you are not using either the Advantis or SlipPM dialer, this
  65.    profile is empty and UltiMail will be missing some information. Note also
  66.    that TCPOS2.INI has the system file attribute. Thus it is hidden. Usually,
  67.    it is located on the \TCPIP\ETC directory.
  68.  
  69. Running UltiMail without the TCPOS2.INI file:
  70. ---------------------------------------------
  71.  
  72. 1) The structure of UMAIL.PRO and UMAILSRV.PRO:
  73.  
  74.    The following lines are the beginning of the UMAIL.PRO file:
  75.  
  76. //----------------------------------------------------------------------------
  77. // UltiMail/2 Client Configuration File
  78. // ====================================
  79. //
  80. // Many features of UltiMail/2 are user configurable. All features which are
  81. // specific for a given UltiMail/2 client are collected in this profile. This
  82. // file can be edited with any regular editor. More conveniently it is however
  83. // accessed through the settings notebooks in UltiMail/2 itself.
  84. //
  85. // Comments (like this one) are according to C++ conventions preceeded by a
  86. // double forward slash '//'. The double forward slash and anything after it
  87. // on the given line is then ignored by UltiMail/2.
  88. // Note: coments are not preserved when the configuration file is changed
  89. //       through the settings notebooks from within UltiMail/2.
  90. // Note: changes made directly in this file do not take effect until UltiMail/2
  91. //       is logged off and on again with this profile. Most changes made
  92. //       through the settings notebooks however take effect immediately.
  93. //----------------------------------------------------------------------------
  94. :USER    Name          = "John Smith"
  95.          ID            = js
  96.          reply_domain  = 'provider.com'
  97.          .
  98.  
  99.    The intial comment is self explanatory (I hope). The remaning four lines
  100.    above build what we call a 'tag'. A tag consists of a colon ':', a 'name',
  101.    one or several 'attribute=value' pairs, and the ending period '.'.
  102.    Values which contain blanks or periods must be in quotes (single and double
  103.    quotes are both permissible).
  104.    The file itself is plain ASCII and can be edited by any text editor.
  105.    Most of these tags can be manipulated through the settings pages in UltiMail.
  106.    The exceptions are as follows:
  107.    - the 'reply_domain' attribute of the :USER tag cannot be entered in the
  108.      settings pages (but you get prompted for it if it is missing)
  109.    - The :PROVIDER tag cannot be configured through settings pages.
  110.    - There are no settings pages for any of the tags in UMAILSRV.PRO.
  111.  
  112. 2) Removing the connections to TCPOS2.INI:
  113.    TCPOS2.INI processing can be bypassed by deleting the following tag from
  114.    both UMAIL.PRO and UMAILSRV.PRO:
  115.  
  116.    :PROFILE provider      = 'ADVANTIS'
  117.             file          = 'D:\TCPIP\ETC\TCPOS2.INI'
  118.             .
  119.  
  120.    Note: you may add/change the :USER tag if you like, but there is no need
  121.    to change any of the other tags in this file by directly editing them.
  122.  
  123. 3) Starting UltiMail in this state and entering the missing information:
  124.  
  125.    Now you can start UltiMail either by double clicking on the Mail Cabinet
  126.    icon, or by issuing the command: "Start UMAIL"
  127.  
  128.    Most likely you will now be prompted to enter the missing parts of the
  129.    :USER tag information.
  130.  
  131.    You will also be prompted to enter the missing information about the POP
  132.    server.
  133.  
  134. 4) Sending queued up mail when reconnected:
  135.  
  136.    If you use the above method to run UltiMail, you will be able to receive
  137.    and send mail while you are connected to your service provider. If you
  138.    happen to send mail while not connected, the mail will be queued up.
  139.    The Advantis as well as the SlipPM dialer will start a program called
  140.    MAILQ.EXE upon connection establishment. MAILQ will then process any
  141.    queued up mail by sending it out.  Since you are not using these dialers,
  142.    you will have to invoke the MAILQ program yourself either by typing
  143.    MAILQ or by creating a program object on the desktop for it on which
  144.    you can click, once your connection is up.
  145.  
  146.  
  147.  
  148.  
  149.  
  150. Subject: [2] A Commented Sample UMAIL.PRO File
  151. ==============================================
  152.  
  153. //----------------------------------------------------------------------------
  154. // Ultimedia Mail/2 Configuration File
  155. // ===================================
  156. //
  157. // Many features of UltiMail are user configurable. All features which are
  158. // specific for a given UltiMail client are collected in this profile. This
  159. // file can be edited with any regular editor. More conveniently it is however
  160. // accessed through the settings notebooks in UltiMail itself.
  161. //
  162. // Comments (like this one) are according to C++ conventions preceeded by a
  163. // double forward slash '//'. The double forward slash and anything after it
  164. // on the given line is then ignored by UltiMail.
  165. // Note: comments are not preserved when the configuration file is changed
  166. //       through the settings notebooks from within UltiMail.
  167. // Note: changes made directly in this file do not take effect until UltiMail
  168. //       is logged off and on again with this profile. Most changes made
  169. //       through the settings notebooks however take effect immediately.
  170. //----------------------------------------------------------------------------
  171.  
  172. // Note there is no :USER tag in the default profile because UltiMail Lite
  173. // picks that information up from the TCPOS2.INI file. It will prompt you if
  174. // the user information is missing.
  175.  
  176. // Do not change the :SESSION tag
  177. :SESSION       dll              = 'CSESLOCL'
  178.                name             = 'Local Mail'
  179.                pipeclass        = 'PIPELOCL'
  180.                load             = 'automatic'
  181.                retrycount       = '3'
  182.                retryinterval    = '5000'
  183.                color            = 'blue'
  184.                .
  185. // Remove this :PROVIDER tag (all three lines including the '.') to bypass
  186. // processing of TCPOS2.INI
  187. :PROFILE       provider         = 'ADVANTIS'
  188.                file             = 'D:\TCPIP\ETC\TCPOS2.INI'
  189.                .
  190.  
  191. // All of the remaining tags in this profile can be changed through the
  192. // settings pages in UltiMail.
  193. :LETTER        address          = 'short'
  194.                open             = 'first'
  195.                create           = 'Text/plain'
  196.                separator        = '//--- forwarded letter ------------'
  197.                annotation       = '> '
  198.                sigplacement     = 'before'
  199.                useseparator     = 'yes'
  200.                useannotation    = 'yes'
  201.                viewinwindow     = 'yes'
  202.                beeponnewmail    = 'yes'
  203.                notifysendok     = 'yes'
  204.                signature        = '//---// This is an example signature.'
  205.                .
  206. :OBJHANDLER    type             = Text
  207.                subtype          = enriched
  208.                viewtype         = SOM
  209.                viewmodule       = OBJEPM
  210.                viewdata         = Buffer
  211.                preload          = Yes
  212.                .
  213. :OBJHANDLER    type             = Text
  214.                subtype          = *
  215.                viewtype         = SOM
  216.                viewmodule       = OBJMLE
  217.                viewdata         = Buffer
  218.                preload          = Yes
  219.                .
  220. :OBJHANDLER    type             = Image
  221.                subtype          = *
  222.                viewtype         = SOM
  223.                viewmodule       = OBJIMG
  224.                viewdata         = File
  225.                preload          = No
  226.                .
  227. :OBJHANDLER    type             = Audio
  228.                subtype          = X-midi
  229.                viewtype         = EXE
  230.                viewmodule       = MPPM
  231.                .
  232. :OBJHANDLER    type             = Audio
  233.                subtype          = *
  234.                viewtype         = EXE
  235.                viewmodule       = WEPM
  236.                .
  237. :OBJHANDLER    type             = Message
  238.                subtype          = external-body
  239.                viewtype         = SOM
  240.                viewmodule       = OBJEXT
  241.                viewdata         = File
  242.                preload          = No
  243.                .
  244. :OBJHANDLER    type             = Video
  245.                subtype          = *
  246.                viewtype         = EXE
  247.                viewmodule       = MPPM
  248.                .
  249. :OBJHANDLER    type             = application
  250.                subtype          = *
  251.                viewtype         = SOM
  252.                viewmodule       = OBJHNDLR
  253.                viewdata         = File
  254.                preload          = No
  255.                .
  256. //---end of file -------------------------------------------------------------
  257.  
  258.  
  259.  
  260.  
  261.  
  262. Subject: [3] A Commented Sample UMAILSRV.PRO File
  263. =================================================
  264.  
  265. //----------------------------------------------------------------------------
  266. // Ultimedia Mail/2 Configuration File
  267. // ===================================
  268. //
  269. // Many features of UltiMail are user configurable. All features which are
  270. // specific for a given UltiMail client are collected in this profile. This
  271. // file can be edited with any regular editor. More conveniently it is however
  272. // accessed through the settings notebooks in UltiMail itself.
  273. //
  274. // Comments (like this one) are according to C++ conventions preceeded by a
  275. // double forward slash '//'. The double forward slash and anything after it
  276. // on the given line is then ignored by UltiMail.
  277. // Note: comments are not preserved when the configuration file is changed
  278. //       through the settings notebooks from within UltiMail.
  279. // Note: changes made directly in this file do not take effect until UltiMail
  280. //       is logged off and on again with this profile. Most changes made
  281. //       through the settings notebooks however take effect immediately.
  282. //----------------------------------------------------------------------------
  283.  
  284. // There is no need to change the :MAIL tag. If you change the directory you
  285. // will also have to create by hand a subdirectory PARTIAL and INBOX below
  286. // the server directory. 'directory'\INBOX is basically where incoming mail
  287. // is first stored. Partial mail letters get moved into 'directory'\PARTIAL
  288. // until all parts have arrived. Then the mail gets transferred over into
  289. // the user's inbox.
  290. :MAIL          directory        = 'D:\TCPIP\UMAIL\Server'
  291.                splitsize        = '32768'
  292.                .
  293. // Remove this :PROVIDER tag (all three lines including the '.') to bypass
  294. // processing of TCPOS2.INI
  295. :PROFILE       provider      = 'ADVANTIS'
  296.                file          = 'D:\TCPIP\ETC\TCPOS2.INI'
  297.                .
  298.  
  299. // Do not change the :SERVER tag
  300. :SERVER        dll           = 'CSESLOCL'
  301.                name          = 'Local Mail'
  302.                pipeclass     = 'PIPELOCL'
  303.                maxinst       = '20'
  304.                load          = 'demand'
  305.                retrycount    = '3'
  306.                retryinterval = '5000'
  307.                .
  308. // There exists a default USERID called 'PostMaster'. Mail delivered to
  309. // your machine but with a userid other than the ones defined in the
  310. // ACCESS tags below gets delivered there.
  311. :ACCESS        name          = 'Post Master'
  312.                user          = 'PostMaster'
  313.                password      = '*'
  314.                access        = 'readwrite'
  315.                root          = 'D:\TCPIP\UMAIL\MailStor\Postmstr'
  316.                .
  317. // This is the tag to change to enable POP from anywhere:
  318. :ACCESS        user          = 'js'// your UltiMail userid (must match
  319.                                     // the one in the :USER tag in UMAIL.PRO
  320.                password      = '*'  // your UltiMail password (must match
  321.                                     // the one in the :USER tag in UMAIL.PRO
  322.                // your mail gets stored below this directory. If you change
  323.                // this root make sure it points to a valid mail store
  324.                // (you can use the 'MAKEIDX path userid' command to construct
  325.                // a valid mail store below the directory 'path'.
  326.                root          = 'D:\TCPIP\UMAIL\MailStor\js'
  327.                access        = 'readwrite'  // do not change this entry
  328.                // change the following four tags
  329.                popuser       = 'js' // does not need to be the same as the
  330.                                         // UltiMail user id
  331.                poppassword   = 'your pop password'
  332.                popserver     = 'pop01.provider.com'
  333.                popport       = '110' // a value of 'none' bypasses
  334.                .                     // POP processing
  335. //---end of file -------------------------------------------------------------
  336.  
  337.  
  338.  
  339. Subject: [4] How to configure UltiMail for SMTP?
  340. ================================================
  341. It is possible to configure UltiMail Lite for SMTP. A freeware package is
  342. available from :
  343.     ftp.demon.co.uk:/pub/os2/tcpip/umsmtp01.zip
  344.     hobbes.nmsu.edu:/os2/32bit/network/umsmtp01.zip
  345.  
  346. You will find with this package a detailed README file explaining what you
  347. need to do to configure UltiMail Lite for SMTP.
  348.  
  349. Subject: [5] UltiMail Command line options
  350. ==========================================
  351.  
  352. UMAIL [/U=User] [/PW=Password] [/PRO=Profile] [/MIN] [/MAX]
  353.       [/LOGO] [/NOLOGO] [/LOGLEVEL=l] [/LOGDEST=d]
  354.  
  355. where:
  356. U   = Name of user
  357. PW  = Password of user
  358. PRO = profile to use
  359. MIN = start minimized
  360. MAX = start maximized
  361. LOGO = display UMail Logo
  362. NOLOGO = do not display UMail Logo
  363. LOGLEVEL = C_FLOW | INFO | WARNING | ERROR | OUTPUT | NONE
  364. LOGDEST = FILE | PM | FILEPM | NONE
  365.  
  366. Note: If you have problems, support people might ask you to run UltiMail
  367. with the following option: 'start umail /LOGLEVEL=INFO'. And then they might
  368. ask you to send the file UMAIL.LOG.
  369.  
  370.  
  371.  
  372. Subject: [6] How do I use the pop-up menus?
  373. ===========================================
  374. UltiMail, like OS/2 itself, makes a lot of use of pop-up (context) menus.
  375. Some functions are easiest to do by using those menus.  To get them, point
  376. at an area of an UltiMail window with the mouse, and click mouse button 2.
  377.  
  378. The pop-up menus are context-sensitive, which means that they depend upon
  379. where the mouse is pointing when you click.  You'll get different pop-ups,
  380. for instance, if you click in a folder on a selected item, a non-selected
  381. item, and a blank area.  In an envelope (view of a letter) you'll get
  382. different pop-ups in the text area, in the image area, in the sound area,
  383. in the table of contents bar, in the User Customizable Menu (toolbar), and
  384. so on.  As you're exploring, and as you try all the pull-down menus to see
  385. what functions are available, you should also try clicking mouse button 2
  386. in various places to see what pop-up menus are available.
  387.  
  388. Subject: [7] How can I view new mail?
  389. =====================================
  390.   1.    Double-Click on Ultimedia Mail/2 'Lite' icon in the IBM
  391.         Internet Connection OS/2.
  392.                 The Icon View for Ultimedia Mail/2 'Lite comes up.
  393.   2.    Double-Click In Basket icon.
  394.                 Ultimail Lite starts and the Inbox Refreshes.  If
  395.                 there is new mail a count will will appear showing the
  396.                 number of new messages.
  397.                 The In-basket will pop up.  If the Ultimail showed
  398.                 you had new mail and no new mail
  399.                 is shown in the In-basket, close the In-basket by
  400.                 clicking on In-basket in the Menu Bar and selecting
  401.                 Close.  Then reopen the In-basket using the process above.
  402.                 Your new mail will be listed in order of date received.
  403.   3.    Double-Click the mail you want to view.
  404.                 The Letter window will pop up.
  405.  
  406. Subject: [8] How can I reply to mail?
  407. ===================================
  408.   1.    Click the Reply button.
  409.   2.    Click the "To:" dialog to select the recepient(s) of the reply.
  410.         It will appear in the To: box.
  411.   3.    Move the mouse to the Contents box and click.
  412.         The cursor will appear.  You may insert the message here.
  413.  
  414. Subject: [9] How can I create new mail?
  415. =======================================
  416.   1.    Double-Click the New Letter icon in the Ultimedia Mail/2
  417.         Icon View.
  418.   -OR-
  419.         Click Cabinet in Mail Cabinet menu bar. Select New
  420.         Letter. The Letter window pops up titled Unknown.
  421.  
  422.   2.    Click the Names button to get your address book.
  423.   3.    Click on the name you want to send to.
  424.         The name will appear in the To: box.
  425.         -OR-
  426.         Type in the E-mail address of the person you want to send to
  427.         in the To:  box.  Your address is at the From: line.
  428.         This is the address you give out for people to send you mail.
  429.  
  430.   4.    Move the mouse pointer to the Contents: box and click.
  431.                 You may type your message here.
  432.  
  433. Subject: [10] How can I send a piece of mail?
  434. =============================================
  435.   1.    Click the Send button.
  436.                 The Letter window will clear to allow you to start
  437.                 another message.
  438.                 Once the mail message has been sent a dialog box will
  439.                 pop up stating the mail has been sent or the queue
  440.                 has been emptied.
  441.  
  442.  
  443.  
  444. Subject: [11] How can I add a name to the Address Book?
  445. ======================================================
  446.   1.    From the Ultimedia Mail/2 Ivcon View double-click the Names and
  447.         Addresses icon.
  448.   -OR-
  449.         From within Ultimail click Window in the Menu Bar.
  450.   2.    Select Address Book from the drop down menu.
  451.         Your Address Book pops up.
  452.   3.    Click the New Person button.
  453.   4.    Fill in the Nick Name that you want this person to go by.
  454.   5.    Fill in the rest of the information in the box.  UserID and domain
  455.         come from the person's E-mail address: UserID@domain.
  456.   6.    To save these changes click the Create button.
  457.  
  458. Subject: [12] How can I add a .GIF to my note?
  459. =============================================
  460.   1.    Click Letter from Menu Bar.
  461.   2.    Select New Part from menu.
  462.   3.    Select Image from menu.
  463.                 The Image icon pops up in the Contents box.  A
  464.                 window pops up to allow drawing, pasting, or
  465.                 importing images. Note you can only import .GIF or
  466.                 OS/2 .BMP files.
  467.   4.    Put the mouse pointer in the box.  Create a box in the window
  468.         by holding down the right mouse button and dragging it from
  469.         the upper right corner of the window to the lower right.
  470.   5.    While inside the window click the left mouse button.
  471.                 A short menu will pop up.
  472.   6.    Select Import... from the menu.
  473.         The Import Image window will pop up.
  474.   7.    Type in the complete path and file name of the image to import.
  475.   -OR-
  476.         Select the drive and filename from the dialog boxes shown.
  477.   8.    Click the Open button.
  478.                 The image you chose will appear in the window of you
  479.                 message box. To get back to your original text
  480.                 double-click on the Page icon in the contents box.
  481.  
  482. Subject: [13] How can I change my signature ?
  483. ============================================
  484.   1.    Click Letter in the Menu Bar.
  485.   2.    Select Settings...
  486.                 The Letter-Settings window will pop up.
  487.   3.    Place the cursor in the Signature box.
  488.   4.    Type your signature in the box the way you want it to appear
  489.         at the bottom of your mail messages.
  490.   5.    When done, double-click on the window icon in the upper left
  491.         corner of the window.
  492.  
  493. Subject: [14] How can I create a new folder?
  494. ============================================
  495.   1.    Open Mail Cabinet by double-clicking the Mail Cabinet icon.
  496.   2.    Click Cabinet on the menu bar.
  497.   3.    Select New Folder.
  498.   4.    Type in the new folder name in the Name: box.
  499.   5.    Click the OK button.
  500.  
  501. Subject: [15] Why do i not always receive the exact number of pieces of mail
  502. ============================================================================
  503. that the refresh dialog indicates?
  504. ==================================
  505. When mail is received through the network from a Post Office Protocol (POP)
  506. server, a dialog will display the number of downloaded messages.  Since
  507. MIME mail can be split into several parts, this count is not the count
  508. of letters you will see in your in-basket.  UltiMail will reassemble partial
  509. messages before showing them in the in-basket.  For example, a letter could be
  510. sent in three parts; you will see the downloading of three parts but only
  511. one letter (after it is reassembled).
  512.  
  513. Subject: [16] What is the ideal splitsize for my messages?
  514. ==========================================================
  515. We recommend to chose an important splitsize. This reduces the number of parts
  516. sent and thus the potential sources of communication problems. The default
  517. splitsize is 32,000 (which will work all over the world) but we recommend to
  518. rather use 250,000 (which seems to work well).
  519.  
  520. Subject: [17] My hard drive is filling up, where could i check to gain some
  521. ===========================================================================
  522.               free space?
  523.               ===========
  524. There are two main possibilities :
  525. 1) In the \TCPIP\ETC\MQUEUE directory. The files stored in this directory are
  526. the pieces of mail waiting to be sent. So to get rid of those files, you just
  527. have to connect to your internet provider and if it is not started
  528. automatically, you should run 'MAILQ.EXE'. All the files should disappear.
  529.  
  530. 2) In the \TCPIP\UMAIL\SERVER\PARTIAL directory.
  531. In this directory the notes that did not arrive completely are stored. Some
  532. parts are missing and thus the note could not be reassembled. You can edit
  533. those parts to see who sent them. If they are old, the chances are high that
  534. you will never get the missing parts. So you might ask the sender to send
  535. the note again and thus you can delete the current parts from the PARTIAL
  536. directory.
  537.  
  538.  
  539.  
  540. Subject: [18] Where can I get the latest updates ?
  541. ===================================================
  542.  The first updates should be available soon, most likely from
  543. the ftp server Software.watson.ibm.com. As soon as some more information
  544. is available, we will explain here how to get the latest updates.
  545. ============================== END OF ULTIMAIL FAQ ===========================
  546.  
  547.  
  548.  
  549. --------------------------------------------------
  550. Jorgen Slings                 Technical Support Engineer
  551.                                IBM European InterNet HelpDesk
  552.  
  553. jslings@ibm.net
  554. jslings@nl.ibm.com           fax : +31 (0)79.22.4406
  555. --------------------------------------------------
  556.  
  557.                                                 
  558.