wchkdb [-o outfile] [-t] [-u] [-x] -f infile

wchkdb [-o outfile] [-t] [-u] [-x] -i

wchkdb [-o outfile] [-t] [-u] [-x] object...

The wchkdb command verifies and repairs problems in the Tivoli database. This command does not affect any system files; it only modifies resources within the Tivoli region.

Without the -u option, wchkdb only verifies the database and reports discrepancies to standard output or, optionally, to an output file if the -o option is used. The output file can later be passed to wchkdb with the -u and -f options to correct the discrepancies.

The -u option attempts to find and fix any database discrepancies. The -f option reads input from an output file generated in a previous run of wchkdb. All objects in the infile are checked. The -i option reads a list of objects from standard input. You can also specify a list of objects on the command line. If no input options or object references are provided, all objects in the database are checked.

The -x option enables verification across Tivoli region boundaries. Without this option, only resources within the current region are verified and repaired.

In a high-activity Tivoli environment, it can be advantageous to place a Tivoli management region in maintenance mode, thereby stopping all active Tivoli processes. For more information about placing a Tivoli region in maintenance mode, see Tivoli Management Framework Maintenance and Troubleshooting Guide.

-f infile

Reads the specified input file, which was created during a previous database check, and checks only those objects listed in the file. Only objects that failed during the previous run are included in the file.

-i

Reads a list of objects from standard input. The list consists of object IDs, object names, or both (each separated by a space).

-o outfile

Writes a binary version of the displayed output to the specified file name.

-t

Verifies and repairs object references in only the Tivoli server database.

-u

Updates the database, fixing any discrepancies found in the Tivoli resource database.

-x

Verifies and repairs object references across region boundaries.

object...

Specifies an object ID or object name to be verified and repaired.

senior or super

0

Indicates that the operation started successfully.

nonzero

Indicates that the operation did not start successfully, either because of a syntax error or because the object dispatcher is not available.

1. The following example verifies and, if needed, repairs the Tivoli database. Object references are checked across Tivoli region boundaries.

   wchkdb -u -x

2. The following example verifies object references in the current Tivoli region only. No changes are made to the Tivoli database. Problems , however, are displayed to standard output and written to the /tmp/check.out binary output file.

   wchkdb -o /tmp/check.out

3. The following example reads the results from a previous run of wchkdb invocation (/tmp/check.out) and updates the Tivoli database as needed:

   wchkdb -u -f /tmp/check.out