RADE

Source Code Manager

adl_promote_is

Promoting modifications in intersite workspace

Quick Reference

Abstract

The adl_promote_is command is an intersite command that is used in the process of setting up an intersite transfer between the current workspace and a workspace of another SCM site. 


Synopsis

adl_promote_is component... [-transfer transfer_name] [-tree ws_tree_name] [-cr change_request_number] [-h | -help | -?]
 

Usage

The adl_promote_is command is used after having declared [1] an intersite transfer between a local workspace and another workspace of another remote site. It is used to promote modification realized in the local workspace of the local site, to the parent remote workspace of the remote site. For more details on the inter-site shared components, see the [2] inter-site transfer article.

The command operates from the current workspace to the remote mirror workspace: then an internal promotion is automatically done from the mirror workspace to the parent remote workspace. The parent remote workspace can then run the adl_collect command. Transfers are then done between a site and another site.

adl_promote_is provides less options than the adl_promote command.

If the local workspace is defined as a multi tree workspace, the adl_promote_is command is automatically launched in all the trees where the workspace is defined. See the [3] adl_link_is_transfer command.

[Top]

Options

adl_promote_is accepts the following options:

-h|-help|-? Help of the command
-transfer transfer_name Name of an existing transfer of the current workspace.
-tree ws_tree_name Name of the workspace tree in which the framework(s) will be attached
-cr change_request_number Change request identifier

[Top]

Examples

Promotion of the current workspace where a transfer named "Transfer1" has been set up, to the remote parent workspace.

adl_promote_is -transfer Transfer1
...

 

Promotion of the current workspace to the remote parent workspace, where a change request number is needed (in maintenance mode).

adl_ch_ws MyRootLocalWs
adl_promote_is -cr Change_Request_Number

 

Having a transfer set up between several workspace trees of the current workspace, promotion of the current workspace, in the tree ToolsTree:  

adl_promote_is -tree ToolsTree -transfer Transfer1

[Top]


References

[1] adl_mk_is_transfer: Creating an intersite transfer
[2] Inter site transfer: Sharing components between SCM sites
[3] adl_link_is_transfer: Linking worskpace in several trees

[Top]


History

Version: 1 [June 2002] Document created

[Top]


Copyright © 2002, Dassault Systèmes. All rights reserved.