Status (Command Line)

Shows checkout information on files. For definitions of the command options, see Command Options in this Help system.

Syntax

ss Status [<items>] [-H] [-I-] [-N] [-O] [-P<project>] [-R] [-U<username>] [-Y] [-?]

Project Rights

You must have the Read project right to use this command.

Remarks

If you have the same file checked out to multiple computers, the Status command shows the computer name, as well as the checkout path. If you checked out the file using the UNC path format, the Status command uses this format in its return.

When a file is shared among multiple projects, you check it out from all projects upon checkout. For this reason, the Status command will show you files that are checked out to multiple projects if they are shared. Use the -P option to restrict the display to files that were checked out from a certain project. By default, this is the project on which you are performing the status search.

Examples

Lists all files checked out in the current project:

ss Status

Lists the status of the file Test.c that has been checked out by user Joyce:

ss Status TEST.C -UJoyce

Shows every file in the system that is checked out by the current user:

ss Status $/ -R -U

Shows files in the $/TESTDATA project that are checked out, but does not show files shared into $/TESTDATA but checked out in other projects:

ss Status -P$/TESTDATA $/TESTDATA

See Also

Reference

-P Option (Command Line)

Other Resources

Command Line Commands
Command Options