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]
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.
/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:
This option does not remove extra or redundant files. This option ensures that you can examine the content of such files to verify that they are not required before deleting them.
/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.