RADE

Source Code Manager

adl_ds_ws_is

Displaying intersite workspace statuses

Quick Reference

Abstract

The adl_ds_ws_is command is used to display information about the state of an intersite workspace to know whether there are data to be transferred between the local and remote sites.

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ds_ws_is [-transfer transfer_name] [-tree ws_tree_name...] [-h | -help | -?]

Usage

The adl_ds_ws_is command is used after having declared [1] an intersite [2] transfer between a local workspace and another workspace of another remote site. It is used to know if there can be something to be transferred from the local workspace or from the remote site, that is to say if the adl_promote_is [3] or the adl_sync_is [4] command can be run.

The command operates on the current workspace and a transfer name can be specified if several ones have been defined from it.

The command needs to connect to the remote transfer manager to get information about the remote mirror workspace and its parent workspace.

In addition, it is needed to have access to the directory (see option -dir of adl_mk_is_transfer [1]) where transfer data are stored in order to be able to compute information.

The three first information displayed are:

the name of the current local workspace
the name of the transfer
the name of the remote site with which the transfer has been set

Then, for each workspace tree in which the given transfer is defined, the command displays:

the name of the associated remote workspace tree
the name of the associated remote parent workspace and whether it is published or not
the name of the associated remote mirror workspace and whether it is synchronized and promoted against the remote parent workspace
the synchronization status regarding intersite transfers: does adl_sync_is [4] should be started?
the promotion status regarding intersite transfers: does adl_promote_is [3] should be started?

[Top]

Options

adl_ds_ws_is accepts the following options:

`-h\|-help\|-?`	Help of the command
-transfer transfer_name	Name of an existing transfer of the current workspace.
`-tree local_ws_tree_name`	To restrict the computation to a subset of the workspace trees in which the transfer is defined

[Top]

Example

Display information about the current workspace "devlocal" and the intersite transfer defined in two workspace trees:

Current workspace: devlocal
Transfer: Transfer1
Remote site: Suresnes

For local workspace tree: treelocal
  Remote workspace tree: V5R7
  Remote parent workspace: PRJV5R7
    Published: Yes
  Remote mirror workspace: MIRROR_Suresnes_devlocal_1
    Synchronized: Yes
    Promoted: Yes
  Synchronized with remote site: No
  Promoted to remote site: No

For local workspace tree: treelocal2
  Remote workspace tree: cgav5R7
  Remote parent workspace: PRJV5R7
    Published: Yes
  Remote mirror workspace: MIRROR_Suresnes_devlocal_1
    Synchronized: Yes
    Promoted: Yes
  Synchronized with remote site: No
  Promoted to remote site: No

[Top]

References

[1]	adl_mk_is_transfer: Creating an intersite transfer
[2]	Inter site transfer: Sharing components between SCM sites
[3]	adl_promote_is: promoting modfications in intersite workspace
[4]	adl_sync_is: synchronizing components in intersite workspace

[Top]

History

Version: 1 [Jan 2003]

Document created

[Top]