DSMCFS version 1.0.0.0 README

1. What it does
2. Installation & compatibility
3. Usage Notes


1. What it does:

DSMCFS is designed to identify files that were not properly migrated to the
Tivoli Storage Manager server due to APARs IC50501 or IC51437. DSMCFS
retrieves the content for each file, then compares the current length of the
file with the original (pre-migration) length.


2. Installation:

Unzip dsmcfs.zip, which contains these files:

  dsmcfs.dll
  dsmcfs.exe

Copy dsmcfs.exe and dsmcfs.dll into your "HSM for Windows" installation
directory (usually C:\Program Files\Tivoli\TSM\hsmclient). DSMCFS requires
"HSM for Windows" version 5.3.4.0 or higher.


3. Usage Notes:

Run DSMCFS without any parameters for syntax.

DSMCFS retrieves the file content from the Tivoli Storage Manager Server and
counts the number of bytes in the file. The file is not written to disk.
However, the utility does require a minimal amount of temporary disk space. It
is recommended that you create a dedicated directory for DSMCFS to use. You
will need to specify the name of this directory when you run DSMCFS.

Because of Tivoli Storage Manager security restrictions, DSMCFS can check only
files migrated from the computer where it is installed. Therefore you need to
install and run DSMCFS on every computer where "HSM for Windows" has performed
file migration.

Since DSMCFS retrieves the entire file from the Tivoli Storage Manager server,
DSMCFS might appear to "freeze" while it is receiving data, especially for
very large files. This behavior is expected, and is normal, so do not stop the
utility. Your Tivoli Storage Manager server administrator can use the
QUERY SESSION command to check the status of DSMCFS sessions.

Only corrupt files or files that experienced other errors during retrieval are
displayed on the console. Information for all files that were checked can be
found in file <your_HSM_for_Window_install_dir>/logs/dsmcfs.log.

If you redirect the DSMCFS output to a file with the ">" operator, it is
recommended that you also use "2>&1" in order to redirect both standard output
and error output.

Depending on the number of files and the size of the files, DSMCFS can take a
long time to run. The computer should not be rebooted while the utility is
running, or else you will have to restart the utility from the beginning after
the reboot. Ensure that no auto-reboot of the computer takes place (for
example, after an automatic Windows Update).