RADE

Source Code Manager

adl_promote

Promoting modifications

Quick Reference

Abstract

The adl_promote command promotes the last revision of the current workspace.

Synopsis
Usage
What do you promote? What do you collect?
Options
Prerequisite commands
Simulation
Examples
References

Synopsis

adl_promote [-to|-target workspace_name...] {[-tree ws_tree_name...] [-old]} | [-ws_rev ws_rev] [-no_ds] [-simul [-no_check_caa_rules]] [-desc description [-cr CR...]]
[-program [-sep |-separator char]] [-out file_path] [-h | -help | -?]

Usage

A promotion takes into account all modifications since the last synchronization.
Beware: There is no auto-publication for a workspace having or having had at least one child (move or delete of a child). In this case, the publication of the workspace is necessary before the promotion.

With the “–old” option, you can promote the modifications of the last public revision (without label) (instead of the modifications of the last revision which must be public without label in the other cases).
Beware: in the case of a leaf workspace, if the promotion is done with the “–old” option, there is no auto-publication.

When a workspace runs a promotion, his collector's workspace will accept the promotion, with the [1] adl_collect promotion.

Different modification cases calling for a promotion (Promoted = No):

Creation of objects
Check-out followed by modifications followed by a check-in
Deletion of objects
Move of objects
Rename of objects
Synchronization with resolved merge
Collect with or without merge

Different modification cases possibly calling for promotion (Promoted = ?):

Check-out (without any modifications, such as creation, move, delete or rename of objects… since the last promotion) followed by modifications
Check-out without any modification

Different modification cases not calling for a promotion (Promoted = Yes):

Synchronization without merge to solve
Attach only
Check-out only followed by an uncheck-out
Check-out only without any modifications followed by a photo

What do you promote? What do you collect?

`Step`	Child Workspace	`Step`	Parent Workspace
1	Modification 1 Promotion: Modification 1
		2	Collect: Modification 1 Publication
3	Synchronization Modification 2 Promotion: Modification 2
		4	Collect: Modification 2 (Publication)
5	Modification 3 Promotion: Modifications 2 + 3
		6	Collect: Modification 3 Publication

An option let’s you specify that the last published version must be promoted and not the last version. The default behavior is that the workspace must be published before being promoted (note that publication is automatically made for the leaf workspace).

By default, the command displays the list of the modifications promoted to the parent workspace; an option exist, preventing this display.

State:

1. Publication if necessary and if the workspace has never had any children
2. Uncheck-out of checked-out files, if they have not been modified
3. Promotion

[Top]

Options

adl_promote accepts the following options:

`-h\|-help\|-?`	Help of the command
`-to\|-target workspace_name ...`	Workspace(s) name destination of the promotion request: child or parent workspaces.
`-tree ws_tree_name ...`	Promote only these workspace trees.
`-old`	The modifications of the last published revision are promoted instead of the last workspace revision.
`-ws_rev`	The workspace revision to consider, with the format "ws.tree[.{number\|label\|last\|date}]" (date format: YYYY/MM/DD-hh:mm:ss, time is optional (00:00:00 by default)).
`-no_ds`	No display
`-simul`	To simulate the promotion request. If the last workspace revision is promoted, the check in of all checked out file elements are simulated too.
-`no_check_caa_rules`	Can be used along with -simul option. It prevents to call the C++ Source Checker product to verify rules on the promoted set of files. Use the [4] adl_ls_tree command to know whether rules are checked.
-`desc description`	Description for the opened change set without description. If more than one opened change set is associated to the current workspace, adl_close_cs command must be executed before adl_promote.
-`cr` CR...	Change request names for the opened change set without description (internal DS only).
`-program`	Display for programs [5]
`-sep separator`	Separator between each field for programs (default value is blank)
`-separator separator`	Separator between each field for programs (default value is blank)
`-out file_path`	Path to a file for writing the results.

[Top]

Prerequisite commands

[2] adl_sync; the workspace must be synchronized before running the adl_promote
[3] adl_publish if the “–old” option is not specified, for the workspaces having at least one child, or having had at least one child.

[Top]

Simulation

With the “-simul” option, you can simulate a promotion, without validating it. At the beginning and at the end of the simulation, the following messages are displayed:

--- Beginning of simulation ---
...
--- End of simulation ---

These messages explain the use of the “-simul” option, and reassure the user.
A control that would cancel a command in usual mode, becomes a warning in simulation mode.

For example, an “adl_promote” is refused if the parent workspace has blocked the requests for promotion, but an “adl_promote –simul” will display a message indicating the refusal of these promotion requests, but will finish the promotion simulation. You can see the list of all the promoted modifications.

[Top]

Examples

Promote of the “MyWs” workspace:

adl_ch_ws MyWs
adl_promote

Promote of the “MyWs” workspace in a simulation mode:

adl_ch_ws MyWs
adl_promote -simul
--- Simulation start ---
Verifying the promotion rules.
!WNG! ADLCMD - 1721: The workspace "MyWs" is not synchronized with the last revision published of the workspace "MyParentWs" in the workspace tree "ToolsTree".
Run the command adl_sync to synchronize the workspace.

Promoting the workspace "MyWs" to "MyParentWs" in the workspace tree "ToolsTree".
AdeleFwDoc\MySecondModule.m\src has been created
AdeleFwDoc\MySecondModule.m\src\MyFile.doc has been created
AdeleFwDoc\MyFirstModule.m\src\MyFirstFile.doc has been modified
AdeleFwDoc\MyFirstModule.m\src\MyOtherFile.doc has been deleted

--- Simulation end ---

Promote one of the my "MyWs" workspace, promotion sent to the "AnotherParentWs" workspace:

adl_promote -to AnotherParentWs

Promote of the current workspace, only in the tree "ToolsTree":

adl_promote -tree ToolsTree

[Top]

References

[1]
[2]
[3]
[4]
[5]

adl_collect: Collecting promotion
adl_sync: Synchronizing workspace
adl_publish: Publishing workspace
adl_ls_tree: Listing trees
adl_promote in program mode

[Top]

History

Version 4 [Nov 2004]	Document update : -desc option added
Version 3 [Jan 2004]	Document update : -ws_rev option added
Version 2 [Mar 2002]	Support of output for programs
Version: 1 [Mar 2001]	Document created

[Top]