RADE

Source Code Manager

adl_mk_fw

Creating a framework

Quick Reference

Abstract

The adl_mk_fw command creates one or more framework(s) in the current image of the current workspace.

Synopsis
Usage
Naming rules
Options
Examples
References

Synopsis

adl_mk_fw framework_name... [-force] [-tree ws_tree_name] -resp responsible_name [-h | -help | -?]

Usage

Once the framework is created, it is automatically created:

In the other images of the workspace when the next refresh is done
In the parent workspace when the next promotion/collect is done
In the child workspaces, by an attach

When a framework must be created in a multi-tree workspace, you have to precise in which tree this framework is created. It is useless to give the name of the tree if the workspace belongs to only one tree.

A user is associated with each framework: by default it is the current user. There is no user management in the SCM databases. No verification is done on the manager associated with a framework.

After running the adl_mk_fw command in an image, you cannot launch any modification command (creation, move, rename, delete, or modification of content), in another image of the same workspace, till the image is refreshed.

Naming rules

The basic naming rules are:

Maximum length: 32 characters.
Minimum length: 1 character
Extension: optional.

The rules for use are:

You cannot create a framework with the same name in the same workspace in the same tree or in another tree, nor in the same image, nor in another image.
You can create a framework with the same name in another tree in another workspace. There will be a conflict when an attachment or a synchronization will be done. In this case, a framework with a Conflictxxx extension is created in the workspace (the action is assimilated to a name change).
You can create a framework with the same name in the same tree in another workspace, using the “–force” option. There will be a conflict when an attachment or a synchronization will be done. In this case, a framework with a Conflictxxx extension is created in the workspace (the action is assimilated to a name change). This option allows to reuse a framework name, when the framework has been deleted.

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

[Top]

Options

adl_mk_ws accepts the following options:

`-h\|-help\|-?`	Help of the command
`framework_name ...`	Name of the new framework
`-force`	Ignore frameworks whose names conflict with the one to create
`-tree tree_name`	Name of the tree in which the workspace will be created
`-resp responsible_name`	Name of the framework's responsible

Examples

Creation of the "MyFwDev" framework in the "MyWsDev" workspace:

adl_ch_ws MyWsDev
adl_mk_fw MyFwDev -resp user1

Creation of the "MyFw" framework in the "MyWsDev" workspace in the tree "ToolsTree":

adl_mk_fw MyFw -tree ToolsTree -resp user1

Creation of the "MyFw" framework, using an old framework name:

adl_ch_ws MyWsDev
adl_mk_fw MyFw -force -resp user1

[Top]

References

[1]
[2]

adl_ls_fw: listing workspace
naming rules document

[Top]

History

Version: 2 [Mar 2001]	Document update: -resp option mandatory
Version: 1 [Mar 2001]	Document created

[Top]