setactivity
Sets or unsets the activity for a view
Applicability
Product |
Command type |
|---|---|
ClearCase® |
cleartool subcommand |
|
ClearCase Remote Client |
rcleartool subcommand |
Platform |
|---|
UNIX |
|
Linux |
Windows |
Synopsis
- ClearCase–Set an activity:
- setact/ivity [ –c/omment comment | –cfi/le pname | –cq/uery | –nc/omment ]
- [ –vie/w view-tag ] { –none | activity-selector }
- ClearCase–Set an activity that is associated
with tasks:
- setact/ivity { –none | -tasks task-selector[,...] | activity-selector }
- ClearCase Remote Client–Set an activity:
- setact/ivity { –none | activity-selector }
Description
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. Likewise, each activity can be set in no more than one view. When you check out an element, it is associated with the current activity.
Before resetting to another activity, the setactivity command determines whether any elements of the current activity are checked out in the view and, if so, 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 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).
Behavior for projects enabled for ClearQuest
When executed in a view that is associated with a project enabled for ClearQuest®, 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.
Stopping work on an activity
You can stop work on an activity in these ways:
- Deliver the activity to the project's integration stream.
- Issue another setactivity command, specifying a different activity selector.
- Use the –none option to unset the current activity in your view.
Restrictions
Identities
No special identity required.
Locks
When you set an activity, an error occurs if one or more of these objects are locked: the project VOB, the activity. When you unset an activity, no locks apply.
Mastership
(Replicated VOBs only) Your current replica must master the activity.
Options and arguments
Event records and comments
- Default
- Creates one or more event records, with commenting controlled by your .clearcase_profile file (default: –nc). See the comments reference page. Comments can be edited with chevent.
- –c/omment comment | –cfi/le comment-file-pname |–cq/uery | –cqe/ach | –nc/omment
- Overrides the default with the option you specify. See the comments reference page.
Choosing a view
- Default
- Current view context.
- –vie/w view-tag
- Specifies a view and stream context for the command.
Specifying a CMI task
- Default
- The tasks that are associated with the current context.
- -tasks task-selector[,...]
- Specifies the CMI-provided tasks that are to be associated with the activity. task-selector is of the form task@provider-name.
Specifying the activity
- Default
- None.
- –none
- Unsets the current activity, removing it from your work area.
- activity-selector
- Identifies the activity to be set.
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.
Examples
The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you might 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 might 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 system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.
- Unset the current activity.
cmd-context setactivity -none
Cleared current activity from view java_int. - Set an activity to be the
current activity.
cmd-context setactivity create_directories
Set activity "create_directories" in view "webo_integ".