load

Purpose

The scm load subcommand loads the components in a repository workspace into a local workspace. The local workspace is created if it does not exist.

Synopsis

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

  scm load workspace [ -r  |  --repository-uri ] repository URI or nickname
   [ -d  |  --dir ] workspace-path { [ -q  |  --quiet ] [ -f  |  --force ] }

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

  scm load workspace [ -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 ] [ -f  |  --force ] }

Options and arguments

workspace

The name, alias, or UUID of the repository workspace to load.

[ -d  |  --dir ] workspace-path

Files and folders from the specified workspace will be loaded into this path name. The path name is created if it does not already exist. If this option is omitted, scm load creates a new local folder as a subdirectory of the current working directory. The new folder has the name of the specified workspace.

[ -f  |  --force ] 

Overwrite existing files when loading.

[ -L  |  --local-rules ] Load rule path

Load rule path specifies the path name of the load rules file for a component in the local workspace. Not valid when more than one component is specified.

[ -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  |  --remote-rules ] Load rule path

Load rule path specifies the path name of the load rules file for a component in the repository workspace. Not valid when more than one component is specified.

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

component...

A space-separated list of components to load. Specify components by name, alias, or UUID. If this option is omitted, all components in the specified workspace are loaded.

Examples