IBM Support

Switches that can be used when running the Fixup task

Technote (FAQ)


In Lotus Domino, what options/switches can be used with the Fixup command and what do they do?


The following table describes the options you can use with Fixup. The first column lists the options as they appear when you run Fixup using the Fixup tool or the Task --> Start Tool option in Domino Administrator. The second column lists the equivalent command-line options that you use when you run Fixup using a console command or using a Program Document.

Fixup options in Fixup tool and Task --> Start tool Command-line equivalent Description
  • Fixup all databases
  • Fixup only this database or folder
database path "Fixup only this database or folder" runs Fixup only on a specified database or all databases in a specified folder. To run Fixup on a database in the Domino\Data folder, enter the file name such as SALES.NSF. To run Fixup on a database or databases in a folder within the Data folder, enter the path relative to the Data folder. For example, to run Fixup on all databases in the DATA\SALES folder, specify SALES.
"Fixup all databases" or no command line database path runs Fixup on all databases on the server.
NOTE: To specify databases or folders on which to run using the Fixup tool, select the database(s) or folder(s).
Report all processed databases to log file.
-L Reports to the log file every database opened by Fixup and checks for corruption. Without this argument, Fixup logs only actual problems encountered.

The ":(number)" parameter is not required but is an option for "-L".
Descriptions of each number specified for -L:
1: Log fixup view check start point (default, same as -L).
2: Additionally print to console each view check start point.
3: Additionally print to console all design notes.

Written as "fixup -L:1", "fixup -L:2", "fixup -L:3" (without quotes).
Scan only since last Fixup -I (capital i) When you run Fixup on a specific database, Fixup only checks documents modified since Fixup last ran. Without this option, Fixup checks all documents.
Scan all documents -F When you run Fixup on all databases, Fixup checks all documents in the databases. Without this option, Fixup checks only documents modified since it last ran.
NOTE: To specify this option using the Fixup tool, deselect "Scan only since last Fixup."
Perform quick Fixup -Q Causes Fixup to check documents more quickly but less thoroughly. Without this option, Fixup checks documents thoroughly.
Exclude views (faster) -V Prevents Fixup from running on views. This option reduces the time it takes Fixup to run. Use if view corruption isn't a problem.
Don't purge corrupted documents -N Prevents Fixup from purging corrupt documents so that the next time Fixup runs or the next time a user opens the database, Fixup must check the database again. Use this option to salvage data in documents if the corruption is minor or if there are no replicas of the database.
Optimize user unread lists -U Reverts ID tables in a database to the previous release format. Don't select this option unless Customer Support recommends doing so.
Fixup transaction-logged databases -J Causes Fixup to run on databases that are enabled for transaction logging. Without this option, Fixup generally doesn't run on logged databases.
If you are using a backup utility certified for Domino, it's important that you schedule a full backup of the database as soon as possible after Fixup finishes.

The following additional switches are available in Domino 6 and later releases:

Fixup open databases -O If you run Fixup on open databases, Fixup takes the databases offline to perform the Fixup. This is the default if you run Fixup and specify a database name. Without this option, when you do not specify database names, Fixup does not run on open databases.
Don't fixup open databases -Z Applies only to running Fixup on a single database. When a database isn't taken offline and is in use, then Fixup does not run. This is the default when Fixup is run on multiple databases.
Verify only -C Verifies the integrity of the database and reports errors. Does not modify the database such as purging corrupt documents.
Fixup subdirectories -Y Runs Fixup on databases in subfolders (subdirectories).
Don't fixup subdirectories -y Does not run Fixup on databases in subfolders (subdirectories).
Update this view only
Release 7.0 and higher only
database -T viewtitle
Updates a specific view in a database.
NOTE: You cannot use Indirect (.ind) files with the -T flag to specify a view.

Related information

A simplified Chinese translation is available

Historical Number


Document information

More support for: IBM Domino
Database Corruption

Software version: 5.0, 6.0, 6.5, 7.0, 8.0, 8.5

Operating system(s): AIX, Linux, Solaris, Windows

Reference #: 1102292

Modified date: 15 January 2009