Skip to main content

Software  >  Lotus  >  

Compact -c -L generating a "Function to-be-defined" error message.

 Technote (FAQ)
 
 
Question
What causes the "Function to-be-defined" error message to appear when running a compact -c -L, or sometimes when just running a compact -L command?
 
Answer
The compact -L switch allows the end user to continue to access the database when the compact is in use. This leads to errors when the database is in use and a "copy-style" compaction is indicated.
The compact -c (copy-style compaction) creates a new empty database container on the same server with the same replica ID, renames the original database to a .tmp file, and then copies all of the documents from the original database to the new database container. After all documents have been populated in the new database, the old .tmp database is then deleted.

Given that Domino cannot rename or delete a database that's in use, when you issue a compact -c -L, if a user accesses and edits a database during the copy-style compact, compacting is canceled. Unfortunately, instead of getting an error message that describes why the compact -c failed, you get an error message that states "Function to-be-defined."

Please also note that even if you're running a compact -L (with no -c switch) this error can still appear if compact determines that there's a pending structural change to a database. Examples of pending structural changes that would trigger a compact to run like a compact -c would be enabling or disabling the "Document table bitmap optimization" database property, upgrading the ODS, or enabling and disabling the "unread marks" database property.

The workaround to this issue is to not use the -L switch when attempting to run a compact to make structural changes to a database and allow compact to gain exclusive access to the database.
 
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Messaging Applications
 Advanced Messaging
 Lotus Domino
 Lotus Domino Server
 Operating system(s):
  Windows
 Software version:
  6.5, 7.0, 8.0, 8.5
 Reference #:
  1409977
 IBM Group:
 Software Group
 Modified date:
 2009-11-06

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.