![]() |
![]() |
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
dsmattr -rm /home/user1/file1
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) |
|
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 |