lsactivity
Lists information about UCM
activities
SYNOPSIS
- List
information about UCM activities:
- lsact·ivity [ –s·hort |
–l·ong | –fmt format-string
- | –anc·estor [
–fmt format-string ]
[ –dep·th depth ]
[ –obs·olete ]
[ –inv·ob vob-selector |
–in stream-selector-name
| activity-selector ... | [ [–cac·t |
-me | -use·r username ]
[ –vie·w view-tag | –cvi·ew ]
] ]
- List
activities or baselines that contributed to the change set of an integration
activity:
- lsact·ivity –contrib activity-selector
DESCRIPTION
The lsactivity command
lists information about UCM activities.
OPTIONS AND ARGUMENTS
Specifying Output Format
- Default
- A one-line summary of the activity.
- –s·hort
- Displays only the name of each activity.
- –l·ong
- Displays a detailed description of each
activity.
- –fmt format-string
- Displays information in the format specified
by format-string. See the fmt_ccase reference
page.
- –anc·estor [ –fmt format-string ]
[ –dep·th depth ]
- Displays the containing stream, parent
streams if any, project, and folder for one or more activities. For information
about the –fmt option, see the fmt_ccase reference
page. The –depth option sets the number of levels
displayed. The depth argument must be a positive
integer.
Listing Obsolete Activities
- Default
- Lists only nonobsolete activities.
- –obs·olete
- Includes obsolete activities in the listing.
Obsolete activities are those that have been processed with lock –obsolete.
Specifying the Activity to List
- Default
- –cview.
- –inv·ob vob-selector
- Displays a list of all activities in
the specified project VOB.
- –in stream-selector
- Displays a list of all activities in
the specified stream.
- activity-selector ...
- Specifies one or more activities to list.
You can specify an activity as a simple
name or as an object selector of the form [activity]:name@vob-selector, where vob-selector specifies a project VOB
(see the cleartool reference page). If
you specify a simple name and the current directory is not a project VOB,
this command assumes that the activity resides in the project VOB associated
with the stream attached to the current view. If the current directory is
a project VOB, that project VOB is the context for identifying the activity.
- –cac·t
- Displays information for the current
activity.
- -me
- Displays activities owned by the current user.
- -use·r
- Displays activities owned by the specified user.
- –vie·w view-tag
- For the specified view, displays a list
of all activities in its stream.
- –cvi·ew
- For the current view, displays a list
of all activities in its stream.
Listing Contributing Activities or Baselines for an Integration Activity
- Default
- Displays information about the named
activity.
- –contrib activity-selector
- Displays activities or baselines that
contributed to the change set of an integration activity, which is created
by a deliver or rebase operation. An error occurs if the specified activity
is not an integration activity.
EXAMPLES
The UNIX examples in this section are written for use in csh.
If you use another shell, you may need to use different quoting and escaping
conventions.
The Windows examples that include 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 UNIX shell or Windows command interpreter prompt, followed by the cleartool command.
In cleartool interactive mode, cmd-context represents
the interactive cleartool prompt.
Note: In the UNIX examples that follow, arguments and output that show
multicomponent VOB tags are not applicable to ClearCase LT, which recognizes
only single-component VOB tags. In this manual, a multicomponent VOB tag is
by convention a two-component VOB tag of the form /vobs/vob-tag-leaf—for
example, /vobs/src. A single-component VOB tag consists
of a leaf only—for example, /src. In all other
respects, the examples are valid for ClearCase LT.
- Display detailed information
for an activity.
- Display
a short description of the current activity. This is the currently set activity
for the view from which the command was issued.