changeset

Modify a change set comment or close an open change set.

Purpose

The scm changeset subcommand enables you to close an open change set or modify the comment on an open or closed change set.

Synopsis

Options and arguments

--associate ]  
Associate a change set with a work item.
-d  |  --dir ] workspace-path
The path name of a local workspace created by scm load or scm share. This subcommand runs with workspace-path set as the current working directory. You can omit this option if the current working directory is in a local workspace.
--disassociate ]  
Remove a change set from a work item.
-P  |  --password ] password for user ID in repository
The password for the specified user ID in the named repository. If this option is not included on the command line, you are prompted for a password. If you specified a repository URI or nickname for which you have stored credentials using the scm login command, this option is ignored.
--relocate ]  
Move changes between change sets.
-r  |  --repository-uri ] repository URI
Specifies the repository in which to take this action. If you have stored repository credentials using the scm login command, you can use the nickname you supplied for these stored credentials
--resume ]  
Resumes change sets into a workspace.
--suspend ]  
Suspends change sets from a workspace.
-u  |  --username ] user ID in repository
Specifies a user ID that exists in the named repository. If you specified a repository URI or nickname for which you have stored credentials using the scm login command, this option is ignored.
-w  |  --workspace ]
Workspace containing the change set to close. Not valid with scm changeset comment
change set
Name, alias, or UUID of the change set to operate on.
comment
New comment text. Not valid with scm changeset close

Examples

Working in a local workspace, scm status output indicates that there is an active change set in the workspace.

C:\local-workspaces\HelloJazz>scm status
Workspace: (1101) "HelloJazz" <-> (1102) "HelloJazz Stream"
  Component: (1103) "HelloJazz"
    Baseline: (1104) 2 "base"
    Outgoing:
      Change sets:
        (1107) --@ <No comment>

Run scm changeset close, specifying the change set by its alias, to close the change set.

C:\local-workspaces\HelloJazz>scm changeset close 1107
Change set closed.

If you run scm status again, you can see that the status flag associated with the change set is now $, indicating that the change set is closed. For more information about SCM status flags, see Working in the command line.

C:\local-workspaces\HelloJazz>scm status
Workspace: (1101) "HelloJazz" <-> (1102) "HelloJazz Stream"
  Component: (1103) "HelloJazz"
    Baseline: (1104) 2 "base"
    Outgoing:
      Change sets:
        (1107) --$ <No comment>


Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug