unshelf
Unshelve to get and optionally remove files from a shelf. Unshelve files when you complete work and are ready to check them in or when you need to retrieve a local copy of files.
sscm unshelf [Item1 [Item2...]] [-pMainlineName] [-nShelfName] [-oOwner] [-h] [-bBranch] [-d] [-r] [-e] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
Option | Description |
---|---|
Item | Files to unshelve. If not specified, all files are unshelved. |
-b | Retrieve the files to the specified branch's working directory. If not specified, default working directory branch is used. |
-d | Local directory to retrieve the files to. |
-e | Delete shelf. Must use with -p. Shelf must be empty after unshelving files to be deleted. |
-h | Display online help for the command. |
-n | Shelf name. Must specify if user has multiple shelves or no shelves. Do not need to specify if owner only has one shelf. |
-o | Shelf username. If not specified, owner defaults to current user. |
-p | Mainline branch name. Must specify if files are specified. This option is required if using -e to delete an empty shelf after unshelving files. |
-r | Remove files from shelf after retrieving 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. |