Manage Learn to apply best practices and optimize your operations.

Moving an iNotes mail file to a new directory on the server

How to move an iNotes mail file to a new directory/subdirectory by making two simple configuration changes.

My company is in the midst of an iNotes roll out. Our userbase is spread out across multiple locations throughout the United States. Subsets of our iNotes users periodically switch from one location to another. When devising a filepath naming convention, we decided to include the user's location as part of the filepath in order to simplify administration. Our model iNotes URL is: servername/mail/location/username.nsf

Recently, when we had to implement our first location change, we experienced a problem. When we moved John Doe from "LocationA" to "LocationB",

 from "servername/mail/LocationA/jdoe.nsf"
 to "servername/mail/LocationB/jdoe.nsf"

He could no longer synchronize his iNotes subscription. He received the error message "File Does Not Exist" in the Synchronization Status column of the iNotes Sync Manager.

According to Lotus Support TechNote #180667, you will receive this error after moving the "main DOLS-enabled database" to a new directory or subdirectory. In the case of iNotes, the user's mail file is the main (and only) DOLS-enabled database in the application. The TechNotes's solution is as follows: "To avoid this issue, do not move the main database after it has been enabled for DOLS".

We found this to be unacceptable. Given the nature of our userbase, we have to be able to move iNotes mail files from directory to directory as circumstances warrant. So I began to dig into the iNotes/DOLS infrastructure and, after getting a fair amount of dirt under my fingernails, came up with the following solution:

You can move an iNotes mail file to a new directory/subdirectory, if you make two very simple changes to the iNotes mail file's DOLS Offline Configuration profile document. This document defines, among other things, what will be synchronized and when it will be synchronized. Here are the steps:

1. Physically move the mail file to the new directory.

2. From somewhere within the mail file, run the following code:

 v := @Subset(@DbName; -1);
 @SetProfileField("DOLSOfflineConfiguration" ; "RequiredFilesToReplicate"; v );
 @SetProfileField("DOLSOfflineConfiguration" ; "MainNSF"; v )

 [I placed the code behind an action visible from the Inbox]

That's it. Once you've run the code, the user will be able to successfully synchronize his/her iNotes mail file from its new location on the server.
see above

Dig Deeper on Lotus Notes Domino Administration Tools

Start the conversation

Send me notifications when other members comment.

Please create a username to comment.




  • iSeries tutorials's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...