rmactivity

Deletes a UCM activity

APPLICABILITY

ClearCase UCM (cleartool subcommand)

SYNOPSIS

rmact·ivity [ -c·omment comment | -cfi·le comment-file-pname |-cq·uery | -nc·omment ]

[ -f·orce ] activity-selector ...

DESCRIPTION

The rmactivity command deletes one or more UCM activities. The following restrictions apply:

• The activity can have no versions in its change set.
• The activity cannot be set as the current activity for a view.

If versions exist in the change set, you can delete the versions or move the versions to another change set with chactivity -fcset -tcset.

ClearQuest-enabled Projects

When executed in a view that is associated with a ClearQuest-enabled project, this command unlinks the activity from its associated ClearQuest record and deletes the activity but it does not delete the ClearQuest record.

PERMISSIONS AND LOCKS

Permissions Checking: You must be the owner of the activity, the VOB owner, or a member of the ClearCase group.

Locks: An error occurs if there is a lock on any of the following objects: the UCM project VOB or the activity.

Mastership: The activity must be locally mastered.

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 CUSTOMIZING COMMENT HANDLING in 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.

-f·orce

By default, the rmactivity command prompts for confirmation before deleting an activity. The -force option suppresses the confirmation step.

activity-selector ...

Specifies one or more activities to delete. The activity: prefix is optional.

activity-selector is of the form: [activity:]activity-name[@vob-selector] and vob is the activity's UCM project VOB.

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.

• Remove an activity that is set as the current activity in a view.
  1. Issue an rmactivity command. The error message tells you that the specified activity is in use by the view java_parser_int:

cmd-context rmactivity -f new_object_tree@\usr1\tmp\foo_project
cleartool: Error: Activity "activity:new_object_tree@\usr1\tmp\foo_project" is setworked in view "java_parser_int".

cleartool: Error: Unable to remove activity "new_object_tree@\usr1\tmp\foo_project".

1. Go to the view in which the activity is set and unset it:

cmd-context setact -none
Cleared current activity from view java_parser_int.

1. Reissue the rmactivity command:

cmd-context rmactivity -f new_object_tree@\usr1\tmp\foo_project
Removed activity "new_object_tree@\usr1\tmp\foo_project".

SEE ALSO

chactivity, lsactivity, mkactivity, setactivity