RADE

Source Code Manager

adl_ls_db

Listing existing databases

Quick Reference

Abstract

The adl_ls_db command displays the list of databases that have been declared on the current SCM site.

Synopsis
Usage
Options
Examples
References

Synopsis

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

Usage

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

The command displays information about the databases that have been declared [1] to SCM. Before creating a workspace tree, it is needed to declare the associated database [1] and the associated file server [3].

Displayed data are:

Internal identifier (UUID)
Database name (as entered
In program mode only: database name in upper case letters
Central or not central (in program mode: CENTRAL or NOT_CENTRAL)
Departmental or not departmental (in program mode: DEPT or NOT_DEPT)
Monitor or not monitor (in program mode: MONITOR or NOT_MONITOR)
The description of the database (a little description that has been entered when creating the database).

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.

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

[Top]

Options

adl_ls_db accepts the following options:

`-h\|-help\|-?`	Help of the command
`-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 databases in a normal mode:

adl_ls_db

Identifier Name Central Departmental Monitor Description
---------------------------------------------------------------------------------------------------------------------
DVKH1E+++++3+++6j+BG ADL3.ds.fr Not central Departmental Not monitor
DVEqR++++++3+++6B+5C RANDDSY1 Central Departmental Monitor Central database for RANDDSY installation

Display of all the databases in a program mode:

adl_ls_db -program -sep "|"

DVKH1E+++++3+++6j+BG|ADL3.ds.fr|ADL3.DS.FR|NOT_CENTRAL|DEPT|NOT_MONITOR|\0
DVEqR++++++3+++6B+5C|RANDDSY1|RANDDSY1|CENTRAL|DEPT|MONITOR|Central database for RANDDSY installation

[Top]

References

[1]	adl_mk_db: registering a new database
[2]	Displaying strings in program mode
[3]	adl_mk_contents_server: registering a new file contents server

[Top]

History

Version: 1 [Jan 2003]

Document creation

[Top]