add
Add files or an entire directory to Surround SCM to put files under source control. When you add a directory, a repository with the same name as the directory is created and files are added to the corresponding repository. Surround SCM optionally repeats the process recursively for all subdirectories.
sscm add Item1 [Item2 ...] [-fFieldID1:Value1 [-fFieldID2:Value2...]] [-h] [-q|-q+|-q-] [-ccComment|-cpCommentPath|-c-] [-g|-g-] [-k|-ke] [-w] [-bBranch] [-pRepository] [-r] [-vCodeReviewID|-v+] [-xChangelist] [-lLabel] [-tFileType] [-o] [-u] [[-sHelixALMConfigName][-iHelixALMUsername:HelixALMPassword] -aIssueNum1[:IssueNum2...] -mRequirementNum1[:RequirementNum2...] -nTestCaseNum1[:TestCaseNum2...] -eExternalID1[:ExternalID2...]] [-jStateID] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
| Option | Description |
|---|---|
| Item | Full path of a local file or directory, or a file or subdirectory name in current directory. Enter * to add all files and subdirectories or . to add all files and subdirectories in current directory. Use quotes in Unix if Item includes wildcard characters. |
| -a | Helix ALM issue number to attach files to. |
| -b | Branch to add the files to. 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. |
| -e | External ID for other issue tracking providers. |
| -f | Set custom field value when adding items. If FieldID is not specified, fields are set to the default values. FieldID: Custom field ID. Use lscustomfield to find the field ID. Value: Value to set custom field to. Leave value empty if you do not want to set a value. Valid values for CheckBox fields are checked and unchecked. DateTime types must use the format: yyyymmddhh:mm:ss. |
| -g | Get files after adding them. Enter -g- if you do not want to get files. |
| -h | Display online help for the command. |
| -i | Helix ALM username and password. |
| -j | Set workflow state to the specified State ID. Use lsstate to find the State ID. |
| -k | Exclusively check out files after adding them. |
| -l | Label for the added files. |
| -m | Helix ALM requirement number to attach files to. |
| -n | Helix ALM test case number to attach files to. |
| -o | Replace current file label. |
| -p | Full path to repository, including parent repositories. If not specified, default working directory repository is used. |
| -q | Use quiet mode to skip all prompts and results. Enter -q+ to display prompts without results. Enter -q- to skip prompts but display results. |
| -r | Recursively add files and subrepositories if Item is a directory or file name includes wildcard characters. |
| -s | Helix ALM connection name. Use lsttdb to find the connection name. |
| -t | File type (if migrated from another platform): Auto_Detect, Binary, Mac_Binary, Text, Text-CRLF, Text-LF, UTF8, UTF8-CRLF, UTF8-LF, or UTF16. On Mac, only files created by Mac editors can be automatically detected. |
| -u | Restore removed files and check in as new versions. |
| -v | Code review ID to add the changes to. Enter -v+ to create a new code review. New code reviews use the current username and timestamp for the review name and the current user as the only author. |
| -w | Make working directory files writable after adding and getting them. |
| -x | Changelist to add action 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. |
If you set a workflow state on the files to add, you may be prompted to enter an electronic signature for compliance purposes. Enter the signature information, which may include your Surround SCM username, password, and a reason for the change. The files are added after you enter the signature.