RADE

Source Code Manager

adl_ls_tree

Listing existing trees

Quick Reference

Abstract

The adl_ls_tree command displays the list of all the trees managed on the current site.

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ls_tree ws_tree_name [-out file_name] [-program [-sep|-separator char]] [-h | -help | -?]

Usage

The name of a tree is necessary if you want to display the list of the workspaces belonging to a given tree. To display the list of the workspaces belonging to the same tree as the current workspace’s tree, it is not necessary to give the name of the tree.

Remark: in almost all the cases there is only one site on a LAN (Local Area Network).

Displayed data are:

Tree name
Contents server: shown as "machine:port"
Database
CAA Rules (Dassault-Systemes Internal)
Change request mode (Dassault-Systemes Internal)
Software level

It is possible either to put those results in a file, either to format them to be able to use them later in a program.

The “Contents server” part displays the value "machine:port" instead of the UUID.
In program mode, this part is divided into two parts: "machine" and "port".

The part "CAA rules" displays the value:

in a normal mode

either Checked if the rules are activated
or Not checked if the rules are not activated

with the -program option

either 1 if the rules are activated
or 0 if the rules are not activated

In program mode, possible values for the "Change request mode" part are:

either NONE for the development mode with no RI management
or OPTIONAL for the "mixed" mode, in which promotion can be done with or without a RI
or MANDATORY for the maintenance mode, in which all the promotions must be done with a RI

In program mode, the "software level" information are displayed as strings [2].. For more details, see the article explaining this option.

[Top]

Options

adl_ls_tree accepts the following options:

`-h\|-help\|-?`	Help of the command
`ws_tree_name`	Name of the tree
`-program`	Display the output in a program mode
`-sep char`	Separator between each field for programs (space " " by default)
`-separator char`	Separator between each field for programs (space " " by default)
`-out file_name`	Path to a file "file_name" for writing the results

Examples

Display all the trees in a normal mode:

adl_ls_tree

Tree name Contents server Database CAA rules Change request mode Software level ----------------------------------------------------------------------------------------------------------------  CptRoot2 karst:1 ADL1 Not checked None  T1Cga algue:2002 ADL1 Not checked None  T1Nle carter:5 ADL1 Not checked Optional  V5R8 T2cga algue:4 ADL1 Not checked None  V5R7 TU1Nle carter:5 ADL1 Checked Mandatory

Display of all the trees in a program mode:

adl_ls_tree -program -sep "|"

CptRoot2|karst|1|ADL1|0|NONE|\0
T1Cga|algue|2002|ADL1|0|NONE|\0
T1Nle|carter|5|ADL1|0|OPTIONAL|V5R8
T2cga|algue|4|ADL1|0|NONE|V5R7
TU1Nle|carter|5|ADL1|1|MANDATORY|\0

[Top]

References

[1]	adl_mk_tree: Creating a tree
[2]	Displaying strings in program mode

[Top]

History

Version: 3 [Nov 2001]	Document update
Version: 2 [Oct 2001]	New option -soft_level
Version: 1 [Mar 2001]	Document creation

[Top]