renamebranch
Rename mainline, baseline, workspace, or snapshot branches at any time.
When you rename a mainline branch, the mainline root repository and root repositories for child branches, including snapshot branches, are also renamed.
sscm renamebranch CurrentName NewName [-pBaseRepository] [-ccComment|-cpCommentPath|-c-] [-h] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
Option | Description |
---|---|
CurrentName | Current branch name. |
NewName | New branch name. |
-c | Enter a comment or the comment text file path. Enter -cc to prompt for comment, -cp to prompt for the comment file path, or -c- if a comment is not needed. CommentPath can be full path of a local text file, partial path if file is in a subdirectory of current directory, or file name if file is in current directory. |
-h | Display online help for the command. |
-p | Branch's root repository (that contains all other repositories). If not specified, default working directory repository is used. |
-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. |