IBM Support

Recall all migrated files with Tivoli Storage Manager HSM for Windows

Technote (troubleshooting)


The dsmclc HSM command is used to retreieve all files migrated for a specific filespace. The dsmclc command may retrieve deleted files or renamed files in their original location.

Diagnosing the problem

File e:\file1.txt is migrated and then later renamed to e:\file1_new.txt. The dir command shows :

Volume in drive E is HSMDATA
Volume Serial Number is XXXX
Directory of E:\
02/08/2012 03:55 PM (6,776) file1_new.txt

On the Tivoli Storage Manager server, the file is migrated as "file1.txt". For example :

tsm: MYTSM>select * from archives where node_name='MYNODE'
LL_NAME: file1.txt
OBJECT_ID: nnnnn
ARCHIVE_DATE: 2012-02-08 15:58:49.000000

The following command will retrieve the file as file1.txt, not file1_new.txt.

dsmclc retrieve -g EDRIVE e: "*"

Resolving the problem

The HSM client is used to migrate files. Once migrated, files are renamed and directories are also renamed. Despite the file name change on the operating system where the HSM client runs, the name of the migrated file remains unchanged on the Tivoli Storage Manager server. Under such circumstances, instead of using the dsmclc command to retrieve all files, the dsmfind command should be used to obtain the list of currently migrated files.

dsmfind e:\ -r -s
Command Line HSM File Find Interface - Version 6, Release 3, Level 0.0
(c) Copyright by IBM Corporation and other(s) 2005, 2011. All Rights Reserved
Searching files matching pattern 'e:\' ...
Scanning disk for 'e:\' ...

You can then trigger an automatic recall of the files by accessing each file from Windows using a windows command like "type file1_new.txt" to read the contents of the file and trigger the recall. The file is then recalled using the current name of file1_new.txt in this example.

Document information

More support for: Tivoli Storage Manager HSM for Windows

Software version: 6.3, 6.4, 7.1

Operating system(s): Windows

Reference #: 1580766

Modified date: 30 November 2016

Translate this page: