promote

Promoting merges changes from the child branch up to the parent branch. Promote a branch when you finish making revisions are ready to share your changes. This ensures the ancestor branch includes the most current files and other users have access to your changes. To promote specific files or repositories, see promotefile.

sscm promote ChildBranch [-ccComment|-cpCommentPath|-c-] [-h] [-pRepository] [-s] [-uUpperBranch] [-v] [-y[Username:Password|+|=]] [-mLabelApply] [-lLabelSearch] [-tTimeStamp] [-aStateID] [-bSnapshotBranch] [[-qHelixALMConfigName][-iHelixALMUsername:HelixALMPassword] -dIssueNum1[:IssueNum2...] -xRequirementNum1[:RequirementNum2...] -oTestCaseNum1[:TestCaseNum2...]] -eExternalID1[:ExternalID2...] [-zSCMServerAddr:PortNum|zPath] [+u]

Option Description
ChildBranch Child branch name. Enter @ to use default working directory branch.
-a StateID to search for. The latest file version in this state is retrieved. Use lsstate to find StateID. Cannot use with -l, -n, or -t.
-b Snapshot branch to promote from. Cannot be used with -a, -l, or -t. If -a, -b, -l, or -t is not specified, the newest file versions in the child branch are promoted.
-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.
-d Helix ALM issue number to attach files to.
-e External issue to attach files to.
-h Display online help for the command.
-i Helix ALM username and password.
-k Ignore broken share warnings.
-l Label used to select versions of files to promote. Only versions with this label are promoted.
-m Label to apply to promoted files in the destination.
-n Snapshot branch to promote from. Cannot be used with -a, -l, or -t.
-o Helix ALM test case number to attach files to.
-p Mainline branch or Full path to repository, including parent repositories.
-q Helix ALM connection name. Use lsttdb to find connection name.
-s Skip server auto-merge
-t Local timestamp used to select versions of files to promote. Format: yyyymmddhh:mm:ss. Cannot use with -a, -l, or -n.
-u Ancestor branch to promote changes to.
-v Preview result of promoting the branch.
-x Helix ALM requirement number to attach files to.
-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.