lsbl

Lists information about a UCM baseline

APPLICABILITY

ClearCase UCM (cleartool subcommand)

SYNOPSIS

• List baseline information per stream or component or by promotion level:

  lsbl [ -s·hort | -l·ong | -fmt format-string ] [ -tre·e ]

  
  

  [ -lev·el promotion-level | [ -ltl·evel promotion-level ] [ -gtl·evel promotion-level ] ]
  [ -str·eam stream-selector |-com·ponent component-selector ]

• List information for one or more specific baselines:

lsbl [ -s·hort | -l·ong | -fmt format-string ] [ -tre·e ] [ baseline-selector ... ]

DESCRIPTION

The lsbl command lists information about one or more UCM baselines. Command options allow you to specify the type of information and the format in which it is displayed.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions are required.

Locks: No locks apply.

Mastership: Mastership does not apply.

OPTIONS AND ARGUMENTS

SELECTING A DISPLAY FORMAT Default: One-line summary.

-s·hort

Displays a one-line summary showing the name of each baseline.

-l·ong

Displays detailed information for each baseline.

-fmt format-string

Displays information in the specified format. See the fmt_ccase reference page for details.

SPECIFYING THE BASELINE. Default: Lists baselines in the UCM project VOB of the current directory.

-tre·e

Displays a list of streams and baselines associated with one or more baselines. The list is indented to show the order of succession for baselines.

-lev·el promotion-level

Displays a list of baselines that are at the specified promotion level or higher. An error is given if the specified level is not in the project VOB's current list of valid promotion levels.

-ltl·evel promotion-level

Displays a list of baselines whose promotion level is lower than the one specified by the promotion-level argument. For example, if your project has four promotion levels in this order: PROTOTYPE, REVIEWED, TESTED, CERTIFIED, and you use the argument -ltlevel TESTED, the lsbl command displays a list of all baselines whose promotion level is PROTOTYPE or REVIEWED.

-gtl·evel promotion-level

Displays a list of baselines whose promotion level is greater than the one given.

-str·eam stream-selector

Displays a list of baselines created in the specified stream.

-com·ponent component-selector

Displays a list of baselines of the specified component.

baseline-selector ...

Specifies one or more baselines for which information is displayed.

EXAMPLES

Examples including wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Display a short description of baselines of the specfied component.

cmd-context lsbl -component parser@/vobs/core_projects

17-Sep-99.12:06:59 parser_INITIAL.112 bill "parser_INITIAL"
component: parser

• Display a description of baselines created in a stream:

cmd-context lsbl -stream java_int@/vobs/core_projects

17-Sep-99.13:56:10 testbl.121 bill "testbl"
stream: java_int
component: parser
17-Sep-99.14:05:30 new_bl.121 bill "new_bl"
stream: java_int
component: parser

SEE ALSO

chbl, deliver, describe, diffbl, mkbl, rebase, rmbl