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

  • To run scm changeset after you have used scm login to create stored credentials:

    scm changeset close { [ -d  |  --dir ] workspace-path [ -w  |  --workspace ]} change set

    scm changeset comment { [ -d  |  --dir ] workspace-path } change set comment

  • To run scm changeset supplying credentials on the command line:

    scm changeset close { [ -r  |  --repository-uri ] repository URI [ -u  |  --username ] user ID in repository [ -P  |  --password ] password for user ID in repository [ -d  |  --dir ] workspace-path [ -w  |  --workspace ]} change set

    scm changeset comment { [ -r  |  --repository-uri ] repository URI [ -u  |  --username ] user ID in repository [ -P  |  --password ] password for user ID in repository [ -d  |  --dir ] workspace-path } change set comment

Options and arguments

[ -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.
[ -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.
[ -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
[ -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>

Related concepts
About change sets
Feedback

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