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.
There are also a couple of blog entries that discuss optimising certain settings - this one relates to settings when using WiFi, and this one discusses settings changes for users migrating from version 1.0. These setting details relate to version 1.1.19 of tiggit 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 |
| headersOnly |
Tiggit will only download email headers for IMAP servers |
unselected |
| defaultMailbox |
Tells tiggit mail to open the default folder of this mailbox at start up |
blank |
| 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 |
| timeFormat |
Choose either 12hr or 24hr time format for the indicated send time on messages within the inbox list. |
24hr |
| smallFontSize |
sets the font size used for small text messages |
|
| mediumFontSize |
sets the font size used for medium text messages, such as the status message |
|
| shadingColour |
A hexadecimal number indicating the background colour to be used to shade alternate rows in the inbox viewer. The number is in the format of RGB - two hex digits for R, two for G, two for B. FFFFFF is white. |
|
| 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 |
| 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 |
| alertUnreadOnly |
Tells tiggit mail to only create an alert for messages that do not have the READ flag set |
unselected |
| subjectAlert |
creates a special alert when this string is found in the subject of a message. The alert type is set within the BlackBerry profile |
|
| showLinks |
Tiggit will look for http and mail links within messages and make them active links that can be clicked on to navigate to the link |
|
| renderHTML |
Tells tiggit mail to attempt to display HTML messages as formatted messages with images. |
selected |
| loadHTMLimages |
Indicates whether tiggit mail should load any images indicated within email messages. |
selected |
| 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 |
| HTMLCacheSize |
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 |
| 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 |
| exitPreference |
Indicates whether tiggit mail should exit or go to background when the back arrow button is pressed on the mailbox list screen |
Prompt |
| deletePreference |
Indicates whether tiggit mail deletes on the server or handheld by default |
blank |
| 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 |
| showDeleted |
Indicates whether tiggit should show deleted message within the inbox with the caption "will delete on server" |
not selected |
| autoUpdate |
Indicates whether tiggit should check periodically for new versions of tiggit mail. |
selected |
| replySignature |
Indicates whether tiggit mail should add a signature to reply messages |
selected |
| announce |
Suppresses "Sent using tiggit mail" message when sending mail. Only available to fully licensed users. |
not selected. |
| sendEncoding |
Allows the user to indicate the character encoding to use when sending messages |
UTF-8 |
| diskLog |
Tells tiggit mail to write it's log file to the SD Card |
not selected |
| log |
Tells tiggit mail to log debug messages |
not selected |
| clearErrorLog |
Indicates whether tiggit mail should clear the BlackBerry error log on start up |
selected |
| contactMenu |
Tells tiggit mail to add itself to the menus of the Contact List |
selected |
| useSDCard |
Tells tiggit mail to store messages on the SD Card if possible. |
selected |
| startTime |
Sets the time at which tiggit mail will automatically start. The time is in the format HH:MM in 24 hour clock |
|
| endTime |
Sets the time at which tiggit mail will automatically exit. The time is in the format HH:MM in 24 hour clock |
|
| startOnBoot |
Makes tiggit mail start automatically (in background) when the BlackBerry boots |
unselected |
| Setting |
Function |
Factory Setting |
| mailboxOpen |
Indicates how tiggit mail should open a mailbox - either to the default folder or the folders view |
these settings are user specific, so there are no factory settings |
| userName |
The display name of the email user - i.e. the ful name of the user that accompanies the email message. |
| 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. |
| closeSession |
Tells tiggit mail to close server sessions when it has finished - otherwise the session is jsut left open until it times out. |
| 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. |
| 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. |
| smtpAuthType |
The authentication type that is to be used when connecting to the SMTP server. Note that challenge authentication (such as CRAM-MD5) cannot be used with singlePost. |
| smtpDomain |
The internet domain that is declared to the SMTP server in the EHLO command. By default this is is set to localhost |
| allowSTARTTLS |
Allows tiggit mail to use STARTTLS when this is available from an 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 |
| useBIS-B |
indicates whether the handheld should use the BIS-B Transport to connect to the mail server. |
false |
| 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 |
| postBlockSize |
When messages are sent via singlePost they are blocked into messages of the size indicated by this value. Typically http messages are spooled 100% to the MDS and then sent to on to the server. This setting should be set to balance this. |
25600 |
| socketBlockSize |
When messages are sent to the smtp server, data is sent in blocks. This parameter sets the block size that is sent prior to waiting. |
|
| socketBlockWait |
Sets the wait time, in milliseconds, between sending data blocks via a socket connection. |
|
| installDate |
The date that the network configurator last ran. Do not change this value. It has nothing to do with the license key. |
|
