Deliver change sets from a repository workspace to another
workspace or stream
Purpose
The scm deliver subcommand
delivers change sets from a named source to the default target or
another target you specify.
Synopsis
- To run scm deliver after you have used scm login to
create stored credentials:
scm deliver [ -r
| --repository-uri ] repository URI or nickname [ -d | --dir ] workspace-path { [ [ -q | --quiet ] | [ -v | --verbose ] ] [ -s | --source ] source workspace or stream [ -t | --target ] target workspace or stream change set ... }
- To run scm deliver and supply credentials
on the command line:
scm deliver [ -r | --repository-uri ] repository URI [ -u | --username ] user ID in repository [ -P | --password ] password for user ID in repository
[ -d | --dir ] workspace-path { [ [ -q | --quiet ] | [ -v | --verbose ] ] [ -s | --source ] source workspace or stream [ -t | --target ] target workspace or stream change set ... }
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.
- [ -q | --quiet ]
- Suppress most informational messages while
operating.
- [ -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
- [ -s | --source ] source
workspace or stream
- The name or UUID of the source workspace or stream. Change sets
are delivered from the source workspace to the target. If the target
is not specified, the current flow target for the source is used.
- [ -t | --target ] target
workspace or stream
- The name or UUID of the target workspace or stream.
- [ -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.
- [ -v | --verbose ]
- Provide additional informational messages
while operating.
- change set ...
- A list of zero or more change sets to deliver. You can specify
change sets by name, UUID, comment, or associated work item. If no
change sets are specified, all outgoing changes are delivered.
Examples
Working in a local workspace,
scm status output
shows that the local workspace contains an undelivered change set:
C:\local-workspaces\HelloJazz>scm status
Workspace: (1101) "HelloJazz" <-> (1102) "HelloJazz Stream"
Component: (1103) "HelloJazz"
Baseline: (1104) 2 "base"
Outgoing:
Change sets:
(1105) --@ <No comment>
Run
scm deliver,
specifying the change set by its alias, to deliver the change set.
scm deliver 1105
Delivering changes from "HelloJazz" into "HelloJazz Stream"
No baselines to flow.