RADE

Source Code Manager

adl_mk_image

Creating an image

Quick Reference

Abstract

The adl_mk_image command creates a new image for an existing workspace in an exiting tree.

Synopsis
Usage
Naming rules
Options
Examples
References

Synopsis

adl_mk_image [image_name] -dir directory [-local_dir] [-force] [-ws workspace_name] [-tck tool_config_key] [-h | -help | -?]

Usage

When creating a workspace, the creation of a first image is can be done. Afterwards, you can create as many images as you want in a workspace.

An image is identified by a name and by a projection directory. This creation goes with the projection of all the objects of the associated workspace. The projection directory has to be accessible at the moment the image is created.

Name of an image:
This name will be used later as the parameter of the “–image” option for the [2] adl_ch_ws command. By default, image names are UNIX and/or WINDOWS depending on the operating system. If only one image is enough, it is not useful to precise the name of the image.

The image is specified by a name and by a root directory associated with the workspace. The last part of the directory is created if it does not already exist. The rest of the path must exist.
Example: adl_mk_image –dir \\machine_nt\home\users\xxx\Image1
\\machine_nt\home\users\xxx must exist and the Image1 directory is created if it did not exist.

Using the “–local_dir” option, you can specify that the image is local to the current machine. This means that if no option is specified, the system considers that the directory can always be seen from the access path given at the creation.

By default, the command verifies that the access path is not already associated with another image. However, an option allows the specification of a directory already used when creating another image (for another workspace for example). This option is useful with multi-tree workspaces, if you often use the same projection from the different trees where the workspace is declared.

A refresh is automatically performed when creating a new image, to project all the files belonging to the workspace (see [4] adl_refresh command).

If several images exist for the same workspace, only the current image is refreshed by the different commands ([5] adl_sync, [6] adl_collect…), the others images must be refreshed using the [4] adl_refresh command.

To begin working with the new image of your workspace, run the [2] adl_ch_ws command with the name of the new image as parameter.

[Top]

Naming rules

The basic naming rules for the naming of an image of a workspace are the following rules:

Maximum length of the directory: 512 characters.
Under UNIX: if the “–local_dir” option is not entered, the directory must begin with /u/lego or with /u/users.
Under WINDOWS: if the “–local_dir” option is not entered, the directory must begin with \\machine\ or with //machine/.

For more information on the naming rules, see the [7] naming rules document.

[Top]

Options

adl_mk_image accepts the following options:

`-h\|-help\|-?`	Help of the command
`image_name`	Name of the new image. Default names are "UNIX" and "WINDOWS"
`-dir directory`	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
`-ws workspace_name`	Name of the workspace's image to create
`-tck tool_config_key`	The tool config key associated to the workspace

[Top]

Examples

Creation of the "MyNewImage" image in the "MyWs" workspace:

adl_ch_ws MyWs
adl_mk_image MyNewImage -dir MyNewImageDir

or

adl_mk_image MyNewImage -dir MyNewImageDir -ws MyWs

Creation of the "MyNewImage" image in the "MyWs" workspace, with the directory locally declared:

adl_ch_ws MyWs
adl_mk_image MyNewImage -dir MyNewImageDir -local_dir

Creation of the "MyNewImage" image in the "MyWs" workspace with an old directory name:

adl_ch_ws MyWs
adl_mk_image MyNewImage -dir MyNewImageDir -force

or

adl_mk_image MyNewImage -dir MyNewImageDir -ws MyWs -force

Creation of a "MyWsDev" workspace under a "WsPrj" workspace, having three images: two images: "image1" and "image2" on UNIX and one image "imageNT" on NT:

adl_mk_ws MyWsDev –parent_ws WsPrj -image image1 -dir /u/users/user_name/SCM/MyWsDevUnix1
on UNIX:
adl_mk_image image2 –ws MyWsDev -dir /u/users/user_name/SCM/MyWsDevUnix2
on NT:
adl_mk_image imageNT –ws MyWsDev -dir //machineNT/users/user_name/SCM/MyWsDevNT1

Creation of the "MyNewImage" image in the "MyWs" workspace, using the "MyOwnTck" Tool Config Key:

adl_ch_ws MyWs
adl_mk_image MyNewImage -dir MyNewImageDir -tck MyOwnTck

[Top]

References

[1]
[2]
[3]
[4]
[5]
[6]
[7]

adl_ls_ws: listing workspaces in a tree
adl_ch_ws: changing to a workspace
adl_mk_ws: creating a workspace
adl_refresh: refreshing an image
adl_sync: synchronizing a workspace
adl_collect: collecting a workspace
naming rules document

[Top]

History

Version: 1 [Mar 2001]

Document created

[Top]