Name

mscomment — Change an MSS file's comment.

Synopsis

mscomment [-project proj] [-R] (1) password options [-comment comment] path...


(1) [-rpwd read_password] [-wpwd write_password]

Description

The mscomment utility changes the comment associated with MSS files.

Options

Mscomment specific options:

-R

Recursively set the comment. For each operand that names a directory, mscomment shall set the specified comment on all MSS files in the hierarchy.

-c[omment] comment

Specify the comment. The comment must be between 1 and 80 characters, and must be appropriately quoted if it contains whitespace or other characters that will be interpreted by the local shell.

-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.

The common password related options are:

-rpwd password

Supply the read password for the following MSS files. If another read password was specified prior to this point in this command line, and the following MSS files do no have a read password, a null password must be given: -rpwd ''. If the MSS files do not have a read password, this option must not be used.

-wpwd password

Supply the write password for the following MSS files. If another write password was specified prior to this point in this command line, and the following MSS files do no have a write password, a null password must be given: -wpwd ''. If the MSS files do not have a write password, this option must not be used.

Operands

path

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

Example

Example 14. Set a comment.

This example sets the comment of the MSS file mydata, which has a write password.

mscomment -wpwd yoyo -c 'This is a comment' mydata

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.

See Also

msallinfo(1NCAR), msfind(1NCAR), msls(1NCAR), msrawinfo(1NCAR), msrcp(1NCAR)

Copyright

2008 University Corporation for Atmospheric Research, all rights reserved.