RADE

Source Code Manager

adl_ls_promo

Listing promotion requests

Quick Reference

Abstract

The adl_ls_promo command displays all the promotion requests that have been made from a given workspace

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ls_promo [workspace_name] [-tree ws_tree_name...] [-from rev1_or_date1] [-to rev2_or_date2] [-target dest_workspace_name] [-program [-sep|-separator char]] [-out file_path] [-h | -help | -?]

Usage

This command displays the promotion requests history of the current workspace or of the given workspace.

Data displayed are the following:

Promoted workspace revision (workspace_name.tree_name.number format)
Date of the promotion request (YYYY/MM/DD-hh:mm:ss)
Target workspace: the collector workspace of the promotion request
Status of the promotion request:
- Waiting :The promotion request is not yet collected. This status is only available for the last promotion request of a workspace.
- Collected: The promotion request has been collected in the workspace revision given by field "Collected in" at the date given in field "Collected or refused date".
- Renounced: The promotion request has been refused with adl_rm_promo command.
- Refused: the promotion request has been refused by the collector workspace with adl_rm_req command.
Date (YYYY/MM/DD-hh:mm:ss) of the collect (adl_collect command) or the refusal (adl_rm_promo or adl_rm_req) of the promotion request.
Collector workspace revision (workspace_name.tree_name.number format).

If the option -tree is used, only the promotion requests in these workspace trees are listed.
If the option -from or/and the option -to are used, a subset of promotion requests is listed.
If the option -program is used, the output is formatted to be used in a program.

See the [1] adl_promote command.

The "-program" option displays information in a specific output mode. For more details, see the article explaining this option.

[Top]

Options

adl_ls_promo accepts the following options:

`-h\|-help\|-?`	Help of the command
`workspace_name`	Name of the workspace to examine. Default is current.
`-tree ws_tree_name`.	Display only these workspace trees.
`-from rev1_or_date1`	Bound list to the promotion requests with rank greater than the given one or created after this date (date format: YYYY/MM/DD-hh:mm:ss, time is optional (00:00:00 by default)).
-to rev2_or_date2	Bound list to the promotion requests with rank lower than the given one or created before this date (date format: YYYY/MM/DD-hh:mm:ss, time is optional (00:00:00 by default)).
-target dest_workspace_name	Name of the workspace destination of the promotion request.
-program	Display for programs
-sep\|-separator char	Separator between each field for programs (space " " by default)
`-out file_path`	Path of the file where the results are stored.

Examples

Display all the promotion requests for the "W11" workspace:

adl_ls_promo W11
Promoted Revision  Date of promotion                          Target  Status      Collected or refused date              Collected in
--------------------------------------------------------------------------------------------------------------------------------------
W11.T1.40          Thursday, November 29, 2001 03:24:28 PM    W1      Collected   Thursday, April 11, 2002 07:10:40 PM   W1.T1.21
W11.T1.48          Tuesday, August 27, 2002 05:57:12 PM       W1      Collected   Tuesday, August 27, 2002 05:57:17 PM   W1.T1.33
W11.T1.62          Monday, October 07, 2002 11:30:43 AM       W1      Collected   Monday, October 07, 2002 11:31:47 AM   W1.T1.33
W11.T1.64          Monday, October 07, 2002 11:37:25 AM       W1      Renounced   Monday, October 07, 2002 11:37:35 AM
W11.T1.87          Monday, June 23, 2003 12:47:10 PM          W1      Collected   Monday, June 23, 2003 12:48:30 PM      W1.T1.37
W11.T1.90          Monday, July 21, 2003 05:58:53 PM          W1      Collected   Monday, July 21, 2003 06:03:35 PM      W1.T1.38
W11.T1.93          Monday, July 21, 2003 06:17:42 PM          W1      Waiting

Display all the promotion request for the "W11" workspace, with a program output:

adl_ch_ws MyWs

adl_ls_promo -program -sep

W11Nle.T1Nle.40|2001/11/29-15:24:28|W1Nle|COLLECTED|2002/04/11-19:10:40|W1Nle.T1Nle.21
W11Nle.T1Nle.48|2002/08/27-17:57:12|W1Nle|COLLECTED|2002/08/27-17:57:17|W1Nle.T1Nle.33
W11Nle.T1Nle.62|2002/10/07-11:30:43|W1Nle|COLLECTED|2002/10/07-11:31:47|W1Nle.T1Nle.33
W11Nle.T1Nle.64|2002/10/07-11:37:25|W1Nle|RENOUNCED|2002/10/07-11:37:35|
W11Nle.T1Nle.87|2003/06/23-12:47:10|W1Nle|COLLECTED|2003/06/23-12:48:30|W1Nle.T1Nle.37
W11Nle.T1Nle.90|2003/07/21-17:58:53|W1Nle|COLLECTED|2003/07/21-18:03:35|W1Nle.T1Nle.38
W11Nle.T1Nle.93|2003/07/21-18:17:42|W1Nle|WAITING||

Display the promotion requests for the "W11" workspace from the revision number 80 to the revision number 95:

adl_ls_promo W11 -from 80 -to 95
Promoted Revision  Date of promotion                          Target  Status      Collected or refused date              Collected in
--------------------------------------------------------------------------------------------------------------------------------------
W11.T1.87          Monday, June 23, 2003 12:47:10 PM          W1      Collected   Monday, June 23, 2003 12:48:30 PM      W1.T1.37
W11.T1.90          Monday, July 21, 2003 05:58:53 PM          W1      Collected   Monday, July 21, 2003 06:03:35 PM      W1.T1.38
W11.T1.93          Monday, July 21, 2003 06:17:42 PM          W1      Waiting

[Top]

References

[1]	adl_promote: Promoting modifications

[Top]

History

Version: 3 [Oct 2003]	Document update
Version: 2 [Nov 2001]	Document update
Version: 1 [Apr 2001]	Document creation

[Top]