RADE |
Source Code Manager |
adl_mk_root_wsCreating a root workspace |
| Quick Reference | ||
AbstractThe adl_mk_root_ws command creates a root workspace in an existing tree. |
adl_mk_root_ws workspace_name -tree ws_tree_name -tck tool_config_key {[-image image_name] -dir directory [-local_dir] [-force]}|-no_image [-h | -help | -?]
A workspace is unique on a given site.
This command must be run after the [3] adl_mk_tree command, and
before the creation of any other workspace, with the [2]
adl_mk_ws command.
Only one workspace can be created at a given time, on a given site. To know the name of
the workspaces on a given site, run the [1]
adl_ls_ws command.
The name of the root workspace can be used later as parameter of the “-parent_ws” option of the adl_mk_ws command. As this workspace is the root of the tree, it cannot make a standard promotion, but can make a promotion to a particular workspace (see the “–to” option of the adl_promote command).
The creation of the workspace can be done at the same time as the creation of an image.
This image is specified by a name: image_name (optional) and an associated root directory:
directory.
With the “–local_dir” option, you can specify that the image is local to
the current machine. If no option is specified, the system considers that the image can
always be seen from the access path given at the creation.
With the “–force” option, you can give a path to a directory already
associated with another image.
To find out more on naming rules for image directories, refer to the [4] adl_mk_image command.
An option to create the workspace without any associated image is available. Note that it is possible to create one, or more, image(s) later, using the [4] adl_mk_image command.
For more information on the naming rules, see the [5] naming rules document.
[Top]
adl_mk_root_ws accepts the following options:
| -h|-help|-? | Help of the command |
| workspace_name | Name of the root workspace |
| -tree ws_tree_name | Name of the tree in which the root workspace will be created |
| -all_trees | The workspace will be created in all the trees where the parent workspace exists |
| -tck tool_config_key | The tool config key associated to the workspace |
| -image image_name | Name of the image. Default names are "UNIX" and "WINDOWS" |
| -dir directory_name | Path of the image to create. If this directory does not exist, it will be created |
| -local_dir | The path is local to the current host |
| -force | Ignore the old image created in the same directory |
| -no_image | No image will be created for the workspace |
[Top]
Creation of the "MyRootWs" workspace in the tree "ToolsTree" with the "MyToolsConfig" TCK (Tools Configuration Key) in the "/u/users/AdministratorName/MyRootWs" directory:
adl_mk_root_ws MyRootWs -tree ToolsTree -tck MyToolsConfig -dir /u/users/AdministratorName/MyRootWs |
Creation of the "MyRootWs" workspace in the tree "ToolsTree" with the "MyToolsConfig" TCK with the "UnixRootImage" image:
adl_mk_root_ws MyRootWs -tree ToolsTree -tck MyToolsConfig -dir /u/users/AdministratorName/MyRootWs -image UnixRootImage |
Creation of the "MyRootWs" workspace in the tree "ToolsTree" with the "MyToolsConfig" TCK, in a local directory already used before, but the administrator wants to use this directory again:
adl_mk_root_ws MyRootWs -tree ToolsTree -tck MyToolsConfig -force -dir /u/users/AdministratorName/MyRootWs -local_dir |
[Top]
| [1] [2] [3] [4] [5] |
adl_ls_ws: Listing workspaces in a tree adl_mk_ws: Creating a workspace adl_mk_tree: Creating a tree adl_mk_image: Creating an image naming rules document |
[Top]
| Version: 1 [Mar 2001] | Document created |
[Top]
Copyright © 2001, Dassault Systèmes. All rights reserved.