![]() |
![]() |
Valid for AIX JFS environments only
The dsmmode command sets one or more of the following execution modes to modify the HSM-related behavior of specific commands:
The dsmmode command also displays the current execution modes that are in effect. If you precede another command and its arguments with the dsmmode command, only the execution mode or modes that you specify remain in effect for that command and any child processes of that command. Specify valid options with the dsmmode command for any command that follows to run. If you do not specify options, any command and its associated arguments that follow are ignored.
If you enter the dsmmode command without another command, it starts a new shell and the execution mode or modes that you specify remain in effect until you exit the shell. The shell that starts is the one that you specified as your default shell in /etc/passwd. You can nest dsmmode commands within the new shell.
Syntax
>>-dsmmode--+--------------+--+----------------------------+--->< | .----------. | '- command and its arguments-' | V | | '--- options-+-'
Parameters
Value | Description |
---|---|
Normal or n | A migrated file appears to be resident, and the command can access the file. This is the default. |
Zero-length or z | A migrated file appears to be a zero-length file. |
Error or e | Any attempt to access a migrated file returns an EIO error. |
Mode | Description |
---|---|
Normal or n | The access time is set to the current time when a file is accessed. This is the default. |
Preserve or p | The access time and inode change time (ctime) do not change when the file
is read or its attributes are changed. You can specify this value to
prevent access times from changing when backup programs other than the TSM
backup-archive client program back up your files.
|
Value | Description |
---|---|
Normal or n | The HSM client performs demand migration to avoid returning errors to the user if possible, and attempting to recover from out-of-space conditions. This is the default. |
Error or e | The HSM client does not intercept out-of-space errors. |
The values that you can specify are:
Value | Description |
---|---|
Normal or n | When a migrated file is accessed, it is copied to its originating file system. If the file is not modified, it becomes a premigrated file. If the file is modified, it becomes a resident file. Normal is the default recall mode for a process. |
Migonclose or m | When a migrated file is accessed, the HSM client temporarily copies it to your local file system. If the file is not modified, the file is returned to a migrated state by replacing the file with a stub file on your local file system when it is closed. If the file is modified, it remains on your local file system as a resident file. |
Use the dsmattr command to set a recall mode for a migrated file to normal, migrate-on-close, or read-without-recall. See Table 13 for the recall modes that are used.
Attention: More than one process can access a file at a time. Another process can cause a file that you are accessing in migrate-on-close or read-without-recall mode to remain on your local file system as a resident or premigrated file. For example, if the recall mode that you set for a file is normal, and you access it with a process using the migrate-on-close recall mode and you do not modify the file, you would expect the file to be in a migrated state when you close it. But if someone else accesses the file at the same time with a process using normal recall mode or with a process that modifies the file in some way, the file remains on your local file system as either a resident or premigrated file, depending on the actions that the other process takes.
Examples
Task | Command |
---|---|
Display the current execution modes. | dsmmode |
Change the data access mode for a grep command to ensure that only resident and premigrated files are searched, and migrated files are not accessed and recalled. | dsmmode -Dataaccess=z grep \ spaceman * |