share

Share files to make available a single copy of a file in multiple repositories. When the file is updated, all repositories reflect those updates simultaneously. Operations on the shared file are applied to the base (linked to) file. When a file is shared, the file history, file name, custom field values, and workflow state are maintained. Only the file location is different. If a file or repository is shared in a branch, any subsequent branches maintain the defined shared files.

sscm share SourceRepository [File1 File2 ...] [-bBranch] [-ccComment|-cpCommentPath|-c-] [-h] [-pDestinationRepository] [-r] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]

Option	Description
SourceRepository	Full source repository path.
File	Files to share. If files are not specified, entire repository is shared.
-b	Branch that contains files to share. 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.
-h	Display online help for the command.
-p	Full destination repository path. If not specified, default working directory repository is used.
-r	Recursively share all files and subrepositories in specified repository.
-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.