setstate
Manually set the workflow state to change the status of a file in the lifecycle.
sscm setstate Item StateID [-bBranch] [-pRepository] [-r] [-h] [-vVersion] [-ccComment|-cpCommentPath|-c-] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
| Option | Description |
|---|---|
| Item | File or repository to set state on. Use quotes in Unix if Item includes wildcard characters. |
| StateID | State ID. Use lsstate to find state ID. |
| -b | 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. |
| -h | Display online help for the command. |
| -p | Full path to repository, including parent repositories. If not specified, default working directory repository is used. |
| -r | Recursively set state on files if Item is a repository or the file name includes wildcard characters. |
| -v | File version to set state on. |
| -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. |
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 file status changes after you enter the signature.