mscd

mscd
Prev	DCS Command Reference	Next

Name

mscd — Change the MSS working directory

Synopsis

mscd [-project proj] [directory]

Description

The mscd command changes the MSS working directory used by the DCS commands. When invoked with no operands, mscd attempts to change to the user´s MSS top-level directory (based on the user´s current uid). If the directory does not exist, an error message is printed and the current working directory remains unchanged.

Important

In order to use the mscd command, you must first initialize your environment with mscdsetup(1NCAR).

Note

The mscd alias or command runs on the user's system (i.e. the DCS Client system).

See the section called “Directory Behavior” for more details about how the MSS manages directories automatically.

Options

-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

directory: An absolute or relative pathname of the directory that becomes the new MSS working directory.

Examples

Example 6. Using mscd.

eval `mscdsetup -csh`  # (setup for csh users)
mspwd                  # print your default MSS working directory
mscd /PAT/data/2003    # change the directory
msls                   # list the MSS files in /PAT/data/2003
mscd                   # change back to your default MSS working directory

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.