RADE

Source Code Manager

adl_ds_ws

Displaying workspace's information

Quick Reference

Abstract

The adl_ds_ws command displays information about a workspace existing in one or more tree(s).

Synopsis
Usage
Options
Examples
Program Mode
References

Synopsis

Usage

A workspace is unique on a given site.

SCM offers an option to display the minimum information about the workspace. These are the same information as those displayed by the [2] adl_ch_ws command.

The default mode is to display all information about the workspace in all the trees where it is declared.
The default workspace is the current workspace. You can give another workspace name in another tree.

It is possible to limit the displayed information to some of the trees where the workspace is declared.

You can send the results to a file of your choice. With the -program option, you have internal Source Code Manager information relatives to the differences.

The "-program" option displays information in a specific output mode. Key words are given, associated with values. For more details, see the article explaining this option, and the "Program Mode" part of this help.

Options

adl_ds_ws accepts the following options:

`-h\|-help\|-?`	Help of the command
`workspace_name`	Name of the workspace to display, or its SCM identifier prefixed by "wsid:".
`-short`	Display only the minimum workspace's information
`-tree ws_tree_name`	Display the workspace's information about these workspace trees
`-all_trees`	Display all workspace's information. Default option.
`-to\|-target workspace_name`	Workspace name destination of the promotion request. The promotion information are displayed for this workspace
`-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

[Top]

Examples

Selection of the Dev2 workspace which exists in two trees:

E:\> adl_ds_ws
Current workspace:  Dev2
Current image: WINDOWS, Not refreshed, path: E:\users\cga\demo\dev2

Workspace tree(s):   Demo_tree1 Demo_tree2
Tool config key:     tck_adm_adls1 (inherited from parent workspace)
Merge solving delay: Immediate (If necessary, the interactive merger is launched at the end of the command)
Merge solving mode:  Automatic (The basic merges are solved automatically without user interactions)
Merge at collect:    Undetermined (allowed or forbidden according to the workspace tree)
Promotion request:   Allowed from workspaces to the current workspace
Child promotion:     Child workspaces must be synchronized with the last revision for promote
Flow traces:         Not stored
Synchronized:        Yes
Published:           No
Child collected:     No
Promoted:            No
Image(s):
   WINDOWS                Windows    Not refreshed   E:\users\cga\demo\dev2   on randdsy
   UNIX                   Unix       Refreshed       /u/users/cga/tmp/WS/dev2

Workspace tree:      Demo_tree1
Current revision:    25
Parent workspace:    Int_Application1
Merge at collect:    Allowed
Synchronized:        Yes   (public parent revision Int_Application1.Demo_tree1.13)
Published:           No
     rev 24      Monday, September 24, 2001 05:02:08 PM   PUBLIC
Child collected:     No
     Promotion requested by "dev5" on Tuesday, October 30, 2001 03:08:50 PM
Promoted:            No

Workspace tree:      Demo_tree2
Current revision:    2
Parent workspace:    Int_Application2
Merge at collect:    Forbidden
Synchronized:        Yes   (public parent revision Int_Application2.Demo_tree2.3)
Published:           No
     rev 1       Wednesday, June 13, 2001 11:11:29 AM   PUBLIC
Promoted:            No

Refresh:
               WINDOWS   UNIX
-----------------------------
Demo_tree1        N       Y
Demo_tree2        N       Y

               Synchronized   Published   Child collected   Promoted
--------------------------------------------------------------------
Demo_tree1          Y             N              N             N
Demo_tree2          Y             N              /             N

Selection of the dev2 workspace in one tree:

E\> adl_ds_ws -tree demo_tree1
Current workspace:  Dev2
Current image: WINDOWS, Not refreshed, path: E:\users\cga\demo\dev2


Workspace tree:      Demo_tree1
Current revision:    25
Parent workspace:    Int_Application1
Synchronized:        Yes   (public parent revision Int_Application1.Demo_tree1.13)
Published:           No
     rev 24      Monday, September 24, 2001 05:02:08 PM   PUBLIC
Child collected:     No
     Promotion requested by "dev5" on Tuesday, October 30, 2001 03:08:50 PM
Promoted:            No

Refresh:
               WINDOWS   UNIX
-----------------------------
Demo_tree1        N       Y

               Synchronized   Published   Child collected   Promoted
--------------------------------------------------------------------
Demo_tree1          Y             N              N             N

[Top]

Program Mode

When using the -program option, the command displays the results in a format that is usable by others programs. To have more details about the rules for using this format, see the reported article on the "-program" option.

[Top]

References

[1]
[2]

adl_ls_ws: Listing workspaces in a tree
adl_ch_ws: Changing workspace

[Top]

History

Version: 2 [Nov 2001]	Document update
Version: 1 [Feb 2001]	Document creation

[Top]