create

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

  • To run scm create supplying 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 [...] | --allname

Options and arguments

--all
Create a for components in the named workspace. Not valid with create workspace.
-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
-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"


Feedback

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