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 and supply 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
- [ --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 for Rational Team Concert for System z.
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>