chactivity

Changes a UCM activity

APPLICABILITY

ClearCase UCM (cleartool subcommand)

SYNOPSIS

chact·ivity [ -c·omment comment | -cfi·le pname | -cq·uery | -cqe·ach | -nc·omment ]
{ [ -hea·dline headline activity-selector ... ] |

  [ -fcs·et src-activity-selector -tcs·et dest-activity-selector version-pname[,... ] }

DESCRIPTION

The chactivity command modifies one or more UCM activities. Use this command for these tasks:

• Change an activity's headline
• Move versions from the change set of one activity to the change set of another activity

Note that changing the headline for an activity does not affect its name (its unique identifier). See rename for related information.

The destination activity must exist before you can move a change set and both the source and destination activities must be in the same stream. Use lsactivity -long to list the pathnames of change set versions associated with an activity.

PERMISSIONS AND LOCKS

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

Locks: An error occurs if there are locks 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.

MODIFY AN ACTIVITY'S HEADLINE.

-hea·dline headline

Specifies a new headline for the activity. The headline argument can be a character string of any length. Use double quotes to enclose a headline with spaces or special characters.

SELECT AN ACTIVITY TO CHANGE.

activity-selector ...

Specifies one or more activities to modify.

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

MOVE VERSIONS TO A DIFFERENT CHANGE SET.

-fcs·et src-activity-selector

Specifies the activity from which to move versions.

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

-tcs·et dest-activity-selector

Specifies the activity to move versions to. These versions are recorded in the activity's change set.

version-pname[,...]

One or more version-extended pathnames that specify the versions to be moved to another change set.

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.

• Change an activity's headline.

cmd-context chactivity -headline "my new activity"
activity990917.133255@\vobs\core_projects
Changed activity "activity990917.133255@\vobs\core_projects".

• Move an activity's change set.

cmd-context chact -fcset activity990917.133255@/vobs/core_projects
-tcsets new_activity@\vobs\core_projects \vobs\parser\.@@\main/java_int\2

Moved version "\vobs\parser\.@@\main\java_int\2" from activity "activity990917.133255@\vobs\core_projects" to activity "new_activity@\vobs\core_projects".

SEE ALSO

lsactivity, mkactivity, rename, rmactivity