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 ConsoleOne. 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 ConsoleOne. 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 directory. 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 on all platforms. Therefore, you can create the options file on any platform and use it on any platform interchangeably.

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 the name of the options file. By default, this file is saved in your home directory. If you want to save it to another directory, specify a path relative to your home directory 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 directory.


Specifies the path to the archive directory.


Specifies the path to the remote mailbox database.

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 on all platforms. Therefore, you can create the options file on any platform and use it on any platform interchangeably.


This program normally runs as root.


Starts the GUI GWCheck.

/opt/novell/groupwise/gwcheck/bin/gwcheck --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/gwcheck/bin/gwcheck --opt=gwcheck.opt --pa=/home/gsmith/gwarchive

Runs GWCheck for an archive mailbox.


For information about GWCheck error messages, see Troubleshooting 1: Error Messages.


Copyright 2004-2012, Novell, Inc.. All rights reserved.

See Also

gwcheckt (1).

To report problems with this software or its documentation, visit Novell Bugzilla..