RADE

Source Code Manager

adl_ls_transfer

Listing transfers of current SCM site

Quick Reference

Abstract

The adl_ls_transfer command lists transfers of the current SCM site.

Synopsis
Usage
Options
Examples
References

Synopsis

adl_ls_transfer [-ws workspace_name] [-tree ws_tree_name...] [-program [-sep|-separator char]] [-out file_path] [-h | -help | -?]

Usage

The adl_ls_transfer command lists the transfers that have been set up between workspaces of the current SCM site and workspaces of other sites. See the documentation of the adl_mk_is_transfer [1] to know of to create those transfers.

Use the -ws option to display only transfers associated with a specific workspace of the current site.

In case of multitree workspace, there are several lines displayed regarding the number of workspace trees.

[Top]

Options

adl_ls_transfer accepts the following options:

`-h\|-help\|-?`	Help of the command
-ws workspace_name	Name of the workspace for which the transfers are listed
-tree ws_tree_name...	The workspace trees for which the transfers are listed
`-program`	Display for programs See below.
-sep\|-separator char	Separator between each field for programs (space " " by default)
-out file_path	Path to a file for writing the results

Here are the information displayed without using the -program option; they are listed in the order they appear on each line:

name of the workspace of current site
name of the transfer
name of the local workspace tree
name of the remote mirror workspace
name of the remote workspace tree
name of the remote site [2]
host and port of the remote SCM Multisite Transfer Manager in the format host:port
name of one image of the local workspace if this one has been chosen for storing transfer specific files when declaring this transfer [1]. Otherwise nothing is displayed in this column
either the path to the previous image or the path to another directory if this directory was specified for storing transfer specific files when declaring the transfer.
a host name if either the image or the directory for storing transfer specific files was declared as local to the current host when creating the transfer.

Here are the information displayed when using the -program option; they are listed in the order they appear on each line:

name of the workspace of current site
identifier of the workspace of the current site
name of the transfer
identifier of the transfer
name of the local workspace tree
identifier of the local workspace tree
name of the remote mirror workspace
identifier of the remote mirror workspace
name of the remote workspace tree
identifier of the remote workspace tree
name of the remote SCM site [2]
identifier of the remote SCM site
host of the remote SCM Multisite Transfer Manager
port of the remote SCM Multisite Transfer Manager
name of one image of the local workspace if this one has been chosen for storing transfer specific files when declaring this transfer [1]. Otherwise the string "<NULL>" is displayed in this column
identifier of the previous image or the string "<NULL>" if no image is set.
path to a directory if this directory was specified for storing transfer specific files when declaring the transfer. Otherwise the string "<NULL>" is displayed in this column.
the string "<NULL>" or a host name if the directory for storing transfer specific files was declared as local to the current host when creating the transfer.

[Top]

Examples

Creation of a transfer between the workspace "devlocal" and the remote workspace prjV5R7, the transfer information will be stored in the current image of the workspace "devlocal":

adl_mk_is_transfer -r_is_server_host randdsy -r_is_server_port 23453 -r_parent_ws prjV5R7 -r_tree V5R7 -tree treelocal
Checking current workspace devlocal...
Checking remote workspace prjV5R7...
Creating mirror workspace under prjV5R7...
Registering the new intersite transfer between devlocal and prjV5R7 in local database.

Intersite command successful

adl_ls_transfer -ws devlocal

Workspace 1 Transfer Tree 1 Workspace 2 Tree 2 Site 2 Inter site server Image Transfer log directory ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- devlocal Transfer1 treelocal MIRROR_Suresnes_devlocal_3 V5R7 Suresnes randdsy:23453 WINDOWS e:/databases/randdsy1/ws/devlocal on randdsy

List the same transfer as above but in program mode. Note that the two last fields are <NULL> to be able to distinguish a directory against an image. In normal mode, these columns are filled with information about the workspace image.

[Top]

References

[1]	adl_mk_is_transfer: Creating an intersite transfer into a workspace tree
[2]	adl_ls_site: Listing the name of the current SCM site

[Top]

History

Version: 3 [Sep 2005]	Document update: remove reference to adl_is_gui
Version: 2 [Oct 2002]	Document update: add reference to adl_is_gui
Version: 1 [Mar 2002]	Document creation

[Top]