Shows check out information on files.
ss Status [VSS items] [-H] [-I-] [-N] [-O] [-P[project]] [-R] [-U[username]] [-Y] [-?]
Lists all checked-out files in the current project:
ss Status
Indicates whether TEST.C is 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 in $/TESTDATA. Does not show files shared into $/TESTDATA but checked out in other projects:
ss Status -P$/TESTDATA $/TESTDATA
The following table describes the command-line options available with this command.
| Option | Description |
| -O | Paginate or redirect the command output. |
| -R | Display recursive status through an entire project list. |
| -U | Display only files checked out to a certain user. |
| -P | Filters the list of checked-out files to include only files checked out to the current or specified project. |
| -I- | Ignore: Do not ask for input under any circumstances. |
| -N | Change between long and short file name mode. |
| -Y | Specify a username and/or password. |
| -?, -H | Request online Help on a command. |
You must have the Read access right to use this command.
If you have the same file checked out to multiple computers, the Status command shows the computer name as well as the check out path. If you checked out the file using UNC path format, the Status command uses this format in its return.
The -U option lists files checked out by the specified user. If you use the -U option with no username, the current user (you) is assumed. If you do not use the -U option at all, all checked-out files are displayed.
When a file is shared among multiple projects, if it is checked out from one project, it is checked out from all projects. For this reason, the Status Search command may actually show you files that are checked out to multiple projects, because they are shared. The -P option restricts 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.