gwcheck (1)


gwcheck - GroupWise Check Utility


gwcheck [--opt=[/path_name/]options_file [--batch] ] 


GroupWise Check (GWCheck) is a tool provided for GroupWise to check and repair GroupWise user, message, library, and resource databases without needing the Administration Console. In addition to checking and repairing databases in the post office, it also checks and repairs users’ remote, caching, and archive databases on user workstations or other personal locations.

GWCheck provides a user interface similar to the Mailbox/Library Maintenance feature in the GroupWise Admin console. The list below illustrates the types of database repair that you can perform using GWCheck. Click Help in GWCheck for more information about the database repair options that are available.

Analyze/Fix Databases

     Index Check
     Collect Statistics
     Attachment File Check
Fix Problems
     Update User Disk Space Totals

Expire/Reduce Messages

Reduce Only
Expire and Reduce
     Items Older Than
     Downloaded Items Older Than
     Items Larger Than
     Trash Older Than
     Reduce Mailbox To
     Reduce Mailbox to Limited Size
     Received Items
     Sent Items
     Calendar Items
     Only Backed-Up Items
     Only Retained Items

Mailbox Statistics

Mailbox Statistics
     Box Limit
Expire Statistics
     (same as the Expire and Reduce options)

Archive/Delete Documents

(no options)

Delete Activity Logs

Delete Logs Older Than nn Days

Analyze/Fix Library

Verify Library
Fix Document/Version/Element
Verify Document Files
Validate All Document Security
Synchronize User Name
Remove Deleted Storage Areas
     Move Documents First
Reassign Orphaned Documents
     New Author
Reset Word Lists

Audit Report

Log Accounts without Activity for Previous nn Days

GWCheck Options File

If you repeatedly use the same set of database repair options, you can save them in an options file. To create an options file, start GWCheck, select database repair options as needed, then click Save. By default, the options file is named gwcheck.opt and is saved in your home folder. You can change the file name and location as needed.

You can retrieve the options file from the user interface or you can specify the options file on the command line. The options file is created in XML format.

After you have created one or more options files, you can run GWCheck as a script, rather than using the user interface.


Usage Options:


Specifies a database maintenance options file created in a GWCheck session. This starts GWCheck with the same options settings as the session in which the options file was created.

By default, this file is saved in your home folder. If you want to save it to another folder, specify a path relative to your home folder or specify an absolute path.


Runs GWCheck in the background, without a user interface. Use an options file to specify the database repair options.


Specifies the path to the post office folder.


Specifies the path to the archive folder.


Specifies the path to the remote mailbox folder.

Help Options:

--help , -?

Displays the help information and exits.



Options file. Create this file by setting database repair options in GWCheck, then click Save. The options file is created in XML format.


This program normally runs as root.


Starts the GUI GWCheck.

/opt/novell/groupwise/admin/ --opt=gwcheck.opt --batch

Starts GWCheck with an options file that provides default database repair options and runs it in batch mode so that there is no user interface.

/opt/novell/groupwise/admin/ --opt=gwcheck.opt --pa=/home/gsmith/gwarchive

Runs GWCheck for an archive mailbox.

See Also