There are two ways to connect to other Internet providers:
This is the simple case. The 'Dial Other Internet Provider' dialer uses
the same
TCPOS2.INI
configuration file as the 'IBM Internet Dialer' does.
If you fill in all the settings in the four pages of the 'Dial Other
Internet Provider' dialer, then UltiMail will just pick up the values
from the TCPOS2.INI file.
IMPORTANT NOTE: There is currently one problem. You have to type the
"*Name" field (first field on the first settings page of the 'Dial Other
Internet Provider' dialers) all uppercase and equal to the "Login ID" field.
The "Login ID" field may be in mixed case.
UltiMail Lite uses a series of profiles, each overriding the previous one with its information.
Running UltiMail without the TCPOS2.INI file:
//----------------------------------------------------------------------------
// UltiMail/2 Client Configuration File
// ====================================
//
// Many features of UltiMail/2 are user configurable. All features which are
// specific for a given UltiMail/2 client are collected in this profile. This
// file can be edited with any regular editor. More conveniently it is however
// accessed through the settings notebooks in UltiMail/2 itself.
//
// Comments (like this one) are according to C++ conventions preceded by a
// double forward slash '//'. The double forward slash and anything after it
// on the given line is then ignored by UltiMail/2.
// Note: comments are not preserved when the configuration file is changed
// through the settings notebooks from within UltiMail/2.
// Note: changes made directly in this file do not take effect until UltiMail/2
// is logged off and on again with this profile. Most changes made
// through the settings notebooks however take effect immediately.
//----------------------------------------------------------------------------
:USER Name = "John Smith"
ID = js
reply_domain = 'provider.com'
.
The initial comment is self explanatory (I hope). The remaining four lines above build what we call a 'tag'. A tag consists of a colon ':', a 'name', one or several 'attribute=value' pairs, and the ending period '.'. Values which contain blanks or periods must be in quotes (single and double quotes are both permissible). The file itself is plain ASCII and can be edited by any text editor. Most of these tags can be manipulated through the settings pages in UltiMail. The exceptions are as follows:
:PROFILE provider = 'ADVANTIS'
file = 'D:\TCPIP\ETC\TCPOS2.INI'
.
Now you can start UltiMail either by double clicking on the Mail Cabinet icon, or by issuing the command: "Start UMAIL"
Most likely you will now be prompted to enter the missing parts of the :USER tag information.
You will also be prompted to enter the missing information about the POP server.
If you use the above method to run UltiMail, you will be able to receive and send mail while you are connected to your service provider. If you happen to send mail while not connected, the mail will be queued up. Either of the dialers will start a program called MAILQ.EXE upon connection establishment. MAILQ will then process any queued up mail by sending it out. Since you are not using these dialers, you will have to invoke the MAILQ program yourself either by typing MAILQ or by creating a program object on the desktop for it on which you can click, once your connection is up.
//---------------------------------------------------------------------------- // Ultimedia Mail/2 Configuration File // =================================== // // Many features of UltiMail are user configurable. All features which are // specific for a given UltiMail client are collected in this profile. This // file can be edited with any regular editor. More conveniently it is // accessed through the settings notebooks in UltiMail itself. // // Comments (like this one) are according to C++ conventions preceded by a // double forward slash '//'. The double forward slash and anything after it // on the given line is then ignored by UltiMail. // Note: Comments are not preserved when the configuration file is changed // through the settings notebooks from within UltiMail. // Note: Changes made directly in this file do not take effect until UltiMail // is logged off and on again with this profile. Most changes made // through the settings notebooks however take effect immediately. //----------------------------------------------------------------------------
// Note: There is no :USER tag in the default profile because UltiMail Lite
// picks that information up from the TCPOS2.INI file. It will prompt you if
// the user information is missing.
// Due to bug in UltiMail Lite version 2.10 a missing user tag can lead to
// a loop (see also Cannot get past the "Accessing a Network" panel)
:USER id = 'your user id'
other_id = 'Internet'
name = 'Your Name'
reply_id = 'reply id' // usually same as id
reply_domain = 'your.reply.domain'
password = 'encoded password' // never edit this string
// delete it if you need to
.
// The :OPTIONS tag specifies how often UltiMail tries to refresh your
// In-basket from the POP server. The value is in milliseconds.
// Since 900000 = 15*60*1000, this is every 15 minutes. A value of 0 indicates
// no automatic refresh.
// Normally Ultimail will prompt only for missing information. In versions 2.10.002
// and higher, prompt keywords were added in case a prompt is desirable like when
// multiple users or multiple POP users sign on to Ultimail. Setting them to 'yes' forces
// a prompt which gives an opportunity to change the user information (applicable only
// when not using the INI file).
:OPTIONS refresh_interval = '900000'
prompt = 'yes' // accessing the network prompt
prompt_pop = 'yes' // accessing a mail server prompt
.
// Do not change the :SESSION tag
:SESSION dll = 'CSESLOCL'
name = 'Local Mail'
pipeclass = 'PIPELOCL'
load = 'automatic'
retrycount = '3'
retryinterval = '5000'
color = 'blue'
.
// Remove this :PROVIDER tag (all three lines including the '.') to bypass
// processing of TCPOS2.INI
// Note: provider='ADVANTIS' means that the file follows the Advantis or
// Dial Other Provider dialer way of storing information. It is a historic
// mishap that this never got changed to something like type='TCPOS2' or
// some similar more meaningful term. If the provider is set to anything
// else than ADVANTIS the processing of the TCPOS2.INI file will be
// bypassed, which is in most cases not desirable.
// The signature text is limited to about 1000 characters.
:PROFILE provider = 'ADVANTIS'
file = 'D:\TCPIP\ETC\TCPOS2.INI'
.
// All of the remaining tags in this profile can be changed through the
// settings notebook pages in UltiMail.
:LETTER address = 'short'
open = 'first'
create = 'Text/plain'
separator = '//--- forwarded letter ------------'
annotation = '> '
sigplacement = 'before'
useseparator = 'yes'
useannotation = 'yes'
viewinwindow = 'yes'
beeponnewmail = 'yes'
notifysendok = 'yes'
signature = '//---// This is an example signature.'
.
:OBJHANDLER type = Text
subtype = enriched
viewtype = SOM
viewmodule = OBJEPM
viewdata = Buffer
preload = Yes
.
:OBJHANDLER type = Text
subtype = *
viewtype = SOM
viewmodule = OBJMLE
viewdata = Buffer
preload = Yes
.
:OBJHANDLER type = Image
subtype = *
viewtype = SOM
viewmodule = OBJIMG
viewdata = File
preload = No
.
:OBJHANDLER type = Audio
subtype = X-midi
viewtype = EXE
viewmodule = MPPM
.
:OBJHANDLER type = Audio
subtype = *
viewtype = EXE
viewmodule = WEPM
.
:OBJHANDLER type = Message
subtype = external-body
viewtype = SOM
viewmodule = OBJEXT
viewdata = File
preload = No
.
:OBJHANDLER type = Video
subtype = *
viewtype = EXE
viewmodule = MPPM
.
:OBJHANDLER type = application
subtype = *
viewtype = SOM
viewmodule = OBJHNDLR
viewdata = File
preload = No
.
:TIMEZONE zone = '0'
hours = '-5'
minutes = '0'
summerwhich = '1'
summerday = '0'
summermonth = '3'
standardwhich = '5'
standardday = '0'
standardmonth = '9'
.
//---end of file -------------------------------------------------------------
//---------------------------------------------------------------------------- // Ultimedia Mail/2 Configuration File // =================================== // // Many features of UltiMail are user configurable. All features which are // specific for a given UltiMail client are collected in this profile. This // file can be edited with any regular editor. More conveniently it is however // accessed through the settings notebooks in UltiMail itself. // // Comments (like this one) are according to C++ conventions preceded by a // double forward slash '//'. The double forward slash and anything after it // on the given line is then ignored by UltiMail. // Note: comments are not preserved when the configuration file is changed // through the settings notebooks from within UltiMail. // Note: changes made directly in this file do not take effect until UltiMail // is logged off and on again with this profile. Most changes made // through the settings notebooks however take effect immediately. //----------------------------------------------------------------------------
// There is no need to change the :MAIL tag. If you change the directory you
// will also have to create by hand a subdirectory PARTIAL and INBOX below
// the server directory. 'directory'\INBOX is basically where incoming mail
// is first stored. Partial mail letters get moved into 'directory'\PARTIAL
// until all parts have arrived. Then the mail gets transferred over into
// the user's inbox.
:MAIL directory = 'D:\TCPIP\UMAIL\Server'
splitsize = '262144'
.
// This :PROVIDER tag does not get processed. For symmetrical reasons
// it should be the same as the one in UMAIL.PRO
:PROFILE provider = 'ADVANTIS'
file = 'D:\TCPIP\ETC\TCPOS2.INI'
.
// Do not change the :SERVER tag
:SERVER dll = 'CSESLOCL'
name = 'Local Mail'
pipeclass = 'PIPELOCL'
maxinst = '20'
load = 'demand'
retrycount = '3'
retryinterval = '5000'
.
// The read attribute of the :OPTIONS tag is the time UltiMail
// waits before it gives up trying to reach a POP server, The time is
// in milliseconds. The default is 60000 which is 60 seconds.
:OPTIONS read = '60000'
.
// In version 2.10 the way access tags work has been changed. There is a
// new user '*' and an info='RULE' which means the mail of all users is
// stored starting at the directory composed from the mailstore plus
// the userid.
:ACCESS user = '*'
info = 'RULE'
mailstore = 'D:\TCPIP\UMAIL\Mailstor'
.
// In version 2.10 if the mail of a user is not stored in the default
// directory generated by the rule the following access tag will be in
// the profile. It means that the real access tag (like the one shown
// below is stored in a file composed the following way: the server
// directory from the :MAIL tag plus the subdirectory ACCESS
// plus the filename userid.ACC. Such a tag might also be needed if the
// POP information cannot be found in the TCPOS2.INI file.
:ACCESS user = 'userid'
info = 'FILE'
.
// If you need to add a special user with special pop information or
// mail not located in the rule generated directory, then add a tag in the
// following form. It will be converted by UltiMail into a tag in the
// info='FILE' form and the tag below will be stored in the userid.ACC file.
:ACCESS user = 'js'// your UltiMail userid (must match
// the one in the :USER tag in UMAIL.PRO
password = '*' // your UltiMail password (must match
// the one in the :USER tag in UMAIL.PRO
// your mail gets stored below this directory. If you change
// this root make sure it points to a valid mail store
// (you can use the 'MAKEIDX path userid' command to construct
// a valid mail store below the directory 'path'.
root = 'D:\TCPIP\UMAIL\MailStor\js'
access = 'readwrite' // do not change this entry
// change the following four tags
popuser = 'js' // does not need to be the same as the
// UltiMail user id
poppassword = 'your pop password'
popserver = 'pop01.provider.com'
popport = '110' // a value of 'none' bypasses
. // POP processing
//---end of file -------------------------------------------------------------
ftp://hobbes.nmsu.edu/os2/network/tcpip/umsmtp03.zip ftp://ftp.demon.co.uk/pub/os2/tcpip/umsmtp03.zip
You will find with this package a detailed README file explaining what you need to do to configure UltiMail Lite for SMTP.
To use SMTP with an Internet provider you might need to change SENDMAIL.UML by hand.
UMAIL [/PRO=Profile] [/MIN] [/MAX]
[/LOGO] [/NOLOGO] [/LOGLEVEL=l]
[/LOGDEST=d] [/MSG=c]
where:
PRO = profile to use
MIN = start minimized
MAX = start maximized
LOGO = display UMail Logo
NOLOGO = do not display UMail Logo
LOGLEVEL = C_FLOW | INFO | WARNING | ERROR | OUTPUT | NONE
LOGDEST = FILE | PM | FILEPM | NONE
MSG = UM_OPEN_INBOX | UM_CLOSE_INBOX | UM_OPEN_MAILCABINET | UM_CLOSE_MAILCABINET |
UM_OPEN_ADDRBOOK | UM_CLOSE_ADDRBOOK | UM_OPEN_NEWLETTER
Note: If you have problems, support people might ask you to run UltiMail with the following option:
start umail /LOGLEVEL=INFO
If you can send mail with UltiMail, send the UMAIL.LOG file as a binary attachment: Create a new letter and describe the problem. Then press the toolbar binary attachment button and enter the filename:
Drive:\TCPIP\UMAIL\UMAIL.LOG.
If you cannot send using UltiMail then you might want to try invoking the sendmail command explicitly:
sendmail -af Drive:\TCPIP\UMAIL\UMAIL.LOG -CDrive:\PathToEtcDir\SENDMAIL.UML -f userid@your.domain touser@target.domain
UltiMail, like OS/2 itself, uses pop-up (context) menus. Some functions are easiest to do by using pop-up menus. To bring up a pop-up menu, point at an area of an UltiMail window with the mouse, and click mouse button 2.
The pop-up menus are context-sensitive, which means that the menu that pops up depends upon where the mouse is pointing when you click. For example, you'll get different pop-ups if you click in a folder on a selected item, a non-selected item, or a blank area. In the Letter window, you'll get different pop-ups in the text area, the image area, the addressee name entry line, the table of contents bar, the User Customizable Menu (toolbar), etc.
Some areas in a window may not have any pop-up menu. When you click the right mouse button in these areas, nothing happens. Also: Functions that can be done by using pop-up menus can generally also be invoked in other ways, for instance, from options on the window's drop-down menus.
As you're exploring, and as you try all the drop-down menus to see what functions are available, you should also try clicking mouse button 2 in various places to see what pop-up menus are available.
You must start UltiMail. The In-basket window must be opened. UltiMail needs to be connected to your mail service provider. The precise steps will vary slightly depending on your particular setup. The following example is for a user who has UltiMail Lite installed as part of the Warp Internet Connection.
If you start UltiMail by double-clicking the Mail Cabinet icon in the Icon View, or by executing Umail from an OS/2 window command line, you can initiate the In-basket open and refresh sequence described above by clicking on the Mail Cabinet's Windows drop-down menu and selecting In-basket.
When mail is received through the network from a Post Office Protocol (POP) server, the information line at the bottom of the In-basket window will display the number of downloaded messages. Since MIME mail can be split into several parts, this count can be greater than the number of letters you will see in your In-basket. UltiMail reassembles partial messages before showing them in the In-basket. For example, a letter could be sent in three parts; you will see the downloading of three parts but only one letter (after it is reassembled).
We recommend a splitsize larger than the default. This reduces the number of message parts sent, and thus the potential sources of communication problems. The default splitsize is 32,000 (which will work all over the world), but we recommend 250,000 (which seems to work well).
Folliwing are some possibilities to check:
There are various versions of UltiMail or products containing versions of UltiMail. Here is a list of all those versions and some of their characteristics:
The Readme quotes the following improvements when installed over a 2.00 version from the Warp bonus pack.
UltiMail stores information in the following files:
UltiMail stores the window size and position of folders and the UltiMail desktop in OS2.INI. This is done through the WinSaveWindowPos calls which do not allow to specify another INI file; otherwise we would have stored this information in the UMAIL.INI file.
The information is stored under the application ULTIMAIL with the folder name being the key. This means if you have two folders with the same name, we will only store one position. If you open both folders they will be placed exactly on top of each other.For example this happens if you have a folder A with a subfolder misc and a folder B with a subfolder misc. The misc folders will share their position and settings.
Since these values are all stored in a binary PM internal format you cannot modify any of them. The only thing you can potentially do is delete them.
UltiMail stores window settings information like fonts, views, sorting, user customizable menu bars etc. in UMAIL.INI. UltiMail also stores the letter size and position in UMAIL.INI. The UMAIL.INI file is located in BootDrive:\OS2
If you have any problems with settings, a simple way to reset all settings to their defaults is to delete the UMAIL.INI file.
Historically UltiMail stores client-related information like user information, mapping of data types to viewers etc. in the UMAIL.PRO file. In UltiMail version 1.0, or 3.0 where we have full client/server versions, the client and server do not need to run on the same machine, hence the two profiles (UMAIL.PRO and UMAILSRV.PRO).
For a description of the various versions of UltiMail see: What are all the UltiMail versions?
For a detailed description of UMAIL.PRO see: A commented sample of UMAIL.PRO
Historically UltiMail stores server-related information like where mail is stored, who has access to those mailstores, etc. in the UMAILSRV.PRO file. In UltiMail version 1.0, or 3.0 where we have full client/server versions, the client and server do not need to run on the same machine, hence the two profiles (UMAIL.PRO and UMAILSRV.PRO).
For a description of the various versions of UltiMail see: What are all the UltiMail versions?
For a detailed description of UMAILSRV.PRO see: A commented sample of UMAILSRV.PRO
TCPOS2.INI consists like any .INI file in OS/2 of a set of application/key/value triplets. In TCPOS2.INI most applications correspond either to the uppercased userid for the "IBM Internet Dialer" or the case sensitive "*Name" field from the "Dial Other Provider" settings. There are also a few special application names like CONNECTION and LAN. So in a certain sense there are three different types of applications:
Global keys are:
LAN connection values, these are only used when the current connection is the LAN connection:
Other keys, not used by UltiMail.
Note: There are some more keys used in the TCPOS2.INI file. They are mostly self explanatory and are used by the dialers themselves.
The sendmail.uml configuration file contains rules to route outgoing mail, as follows:
Note: if you intend to use UltiMail on the LAN only it is advantageous to set the external macros to their equivalent internal ones. That means set the V macro to the value of the R macro, and set the H macro to the value of the I macro.
Userids are created by logging on as a particular user. The first time you log on as a new user, a mailstore will be created automatically.
Note: it is simpler to connect to the provider first before logging on to UltiMail for the first time. UltiMail can then take most information out from the settings for the dialer through the TCPOS2.INI file
Signatures for multiple users can be set through the settings notebook (see How can I change my signature?). Signatures get stored in the TCPOS2.INI file. If you disabled TCPOS2.INI file processing you can have only one signature, the one stored in UMAIL.PRO.
To set the signature for a specific user log on under that user's id and use the Mail Cabinet or Letter Settings notebook to set the signature for that particular user. Repeat this process for all users.
For more information see:
Userids cannot be longer than 8 characters. It is recommended to use HPFS as your file system due to its better performance and the support of mixed case, long filenames.
On FAT systems userids cannot be longer than 8 characters. On HPFS systems they can be longer than 8 characters.
If POP is used to receive mail, then userids cannot be longer than 8 characters even if the system uses HPFS.
HPFS is the better file system, because it is a lot faster and supports mixed case, long filenames. If possible use an HPFS partition to install TCP/IP and UltiMail on.
The answer to this question is relatively complex since it depends on the type of userid, where it is used and where it comes from.
Types of userids:
Problem cases:
When using the "Dial Other Provider" dialer, the "*Name" field must be all uppercase for UltiMail to correctly find the information.
Nicknames in the addressbook cannot contain blanks. Unfortunately UltiMail will let you enter blanks. But those nicknames containing blanks will not work correctly.
This problem may occur after you installed version 2.10. It will occur if there is no :USER. tag in UMAIL.PRO and the TCPOS2.INI profile is not processed.
Here are two ways to fix this problem:
Add the following tag to your UMAIL.PRO file. It will break the loop and allow you to enter a password.
:USER id = 'your user id'
other_id = 'Internet'
name = 'Your Name'
reply_id = 'your reply id' // typically the same as your id
reply_domain = 'your.reply.domain'
.
The TCPOS2.INI gets processed if you have the following tag in your UMAIL.PRO file:
:PROFILE provider = 'ADVANTIS'
file = 'D:\MPTN\ETC\TCPOS2.INI'
.
If you are using the Dial Other Provider dialer, make sure the *Name: field is all UPPERCASE. Otherwise UltiMail will not find the information!
UltiMail uses either the TCP/IP sendmail program or the POP3 protocol to recieve mail. The following steps will guide you through the relevant TCP/IP setup and configurations to find the problem:
sendmail -af c:\config.sys -Cc:\tcpip\etc\sendmail.uml -f fromid toid
Check that the file shows up in your c:\tcpip\umail\server\inbox directory
sendmail -d -af c:\config.sys -Cc:\tcpip\etc\sendmail.uml -f fromid toid
t telnet -p110 pop.server.net // put in the correct pop server name +OK POP Server Description // make sure you get the +OK response t USER userid // userid is case sensitive ! +OK Password required for userid // make sure you get the +OK response t PASS password // password is case sensitive ! +OK userid has n message(s) ... // this should tell you how many messages you have t QUIT // this will disconnect you from the server
umail /loglevel=info
UltiMail uses the TCP/IP sendmail program to send mail. The following steps will guide you through the relevant TCP/IP setup and configurations to find the problem:
sendmail -af c:\config.sys -Cc:\tcpip\etc\sendmail.uml -f fromid toid
sendmail -d -af c:\config.sys -Cc:\tcpip\etc\sendmail.uml -f fromid toid
Sometimes something goes wrong and mail gets stuck in your %etc%\mqueue directory. You will see this by either issuing the following command from an OS/2 command prompt:
dir %etc%\mqueue
Here is a step by step guide to try to figure out what is wrong and how to get it working again:
attrib %etc%\mqueue\*.*
SYS0002: The system cannot find the file specified.
SYS0003: The system cannot find the path specified.
[C:\]attrib %etc%\*.* A C:\MPTN\ETC\df000033 A C:\MPTN\ETC\qf000033 A C:\MPTN\ETC\xf000033
[C:\]attrib %etc%\*.*
A C:\MPTN\ETC\df000033
C:\MPTN\ETC\qf000033
attrib +a %etc%\mqueue
mailq
To use a sendmail alias file with UltiMail, the OA statement must be added to the SENDMAIL.UML file in the ETC directory. The statement that must be added has the following syntax:
OAaliasfile
To have sendmail forward a note to another userid, add the line:
user1: user2