mstouch

mstouch
Prev	DCS Command Reference	Next

Name

mstouch — Update the last reference time for an MSS file.

Synopsis

mstouch [-project proj] [-R] path...

Description

The mstouch utility updates the last reference time of the specified MSS files if their class of service is usage=normal.

Note

The last reference time is not the same as the last write time. That is, msls -l will not show an updated modification time after the use of mstouch. Instead, use msls -P.

Warning

MSS files with a class of service of usage=backup behave differently. The mstouch command will not affect them. See msclass(1NCAR) and msretention(1NCAR) for more information.

Options

mstouch specific options:

-R: Recursively touch MSS files. For each operand that names a directory, mstouch shall touch all MSS files in the directory tree.
-p[roject] proj: Supply proj as the project number for charging. Currently, no charging is done for metadata operations, so this option is a placeholder for when charging might be imposed.

Operands

path: A pathname of an MSS file whose reference time is to be updated. If the recursive option (-R) is set, then all MSS files contained within the directory hierarchy named by path will have their last reference time modified.

Environment Variables

See Environment Variables section of the Command Behavior and Envrionment chapter for details.

Exit Status

See Exit Status Codes section of the Command Behavior and Environment chapter for details.