promotefile

Promoting files updates specific files or repositories in an ancestor branch with changes made in a child branch. Promote files to the parent branch when you finish making changes. Files can be promoted without affecting other items in the branch. To promote a branch, see promote.

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

Option	Description
Item	Files or repository. Enter / to use repository specified in -p or the default working directory repository. Use quotes in Unix if Item includes wildcard characters.
-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	Child branch that contains files or repository. If not specified, default working directory branch is used.
-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	Full path to repository in the child branch, including parent repositories.
-q	Helix ALM connection name. Use lsttdb to find connection name.
-r	Recursively promote files if Item is a repository or file name includes wildcard characters.
-s	Skip server auto-merge.
-t	Local timestamp used to select versions of files to promote. Format: yyymmddhh:mm:ss. Cannot use with -a, -l, or -n.
-u	Ancestor branch to promote changes to.
-v	Preview result of promoting files.
-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.