ccm fs_check

This topic contains information about the ccm fs_check command.

Synopsis

ccm fs_check   [/d|/dir directory_path] [/f|/fix] [object_spec...]
               [/t|/type type][/v|/verbose]
               [/e|/empty_skip] [/u|/unused_skip]
               [/nd|/no_duplicates] [/w|/windows]
               [/nb|/null_byte][/z|/zero_counts]

Description and uses

Use the ccm fs_check command to check the consistency of a Rational® Synergy database file system. By default, the ccm fs_check command checks that:

Checking all the files in the cache and archive areas takes time and memory resources, and might be suppressed using the /u|/unused option.

Run ccm fs_check to check your entire database because this command can be used regularly to reduce the disk space taken up by cache files. However, as the check can take a long time on large databases, you can perform a quicker check by checking only specific types of objects. Use the /t option to check only objects of the specified type. Or check a list of objects using object_specs (for example, using query results). You cannot use both the /t option and a list of objects. If you check only objects of the specified type, checking for unused cache and archive entries are suppressed.

Also, direct the output to a file so that you can examine the results.

If unexpected or extra files or archive entries are found, they are reported individually and summarized at the end. However, such cases are not counted as errors and do not cause ccm fs_check to fail with a non-zero exit status.

The /fix option to ccm fs_check does not remove these extra entries. Doing so might lead to data loss in cases where you have created such files manually for your own purposes. Or where you have restored a file system and metadata backup taken at slightly different times. For assistance in removing unwanted extra cache and archive entries, contact IBM® Rational Software Suport.

All users can perform this operation. However, you must be in the ccm_admin role to perform the /fix option. You must start a session (using the ccm start command) before running this command.

Controlled files are subject to asynchronous archiving when they are checked in to a static state. This process requires that you allocate one extra back-end session per database for asynchronous archiving. If you plan to run the archive conversion, you must also allocate one additional back-end session for the archive conversion. Also, when an object has not been archived, you receive a warning that the file has not been archived.

For more details about asynchronous archiving, see the Rational Synergy Upgrade Instructions for Windows in the Installing and upgrading section of the Rational Synergy Information center.

Options and arguments

/d|/dir directory_path

Specifies the directory into which inconsistent archive entries are written. By default, these files are written to database_path\st_root\tmp\check.

/e|/empty_skip

Suppresses warnings about empty files for static object versions.

This warning can also be suppressed for individual object versions. Create a Boolean attribute deliberately_empty with the value TRUE on the object versions for which you want to suppress the warnings.

/f|/fix

Fixes some simple errors, such as:

/nd|/noduplicates

Specifies to skip checks for duplicate archive entries. Use this option to reduce the memory resources used when checking large databases that might otherwise fail from lack of memory. Because it reduces the strength of archive checking, only use when necessary.

/nb|/null_byte

Checks in the source attribute for null (0x00) bytes. Generates a warning message when objects of type ascii and subtypes of ascii contain null bytes.

object_spec

Provides a list of objects to check. You can use query results for this argument.

You cannot use this argument with the /t option. Using this option implies the /u|/unused_skip option.

/t|/type type

Specifies the type of objects to check.

You cannot use this option with object_spec. Using this option implies the /u|/unused_skip option.

/u|/unused_skip

Specifies to skip checks for extra files and entries in the cache and archive files. This option does not remove or delete files or entries.

/v|/verbose   

Generates more detailed information about each error. The errors report:

/z|/zero_counts

In the summary at the end, zero counts (reporting conditions not seen) are normally suppressed. If you use the /z option, all counts are printed, including those with zero values. This information can be useful when the output of fs_check is being analyzed by another program.

Example

Check the file system consistency of the database and provide detailed output information.

  1. Log on as the Rational Synergy administrator.
  2. Check the file system consistency of the database.

    ccm fs_check /v


Feedback