addlabel

Create a new label when you need to mark related file revisions in a branch, such as files affected by a bug fix. This is helpful when related files are stored in different repositories and you need a way to group the files.

You can create labels for a mainline branch or a specific branch. The label can only be applied to labels in the branch it is created in.

You can also create labels when you add, check in, and promote files, or label a file version in a committed changelist or the file history.

sscm addlabel LabelName [-bBranch] -pMainlineName [-dDescription] [-h] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [-i|-i-] [+u]

Option Description
LabelName New label name.
-b Branch the label is scoped to. If not specified, the label will be global to the mainline.
-d Label description.
-h Display online help for the command.
-i Hide the label. Enter -i- to set the new label to not hidden. If not specified, the label will be not hidden.
-p Mainline branch.
-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.