This page tells you how to configure the various settings for tiggit mail. The settings can be reached from the main start screen that lists the email boxes you have configured.

settings

When the settings panel opens it will show the General Settings that apply to all mailboxes. From the menu you can switch to the Network Settings that set parameters for accessing the internet, via the mobile phone network. You can also show the settings for each of the mailboxes you have set up. In the example above there are two mailboxes, mac.com and G-mail.

General Settings

Here are the general settings that you can configure, and what they do. These are in the order that they appear on the settings panel.

Setting Function Factory Setting
autoLoad Tells tiggit mail to periodically check for new messages from all mailboxes. This setting has immediate effect. selected
sendReceive period

The period at which tiggit mail checks for new messages in seconds. 300 is 5 minutes, 600 is 10 minutes, 1800 is 30 minutes. If IMAP IDLE is selected, then this value is used as the period which tiggit mail checks that an IDLE session is active, and if it does not find one, establishes a new IMAP IDLE session with the server.

Tiggit mail needs to be restarted for this setting to have effect.

1800
doubleRow Tells tiggit mail to display messages using two lines for each message. It is recommended to restart tiggit mail after changing this setting. selected
mailboxLines

If the handheld mailbox is empty and tiggit mail checks to see if there is new mail, it will check the first <mailboxLines> messages. Subsequent checks will download all messages that are new after the latest message.

This is to prevent tiggit mail using large amounts of data to synchronise the first time it is run.

10
preloadSize The number of bytes to pre-load when a message is first downloaded from the server 3000
maxBoxSize The maximum number of mail messages to be held on the handheld for anyone mailbox. When this value is reached older messages are discarded. 10
immediateSend tells tiggit mail to immediately attempt to send messages placed in the outbox with send later. If sending fails then the message is held in the outbox until message sending is initiated not selected
singlePost Tells tiggit mail to use the SMTP helper in the tunnel server and be more efficient in sending messages selected
alertVibrate Tells tiggit mail to vibrate each time a new message is reveived  
alertLED Tells tiggit mail to flash the handheld LED red and green when a new message is received. The LED behaves normally once tiggit mail has been opened. selected
renderHTML Tells tiggit mail to attempt to display HTML messages as formatted messages with images. selected
warnMessageSize Tiggit mail will warn you if you attempt to download a large message as this may result in large data charges or overload the handheld. Messages with a size above this value will cause tiggit mail to create the warning 51200
maxMessageSize Tiggit mail will not download messages beyond a certain size as this is likely to overload the handheld. This value is the size beyond which tiggit mail will not download the message 5120000
reportMemoryStats This setting is used for memory profiling by the tiggit mail developers and should not normally be set not selected
HTMLCacheMaxSize HTML webpages generally have links to images. Once images have been downloaded, tiggit mail keeps a copy of the image handy (cached) in case it is needed again. This setting is the maximum size of the store dedicated to these images in KB. 100
HTMLCacheWeedSize When the HTML cache (see above) is full, tiggit mail throws away a number of images. It will throw away images until this amount of data is free in the cache, in KB. 10
showHTMLfirst HTML messages often contain plain text as well as HTML, and this often comes first in the email message. This setting always puts the HTML part of the message first on the screen, and any plain text goes afterwards not selected
softDelete Tells tiggit mail not to issue an EXPUNGE command after a mail has been marked DELETED on an IMAP server. This allows the user to review messages that have been deleted by the handheld at a later date. not selected
announce Suppresses "Sent using tiggit mail" message when sending mail. Only available to fully licensed users. not selected.

Mailbox Settings

The mailbox settings are normally set by the add mailbox wizard. You can access them from the settings panels, so here is what the various parameters mean.

Setting Function Factory Setting
userName The display name of the email user - i.e. the ful name of the user that accompanies the email message. these settings are user specific, so there are no factory settings
emailAddress The email address of the user associated with this mailbox.
emailPassword The email password for this mailbox
mailServer the internet address of the mail server to be connected to.
mailServerUserId The user id that is used to log into the mail server. If this is blank, the email address is used.
mailServerType This must be POP3 or IMAP depending on the protocol that is supported by the mail server. IMAP is recommended.
mailServerPort The TCP port that is to be used to connect to the IMAP/POP3 server.
mailServerSecure This must say true or false and indicates whether secure sockets (SSL or TLS) should be used to connect to the IMAP/POP3 server.
useTLS Use a TLS connection when establishing a secure connection. mailServerSecure must be selected for TLS. useTLS applies to both IMAP/POP3 connections and SMTP connections.
useIDLE Tells tiggit mail to establish an IMAP IDLE session if this is supported by the IMAP server. This feature cannot be used with a tunnel connection.
idleRefresh Sets the period with which tiggit mail sends NOOP to maintain the IDLE session. Value is in minutes. For every 5 NOOP messages the IDLE session is restarted.
reply-to If populated, adds a reply-to field to all outgoing messages from this account
dropCopy Tells tiggit mail to add the drop copy address as a bcc addressee to all outgoing messages
dropCopyAddress The address to which drop copies are sent.
sendProtocol not used
smtpServer The internet address of the SMTP server that is to be used to send mail.
smtpPort The TCP port that is to be used to connect to the SMTP server.
smtpSecure This must say true or false and indicates whether secure sockets should be used to connect to the SMTP server.
smtpUser The user-id that will be used to authenticate with the SMTP server.
smtpPassword The password to be used to login to the SMTP server.
Signature This is not normally set by the add mail box wizard. You can add text here that will be added to the end of any messages that you send. Typically this might be used for a sign-off message

 

Network Settings

The network settings panel contains a number of technical parameters that tells tiggit mail how to interact with the mobile phone network. Do not change these settings unless you are sure that you know what you are doing. If you do make changes it is recommended to write down the previous setting before making a change.

Setting Function Factory Setting
useWiFi Tells tiggit mail to use a WiFi connection rather than using the mobile data network. Turning this on will cause tiggit to ONLY use a WiFi connection. In the event that there is no WiFi then it will not be possible to connect. Similarly if there no WiFi hardware in the device it will not be possible to connect. false
tunnel Indicates whether tiggit mail should connect to the internet servers via the tunnel webservice proxy. true
tunnelSecure Indicates whether the connection to the tunnel should use secure sockets (SSL). true
tunnelServer The network address of the tunnel server www.tiggit.com
reportDebug A special flag that makes tiggit mail send debug logs to an internet server. Do not enable this unless explicitly asked to do so not selected
tunnelPeriod not used, but please leave as 0 0
useMDS indicates whether the handheld should use the Mobile Data Service (MDS) to connect to the internet. Most corporates and some mobile network providers use MDS. true
networkString The string of special commands passed to the http library. Only put values in here if you are asked to do so blank
sessionTimeout The length of time before it is assumed that a session is in active and can be reset, in seconds 60
installDate The date that the network configurator last ran. Do not change this value. It has nothing to do with the license key.