RADE

Source Code Manager

adl_ls_ws

Listing existing workspaces

Quick Reference

Abstract

The adl_ls_ws command displays the list of the workspaces existing in one or more tree(s).

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ls_ws [workspace_name] [-out file_name [-xml]] [-h | -help | -?]
adl_ls_ws -tree ws_tree_name... [-out file_name [-xml]]
adl_ls_ws -from workspace_name1 [-tree ws_tree_name...] [-out file_name [-xml]]
adl_ls_ws [-from workspace_name1] -to|-target workspace_name2 [-tree ws_tree_name...] [-out file_name [-xml]]

Usage

Workspaces are displayed in a tree format to explain the different branches between workspaces.

The name of the current workspace ([1] adl_ch_ws command) is displayed by the: ‘<<<<<<’ character string to the right of the workspace’s name.

If promotions are forbidden from a given workspace, the string "NO P" appears to the right of its name.

If synchronizations are forbidden in a given workspace, the string "No S" appears to the right of its name.

By default, the command displays the list of the workspaces belonging to the same tree as the current workspace. If this workspace is multi-tree, all the workspaces of all the trees are displayed.

You can limit the display to some of the trees, giving their names.

You can display the child workspaces of a current workspace, going down in the workspace hierarchy.

It is possible to display the parent workspaces, up to a given workspace.

[Top]

Options

adl_ls_ws accepts the following options:

`-h\|-help\|-?`	Help of the command
`workspace_name`	Name of the workspace whose workspace's tree is displayed
`-from ws_name1`	Workspace origin of the list. All the successive children of the workspace "ws_name1" are displayed
`-to\|-target ws_name2`	Workspace destination: All the successive children between the root workspace (or "ws_name1" if it's defined) and "ws_name2" are displayed
`-xml`	Display in XML format
`-out file_name`	Path to a file "file_name" for writing the results
`-tree ws_tree_name`	Name of the workspace tree which workspace's list will be displayed

Examples

Display all the workspaces belonging to the same tree as the current workspace, when this workspace belongs to only one tree:

adl_ls_ws

Display of all the workspaces belonging to the same tree as workspace "my_ws":

adl_ls_ws my_ws

Display of all the workspaces of the current workspace, when this workspace belongs to several trees:

adl_ls_ws

Display of the workspace belonging to the trees: "tree1" and "tree2":

adl_ls_ws -tree tree1 tree2

Display of the workspaces being between ws1 and ws2, in all the trees where ws1 and ws2 exist:

adl_ls_ws -from ws1 -to ws2

Display of the workspace created under ws1 in the tree1 tree:

adl_ls_ws -from ws1 -tree tree1

Display of the list of workspaces and result sent to the file "my_file":

adl_ls_ws -out my_file

Example of result:

adl_ls_ws </pre>
<pre>Workspace tree: TOOLSSDF 
- ToolsSDFINT created by caacx on Tuesday, October 05, 1999 04:22:43 PM 
! 
+- BSFTOOLSCXR5 created by bsfr on Friday, September 15, 2000 12:33:43 PM 
! ! 
! +- Mkmkcxr5_pmr_fix created by pmr on Monday, October 16, 2000 08:53:01 AM 
! ! 
! +- TCK_CXR5 created by cga on Monday, September 25, 2000 05:25:31 PM 
! ! 
! +- TWInstallCXR5 created by fte on Wednesday, September 27, 2000 11:04:49 AM 
! ! 
! +- Xaacxr5 created by lfh on Friday, September 15, 2000 05:11:42 PM 
! ! ! 
! ! +- CSI_Fix created by csi on Wednesday, September 20, 2000 08:12:50 AM 
! ! ! 
! ! +- XAAMieCXR5 created by mie on Friday, January 11, 2001 05:24:59 PM 
! ! 
! +- ebnfixTLCXR5 created by ebn on Thursday, September 21, 2000 06:31:40 PM 
! ! 
! +- odxToolsCXR5 created by odx on Monday, October 23, 2000 08:52:34 AM 
! 
+- BSFTOOLSSDF created by bsfr on Friday, November 05, 1999 12:30:33 PM 
! ! 
! +- pourouvertureCXR6 created by cga on Tuesday, November 21, 2000 03:07:15 PM 
! 
+- CAFINT created by odx on Tuesday, February 01, 2001 02:27:46 PM

Here is an output that shows three workspaces having the following characteristics:

the current workspace is "W11Nle"
"W11Nle" forbids promotions
"W111Nle" forbids promotions and synchronizations

adl_ls_ws -tree t2nle

Workspace tree: T2Nle
- W2Nle created by nle on mardi 14 mai 2002 12:16:12
!
+- W11Nle |No P| created by nle on mardi 21 mai 2002 17:30:27 <<<<<
!
+- W111Nle |No P / No S| created by nle on mardi 18 juin 2002 18:03:50

[Top]

References

[1]
[2]

adl_ch_ws: Changing workspace
adl_ds_ws: Displaying workspace status

[Top]

History

Version: 2 [Jan 2003]	Document update: new workspace characteristics displayed in output
Version: 1 [Feb 2001]	Document created

[Top]