shelf
Add new or modified files in a working directory to a new or existing shelf. Shelves are temporary containers on the Surround SCM Server where you can store new and modified files before adding or checking them in to Surround SCM. You can use shelves to back up your work or to share files with other users before they are checked in.
sscm shelf Item1 [Item2...] [-nShelfName] [-bBranch] [-f] [-pRepository] [-r] [-i] [-llatest|-loriginal|-lleave] [-w] [-h] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
Option | Description |
---|---|
Item | Files to add to the shelf. Enter / to use the repository specified in -p or the default working directory repository. Use quotes in Unix if Item includes wildcard characters. |
-b | Branch that contains the modified files to shelve. If not specified, default working directory branch is used. |
-f | Force overwrite of existing file in shelf. |
-h | Display online help for the command. |
-i | Add new files if Item is a repository or the file name includes wildcard characters. |
-l | How to handle working directory files: -llatest: Replace working directory files with the latest server version and undo check out if files are checked out -loriginal: Replace working directory files with the original server version and undo check out if files are checked out -lleave: Leave working directory files as is |
-n | Shelf name. If owner only has one shelf, this option does not need to be specified. Must be specified if user has multiple shelves or no shelves. Entering a shelf name that does not exist creates a new shelf with the specified name. |
-p | Full path to repository, including parent repositories. If not specified, default working directory repository is used. |
-r | Recursively add modified files if Item is a repository or the file name includes wildcard characters. Use with -i to recursively add new files. |
-w | Make working directory files writable after shelving them. |
-y | Enter a Surround SCM username and password if you do not want to use the default value. To use single sign-on, enter -y+. If you use an identity provider to authenticate, the provider web page opens if you have not yet authenticated. Authenticate with the provider and then return to the CLI. |
-z | Enter the Surround SCM Server host computer address and port number if you do not want to use the default value. IPv6 addresses must be in square brackets. If you received a server settings file from your Surround SCM administrator, enter the path to the XML file instead of entering the server connection information. |
+u | Display output in Unicode (Windows only). Output cannot be sent to a file. If output is enabled for all commands, enter +u- to disable it for this command. |