Specifies the current UCM activity for your view
ClearCase UCM (cleartool subcommand)
The setactivity command sets or unsets a current activity for a view. The current activity is one whose change set records your current work. Each view can have no more than one current activity. When you check out an element, it is associated with the current activity.
By default, the setactivity command works with your current view. You can select another view/stream combination with the -view option. The view must be attached to the specified activity's stream.
Before resetting to another activity, the setactivity command checks on whether any elements of the current activity are checked out in the view and, if found, issues a warning before proceeding.
You can set an activity for a view while the activity is being delivered, but the changes made to the activity when the deliver operation is in progress are not delivered. To clear the current activity, specify a new activity or use the -none option.
You cannot reset an integration activity that is in use as part of a deliver or rebase operation (nor can you clear it with -none).
When executed in a view that is associated with a ClearQuest-enabled project, this command takes an activity-selector that is a ClearQuest record-ID (for example, SAMPL123456) of an existing ClearQuest record. If the ClearQuest record is not already linked to an activity, the command causes an activity to be created and linked to the ClearQuest record.
You can stop work on an activity in these ways:
Permissions Checking: None.
Locks: An error occurs if there are locks on the following objects: UCM project VOB or the activity.
Mastership: The activity must be locally mastered.
EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by your .clearcase_profile file (default: -nc). See CUSTOMIZING COMMENT HANDLING in the comments reference page. Comments can be edited with chevent.
CHOOSING A WORK AREA. Default: Current view context.
SELECTING OR DE-SELECTING AN ACTIVITY. Default: None.
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.
cmd-context setactivity -none
Cleared current activity from view java_int.
cmd-context setactivity activity990917.133255@\vobs\core_projects
Set activity "activity990917.133255" in view "java_int".
chactivity, lsactivity, mkactivity, rmactivity
Feedback on the documentation in this site? We welcome any comments!
Copyright © 1999 by Rational Software Corporation. All rights reserved.