Tivoli Header

Tivoli Space Manager for UNIX Using the Hierarchical Storage Management Clients

dsmattr

Valid on AIX JFS file systems only

The dsmattr command sets or changes the recall mode for one or more migrated files. The recall mode determines how the HSM client recalls a migrated file when you access it. You can specify normal, migrate-on-close, or read-without-recall mode. You cannot set a recall mode for a resident or a premigrated file. The recall mode that you set for a migrated file remains associated with that file only as long as the file remains migrated.

See "Recalling Your Migrated Files" for more information.

Attention: Do not set the recall mode to read-without-recall for a file residing on a file system that an NFS server exported. This mode holds recalled file data in memory. It is not compatible with NFS access, which uses asynchronous reads. If you accidentally set this attribute on a file that a remote NFS client accesses, the HSM client recalls the file and automatically sets the recall attribute of the file to normal.

Syntax

                              .---------------.
                              V               |
>>-dsmattr--+--------------+------ filespec---+----------------><
            | .----------. |
            | V          | |
            '--- options-+-'
 
 

Parameters

options
Use one or both of the following options:. For example, to change the recall mode to migrate-on-close for a file named /home/user1/file1, enter:
   dsmattr -rm /home/user1/file1

-RECAllmode=value or -rvalue
Sets a recall mode for one or more migrated files. If you do not use the -RECAllmode option, the HSM client displays the current recall mode for the files that you specify. The values that you can select are:
Value Description
- Indicates that the file has not migrated.
Normal (n) Recalls the migrated file to its originating file system. This is the default. If the file is not modified, it becomes a premigrated file. If the file is modified, it becomes a resident file.
Migonclose (m) Temporarily recalls a migrated file to its originating file system. If the file is not modified, the file is replaced with a stub file on your local file system. The file returns to a migrated state when it is closed.
Readwithoutrecall (r)
Note:
The Readwithoutrecall parameter is valid for a 32-bit client only.
Reads the migrated file from storage without storing it on your local file system. Information is read sequentially from your file and is cached in a memory buffer on your workstation.

-RECUrsive or -R
Sets or displays the recall mode for migrated files in the directory and subdirectories that you specify.

filespec

Attention: This parameter is required only when you set a new recall mode. If you do not use the -RECAllmode option, and you do not specify a path and a file name, the current recall mode displays for all files in the current directory.

The path and file name of the file for which you want to set a new recall mode, or display the current recall mode. You can specify a single file, a group of files, or a directory. If you specify a directory, the HSM client sets or displays that recall mode for each migrated file in the directory.

You can use wildcard characters to specify a group of files with similar names. You can enter more than one file specification in a command. If you enter several file specifications, separate each specification with one or more blank spaces.

Examples

Task Command
Change the recall mode to migrate-on-close for a file named /home/user1/file1. dsmattr -rm /home/user1/file1
Change the recall mode to read-without-recall for all migrated files that begin with JAN in the/home/user1 directory. dsmattr -rr /home/user1/JAN*
Change the recall mode to migrate-on-close for all migrated files in the /home/user1 directory and all of its subdirectories. dsmattr -rm -R /home/user1
Display the recall modes that are assigned to all files in the current directory. dsmattr


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]