load

Load components from a repository workspace into a local workspace.

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

Options and arguments

workspace
The name, alias, or UUID of the repository workspace to load.
remote-path
List of remote items to load, may be a component (name, alias, or UUID), or a remote path within a component.
--all ]  
Selects all components. Priority is given to explicitely selected components in the case of a conflict.
-a  |  --alternative-name ] arg
Alternative name for the item specified in remote-path.
-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.
-i  |  --include-root ]  
Load component roots as directories in the filesystem.
-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
-t  |  --target ] arg 
Optional local path where changes should be loaded.
-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

Load the entire contents of repository workspace named HelloJazz, using stored credentials for the repository nicknamed jazzhost, into a new subdirectory of C:\local-workspaces:

C:\local-workspaces> scm load -r jazzhost HelloJazz
Downloading /com.example.hellojazz.rcp.ui/.project  (689 B)
Downloading /com.example.hellojazz.rcp.ui/build.properties  (109 B)
Downloading /com.example.hellojazz.service/plugin.xml  (529 B)
Downloading /com.example.hellojazz.service/.project  (690 B)
Downloading /com.example.hellojazz.service/build.properties  (109 B)
Downloading /com.example.hellojazz.client.tests/TestHelloJazz.launch  (2.6 KB)
Downloading /com.example.hellojazz.rcp.ui/.classpath  (307 B)
Downloading /com.example.hellojazz.rcp.ui/HelloJazzClient.launch  (1.7 KB)


Feedback

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