![Close [x]](http://dw1.s81c.com/i/c.gif){kind=small}
Long-time Lotus Notes users are familiar with the Notes.ini file. You can add or modify lines in this simple text file to change the way that Lotus Notes behaves -- sometimes at a very technical level. Lotus Domino Access for Microsoft Outlook has its own Notes.ini file that controls the way the software operates. Many of these configuration settings are cryptic and of little use to users; those settings are outside the scope of this article. However, there are many other settings in this file that can help you to troubleshoot a problem or to add functionality to Lotus Domino Access for Microsoft Outlook.
This article discusses various Notes.ini settings for Lotus Domino Access for Microsoft Outlook, providing descriptions of settings that can help you to troubleshoot a problem or enable a feature. It organizes the settings by functionality, such as installation, profile, managed user, and so on. This article is intended for experienced Lotus Domino Access for Microsoft Outlook users. The settings described in this article apply to Lotus Domino Access for Microsoft Outlook 6.5.5 and later.
In the case of a single-user installation, the Notes.ini file is located in the Lotus Domino Access for Microsoft Outlook program directory. By default, this is C:\Program Files\DominoForOutlook and can be opened in any text editor. For multi-user installations, each user has a Notes.ini file in his data directory.
As with all Notes.ini files, the order of the settings does not matter. However, the last line in the Notes.ini file should be an empty line created with a carriage return/line feed.
The following table lists settings that tell how Lotus Domino Access for Microsoft Outlook and Microsoft Outlook are installed. You can use this information to troubleshoot installation issues.
| Name | Value | Description |
|---|---|---|
| Directory | C:\Program Files\DominoForOutlook | This setting specifies the path of the Lotus Domino Access for Microsoft Outlook program directory, in which the Lotus Domino Access for Microsoft Outlook DLL files are installed. C:\Program Files\DominoForOutlook is the default value. |
| FaultRecovery_Build | Build V<version>_<date>, in which <version> specifies the version number and <date> specifies the build date | This setting lists the version of Lotus Domino Access for Microsoft Outlook installed on the system. |
| OUTLOOK_TYPE | 1 = Microsoft Outlook 2000 2 = Microsoft Outlook 2002 (XP) 3 = Microsoft Outlook 2003 | This setting indicates which version of Microsoft Outlook is installed on the system. |
The following table lists the profile settings that are reset every time a new Lotus Domino Access for Microsoft Outlook profile is created.
| Name | Value | Description |
|---|---|---|
| PROFILE_ERROR | Error message | If there is an error during MAPI profile creation, this setting explains the error. |
| PROFILE_SUCCESS | 0 = Last profile creation failed 1 = Last profile creation succeeded | This setting indicates whether or not the last profile creation succeeded. |
| Domain | Server domain name | This setting specifies the domain of the server specified by the last profile set up. |
| UserSpecServerName | ServerName/Org | This setting lists the server specified by the last profile set up. |
| MAPI_STORE | Mailbox – <First name> <Middle initial> <Last name> | This settings is the name of the mail store of the profile last set up. |
Each of the following values is a list. An entry is added to the list every time a Lotus Domino Access for Microsoft Outlook profile is created.
| Name | Value | Description |
|---|---|---|
| MAPI_PSTFILE | <common user name>_<common server name>.pst | This setting lists the name of the Microsoft Outlook data file for each installed profile (PST file). |
| REPLTEST_CACHE | <common user name>_<common server name>.nsf | This setting lists the name of the cache file for each installed profile (NSF file). |
| MAPI_PROFILE | <common user name's> mail on <common server name> | This setting lists the name of the MAPI profile for each installed profile. |
The following settings are updated every time a Lotus Domino Access for Microsoft Outlook profile loads.
| Name | Value | Description |
|---|---|---|
| WaitForAddinComplete | 0 = Add-in is not currently loading 1 = Add-in is currently loading | This setting indicates that Lotus Domino Access for Microsoft Outlook’s Outlook add-in is currently loading. The setting value should be set to 1 for a small period during each time Microsoft Outlook starts up. This setting is used for Lotus Domino Access for Microsoft Outlook timing and troubleshooting. |
| KeyFilename | <common user name>.id For example, jsmith.id | This setting specifies the ID file of the user currently logged on. This setting is updated each time a profile logs on. This does not have to be named with the common user name. |
| MailFile | MAIL/<common user name>.nsf For example, MAIL/jsmith.nsf | This settings indicates the path of the currently logged in mail file on the server. This setting is updated each time a profile logs on. |
| MailServer | <common server name> | This setting specifies the server of the user currently logged on. This setting is updated each time a profile logs on. |
| CertificateExpChecked | <common user name>.id date logged in | This setting indicates the ID file of the user currently logged on and the date when that user's certificate was last checked for expired password. This setting is updated when a profile logs on, but not more than once per day. |
| RequestCertTableUpdate | <common user name>.id date logged in | This indicates the ID file of the user currently logged on and the date when Lotus Domino Access for Microsoft Outlook last requested a password expiration check for the certificate of that user. This setting is updated when a profile logs on, but not more than once per day. |
Each of these settings is preceded by <common user name>_<common server name>_, representing the Lotus Domino Access for Microsoft Outlook profile to which it applies.
| Name | Value | Description |
|---|---|---|
| OUTLOOK_DATA_DIR | C:\Program Files\DominoForOutlook\ | This setting specifies the data directory path for the current user, which is the same as the Lotus Domino Access for Microsoft Outlook program directory in the case of a single-user installation. |
| INIT | 0 = Profile not yet initialized (should happen on profile's first run of Lotus Domino Access for Microsoft Outlook). 1 = Initialization is complete. | This setting indicates if you can start the replicator. |
| SETUP | 0 = Initial download of user is not yet complete. 1 = Initial download of user is done. | This setting can be reset by failover, preferred server change, unreachable cache file, replication interval setback, or any other time you need to synch with a new server mail file. |
| DisplayProgressDone | 0 = Initial download of user is not yet complete. 1 = Initial download of user is done. | This setting determines whether or not you see the initial setup dialog box. It is reset only by a missing cache file or replication interval setback. |
| WelcomeMsgCreated | 0 = Welcome message is not created. 1 = Welcome message is already created. | This setting indicates whether or not the welcome message was created. |
| Manage_Modified | 0 = Do not check for new managed user information. 1 = Check for new managed user information. | This setting should be set to 1 briefly while a managed user is initialized, directly after a managed user has been added or removed, and should never be set when Microsoft Outlook is closed. |
| NOTEID | 0 = No message is currently being mapped. Non-zero = The decimal NoteID in the cache of item is being mapped. | This setting is set to 0 unless an item is currently being mapped to Microsoft Outlook. When an item is being mapped, then it is set to the decimal number representing the NoteID of the item in the local cache. If the value is non-zero when Microsoft Outlook terminates suddenly, then the item was being processed during the termination. You can retrieve the item using NotesPeek. |
| Directory | CN=Server name!!AddressBookName.nsf | This setting is the local directory for the user specified in the common user name. It can be set by selecting a local address book from Domino Preferences. You can set this value manually to retrieve an address book from the server that is not in the address book list. |
Each of the managed user settings is a profile specific setting and is preceded by <common user name>_<common server name>_. Each profile can have up to ten managed users associated with it. Each of these users has a managed user number associated with him that is a number from 1 to 10. You can have additional profile specific settings for each of these managed users in the form
<common user name>_<common server name>_<common managed user name>_<common server name>_<profile specific setting>
where <profile specific> setting can be any of the profile specific settings listed earlier in this article with the exception of OUTLOOK_DATA_DIR and Directory, which do not apply to managed user. For example, you see settings similar to:
JohnDoe_MailServer1_JoeExecutive_MailServer1_SETUP=1
| Name | Value | Description |
|---|---|---|
| Manage_<managed user number>, in which <managed user number> is a number between 1 and 10 | CN=managed user server/O=Managed user Org!!Managed user mail file,Managed user Notes email address,Managed user days to get | There can be up to 10 managed users. This setting indicates the managed user represented by the number. |
| Manage_Count | A number between 0 and 10 | This setting indicates the number of users' mail files managed by the user in the common user name. |
| Manage_Store_<managed user number> | A store ID for the managed user number. Part of the PST information. The store (ID) is the top level of all folders in that store. | This setting specifies the mail store of the managed user. |
| Manage_Store1_<managed user number> | This is the above store ID continued. | This setting lists the mail store of the managed user continued from the Manage_Store_<managed user number> setting because the number can be too long for one value. |
| Manage_Inbox_<managed user number>, Manage_Calendar_<managed user number>, Manage_Contact_<managed user number>, and so on | Entry IDs: All objects in the PST have an entry ID. This is the PST equivalent of a NOTEID in a Notes database. | These settings list the entry ID of the corresponding special folder (Inbox, Calendar, Contacts, and so on) for the user specified by common user name. |
The archive settings are profile specific settings and are preceded by <common user name>_<common server name>_, for example:
JohnDoe_MailServer1_Manage_Count=1
Each profile can have up to thirteen archive stores associated with it. Each of these stores has a non-Lotus Domino Access for Microsoft Outlook store number associated with it that is a number from 1 to 13. Managed users cannot have archive stores associated with them.
An archive store is any Microsoft Outlook data file opened in Microsoft Outlook that is not a Lotus Domino Access for Microsoft Outlook store (a Lotus Domino Access for Microsoft Outlook store is either a managed user store or the main store for the user specified by common user name). These do not have to be created by archive or by auto-archive. Any store is searched for entries that may have been dragged and dropped from the mail store and should hence be removed from the server.
| Name | Value | Description |
|---|---|---|
| Archive_Store_<store number>, in which <store number> is a number between 1 and 13 | A store ID for the non-Lotus Domino Access for Microsoft Outlook store number. Part of the PST information. The store ID is the top level of all folders in that store. | This setting is the store ID of the specified archive store. |
| Archive_Store1_<store number> | This is the Archive_Store_<store number> ID continued. | The setting is the store ID of the Archive_Store_<store number> continued. |
| StoreStatus_<store number> | 0 = This store has not started checking its documents. 1 = This store is in the process of checking its documents. 2 = This store has already checked all its documents. | This settings tells whether or not the entries in this store have already been removed from the server. Removal doesn’t happen until the first restart of Lotus Domino Access for Microsoft Outlook after the store has been added to the folder list. |
You can add the following settings manually to your Notes.ini file to provide additional functionality. Some of these provide means for obtaining debug output, while others change the way that Microsoft Outlook displays address book entries.
| Name | Values | Description |
|---|---|---|
| REPL_PST_DEBUG | 0 = Disable the option 1 = Enable the option | This setting toggles on and off debug output that displays on a console if enabled. If set to 1, Lotus Domino Access for Microsoft Outlook captures all debug output, but be aware that this setting affects performance slightly. If set it to 0, you toggle off the debug output. This output is valuable to the Lotus Domino Access for Microsoft Outlook support team. |
| STX9 | 0 = Disable the option 1 = Enable the option | When set to 1, this settings shows the console so that the debug output can be seen in real-time. |
| CONSOLE_LOG_ENABLED | 0 = Disable the option 1 = Enable the option | When set to 1, this setting saves console information to console.log in your IBM_TECHNICAL_SUPPORT directory, which is located in your Lotus Domino Access for Microsoft Outlook program directory (single-user) or in your data directory (multi-user). |
| REPL_PST_TRUNCATE_OFF | 0 = Disable the option 1 = Enable the option | This setting prevents the cache file from being truncated. You can use this setting for troubleshooting purposes, but it may result in slower performance and a larger cache file. |
| ABSORT | 0 = Disable the option 1 = Enable the option | This setting presents address book entries in Last name, First name order wherever possible as opposed to by email address, which presents First name Last name/Org. At this time, this setting has not been tested to determine its affect on calendar and scheduling. |
| ALT_NAMES | 0 = Disable the option 1 = Enable the option | This setting indicates that alternate names should be used in profiles when possible (added by installer). It changes the display of the names in the address book. |
| DISBALEDYNCONFIG | 0 = Disable the option 1 = Enable the option | When set to 1, this setting prevents Lotus Domino Access for Microsoft Outlook from registering dynconfig as a callback. It disables dynconfig for Lotus Domino Access for Microsoft Outlook purposes. |
Using this article as a reference makes the Lotus Domino Access for Microsoft Outlook Notes.ini file less of a mystery and more of a tool. It contains information about product versions, profile settings, runtime conditions, managed users, and local archive stores. Additionally, it allows users to get debugging information and to change the way their address book displays names. When problems occur, the Notes.ini file is a good place to look for answers.
Learn
-
developerWorks Lotus Ask Professor INI articles
-
developerWorks Lotus tip, "Lotus Domino Access for Microsoft Outlook and Lotus Notes interoperability: I want my doclinks!"
-
developerWorks Lotus article, "Domino Access for Microsoft Outlook and the Domino Migration Tool"
- Lotus Domino Access for Microsoft Outlook product page
Get products and technologies
-
Download a trial version of Lotus Notes 7 from developerWorks.
-
Download a trial version of Lotus Domino 7 from developerWorks.
-
Download a trial version of Lotus Domino Access for Microsoft Outlook.
Discuss
-
Participate in the developerWorks blogs and join the developerWorks community.
Table of contents
Local resources
Tags
Use the slider bar to see more or fewer tags.
For articles in technology zones (such as Java technology, Linux, Open source, XML), Popular tags shows the top tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), Popular tags shows the top tags for just that product zone.
For articles in technology zones (such as Java technology, Linux, Open source, XML), My tags shows your tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), My tags shows your tags for just that product zone.
Popular article tags |
My article tagsSkip to tags list
Popular article tags |
My article tags
