RADE

Source Code Manager

adl_ds_cs

Displaying change set

Quick Reference

Abstract

The adl_ds_cs command displays information of a change set.

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ds_cs [change_set] [-ws workspace_name] [-full_info] [-no_chg | -hist_chg] [-locate_chg] [-program [-sep|-separator char]] [-out file_path] [-h|-help|-?]

Usage

This command displays change set information of change_set or current change set in workspace (defined by the option -ws, otherwise the current worksp
ace).
Displayed information are by default:
- the change set's own attributes,
- the change set's included changes (created, moved in).
The reference workspace is defined by the option -ws, otherwise by the current workspace if exists.
For each change, if its object exists in the reference workspace, its path is displayed, else the identifiers of the object and of the change are displayed.
If the reference workspace exists, for each change, the information seen or not in the workspace is shown.

With this command, you can know what changes have been made in a change set and for which purpose or change request.

Asking for the information of current change set in the current workspace.

>adl_ds_cs
Change set: feb_RootT1Feb_6 State: Opened Desc:
Created by feb with adl_ch_cs on Tuesday, November 02, 2004 10:49:50 AM in the workspace RootT1Feb. Current in this workspace.
Entirely seen in workspace RootT1Feb.

Included changes:
f3T1 has been moved
f3T1's description has been changed

You can see that the change set named feb_RootT1Feb_6 has been created by the user: feb on Tuesday, November 02, 2004 10:49:50 AM in the workspace RootT1Feb. This change set is the current change set in workspace RootT1Feb.

In this case, you can notice that there are two included changes, and all of them are seen in workspace RootT1Feb,

The changes are classified into five famillies:

created changes, created within the change set,
moved in changes, appeared after an adl_reorg_cs command,
moved out changes, brougth out by an adl_reorg_cs command,
forgotten changes, forgotten by an adl_forget_chg command,
IS changes, recovered by intersite commands.

By default, only included changes (created and moved in changes) are displayed.

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.

Options

adl_ds_cs accepts the following options:

`-h\|-help\|-?`	Help of the command
change_set	Name of the change set or identifier prefixed by "csid:".
-ws workspace_name	Name of the workspace where to find the current change set.
-full_info	Display each change with all relative informations (history...).
-no_chg	Display only the change set own's attributes.
-hist_chg	Display all changes of the change set, classified by familly (created, moved in, moved out, forgotten).
-locate_chg	Display for each change, all the workspaces were the change has been propagated..
`-program`	Display for programs
`-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]

Examples

Display the current change set of specific workspace (RootT1Feb):

adl_ch_ws RootT2Feb
adl_ds_cs -ws RootT1feb
Change set feb_RootT1Feb_6 State: Opened Desc:
Created by feb with adl_ch_cs on Tuesday, November 02, 2004 10:49:50 AM in the workspace RootT1Feb. Current in this workspace.
Not seen in workspace RootT2Feb.

Included changes:
soid:EMRMXnB81V23+++4OBZQ has been moved chgid:++++-EMRMXnB81V23+++4OBZU
soid:EMRMXnB81V23+++4OBZQ's description has been changed chgid:++++-EMRMXnB81V23+++4OBZW

The reference workspace is the current workspace, RootT2Feb. You can notice that when the changes are not seen in the reference workspace, only change identifiers are given.

This command is equivalent to:

adl_ds_cs feb_RootT1Feb_6 -ws RooT2Feb

Display the change set named feb_RootT2Feb_6 with all famillies of changes:

adl_ds_cs feb_RootT1Feb_6 -hist_chg
Change set: feb_RootT1Feb_6 State: Opened Desc:
Created by feb with adl_ch_cs on Tuesday, November 02, 2004 10:49:50 AM in the workspace RootT1Feb. Current in this workspace.
Entirely seen in workspace RootT1Feb.

Created changes:
f3T1 has been moved
f3T1's description has been changed

Moved out changes:
f3T1 has been created

Display the change set named feb_RootT2Feb_6 with full information:

adl_ds_cs feb_RootT1Feb_6 -full_info
Change set: feb_RootT1Feb_6 State: Opened Desc:
   Created by feb with adl_ch_cs on Tuesday, November 02, 2004 10:49:50 AM in the workspace RootT1Feb. Current in this workspace.
   Entirely seen in workspace RootT1Feb.

Included changes:
f3T1 Type: Framework Id: EMRMXnB81V23+++4OBZQ Responsible: <Not available>
   Move Id: ++++-EMRMXnB81V23+++4OBZU Folder: None Name: "f3T1"
      Created by feb with adl_mk_fw on Tuesday, November 02, 2004 10:51:11 AM in the workspace RootT1Feb, tree T1Feb
   Change of description Id: ++++-EMRMXnB81V23+++4OBZW Summary: None Associated content Id: None
      Created by feb with adl_mk_fw on Tuesday, November 02, 2004 10:51:11 AM in the workspace RootT1Feb, tree T1Feb

Display the change set named feb_RootT2Feb_6 with the output sent to a file "MyResultFile" in a mode program:

adl_ds_cs feb_RootT1Feb_6 -program -sep "|" -out MyResultFile

[Top]

References

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

adl_ls_cs: listing change set
adl_reorg_cs: reorganizing changes between change sets
adl_forget_chg: Forgetting change
adl_ren_cs : renaming a change set
adl_close_cs: closing a change set
adl_set_cs: setting characteristics of a change set

[Top]

History

Version: 1 [Nov 2004]

Document creation

[Top]