Create repository objects.
Purpose
The scm create subcommand
creates repository workspaces or baselines.
Synopsis
- To run scm create after you have used scm login to
create stored credentials:
scm create workspace [ -r
| --repository-uri ] repository URI or nickname { [ -d | --description ] description [ -s | --stream ] Stream to set as default flow target } name
scm create baseline [ -r
| --repository-uri ] repository URI or nickname { --description description } [component [...] | --all] name
- To run scm create and supply credentials
on the command line:
scm create workspace [ -r | --repository-uri ] repository URI [ -u | --username ] user ID in repository [ -P | --password ] password for user ID in repository
{ [ -d | --description ] description [ -s | --stream ] Stream to set as default flow target } name
scm create baseline [ -r | --repository-uri ] repository URI [ -u | --username ] user ID in repository [ -P | --password ] password for user ID in repository
{ [ -d | --description ] description } [component [...] | --all] name
Options and arguments
- --all
- Create a for components in the named workspace. Not valid with create workspace.
- [ --changeset ]
- Create a new change set.
- [ --component ]
- Create a new component within
the specified workspace or stream.
- [ -d | --description ] description
- A description for the workspace or baseline. When used with scm create baseline,
only the long form of this option (--description)
is allowed.
- [ -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
- [ --snapshot ]
- Create a new snapshot associated with
the workspace or stream.
- [ -s | --stream ] Stream to set as default flow target
- The name of a stream to set as the default
flow target of the workspace. The stream must exist in the repository
specified by the -r option. Not valid with create
baseline.
- [ -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.
- component [...]
- A space-separated list of components, specified by name, alias,
or UUID, for which baselines will be created. You must specify a list
of components or include the --all option to
specify all components. Not valid with create workspace.
- name
- A name for the workspace or baseline.
Examples
Create a baseline named "beta2
updates" for all components in the repository workspace named HelloJazz,
using stored credentials for the repository nicknamed jazzhost:
C:\>scm create baseline -r jazzhost --all HelloJazz "beta2 updates"
After the baseline is created,
scm status shows
it in the workspace.
C:\local-workspaces\HelloJazz>scm status
Workspace: (1101) "HelloJazz" <-> (1102) "HelloJazz Stream"
Component: (1103) "HelloJazz"
Baseline: (1108) 3 "beta2 updates"
Outgoing:
Baselines:
(1108) 3 "beta2 updates"