notes.ini variable – Tolerate Replication Errors

This is an interesting one that I have not come across before. We all know there are undocumented (or under-documented) notes.ini variables that can manipulate various aspects of the Domino server or the Noes client. The one I came across here today was new to me:


What does it do?

Well, my current client has a rather large and very important application that we are trying to migrate to a new R8.5.2 server and we constantly running into replication errors. the reason for those errors are corrupted documents tat kill the replication process. I will not go into details as to the maintenance and othe attempts of fixing this dB we have done as it is not pertinent to the effect of the above variable.

IBM support gave us the variable with a hex code and asked us to enter it into the notes.ini via the Domino consoel nd the SET CONFIG command:


I was not sure if a reboot is necessary but is appears that is not the case, it takes effect immediately, here is what the effects on replciation are:

pull srv1 database.nsf
11/18/2011 11:40:05 AM  Remote console command issued by Victor Toal/xxx: pull srv1 database.nsf
pull srv1 database.nsf
11/18/2011 11:40:05 AM  Database Replicator started
11/18/2011 11:40:05 AM  Replicator is set to Ignore Database Quotas
GetTolerableErrors: adding 0x2C8=One or more of the source document's attachment are missing.  Run Fixup to delete the document in the source database.

As you can see, the variable adds a setting that lets the replicator ignore the indicated error – if that error appears in the replication stream the replicator task will simply skip over it and keep on going. From what I can tell right now you can only add one code at a time so I believe you cannot just add codes galore and have the replicator ignore every error there is.

The variable is not documented to receive the hex values that determine the codes the replicator will ignore you need to contact IBM support. But at least now you know that this variable exists and what it can do, armed with that knowledge you can request it when you next run into a similar situation and that this  might be a tool to help you solve your problem or correctly diagnose it.


3 thoughts on “notes.ini variable – Tolerate Replication Errors

  1. I think I may have been the one to provide that. The parameter does actually take a comma-separated list of exclusions, but the error codes aren’t documented, unfortunately. I’m out of the office for a few weeks, but I’ll see about documenting a list of common NSF error codes for use with that parameter. There may also be another parameter to ignore any errors. If not, we probably need to add that.


    • Thanks for the info, good to now it might take a comma separated list – that can make getting through replication errors easier! Looking forward to you giuys puttin gout the whole list someplace, maybe in the Domino Wiki? Happy Thanksgiving!


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s