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.
 |
 |
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.
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. |
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 |
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. |