mkactivity

Creates a UCM activity

APPLICABILITY

ClearCase UCM (cleartool subcommand)

SYNOPSIS

mkact·ivity [ -c·omment· comment | -cfi·le pname | -cq | -cqe | -nc·omment ]

[ -hea·dline headline ] [ -in stream-selector ] [ -nset ] [ -force ] [ activity-selector ...]

DESCRIPTION

The mkactivity command creates a UCM activity. Activities track the work you do in completing a development task. An activity consists of a headline, which describes the task, and a change set, which identifies all versions of elements that are created or modified by work on the activity.

By default, activities are created in the stream associated with your view context. You can specify another stream with the -in option.

A newly created activity is set as the current activity for your stream when one activity is created using your current view context. Each stream can have one current activity, which records any changes being made. Use -nset if you do not want to use an activity immediately. No activity is set when you create more than one activity per command, or create activities outside your view context. To begin recording changes in an activity, issue a setactivity command from a view that is attached to the activity's stream.

Behavior for ClearQuest-enabled Projects

When executed in a view that is associated with a ClearQuest-enabled project, this command generates an error. The correct way to create an activity is to use the setactivity command, specifying a ClearQuest record-ID as the activity-selector.

PERMISSIONS AND LOCKS

Permissions Checking: None.

Locks: An error occurs if there are locks on the following objects: the activity's UCM project VOB.

Mastership: There are no mastership requirements.

OPTIONS AND ARGUMENTS

EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by your .clearcase_profile file (default: -cq). 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.

ASSIGNING A HEADLINE TO AN ACTIVITY.

-hea·dline headline

Specifies a description of the activity. The headline argument can be a character string of any length. Enclose a headline with special characters in double quotes.

-in stream-selector

Specifies that the activity be created in this stream. If no stream-selector is specified, mkactivity attempts to derive the stream context from the working view.

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

-nset

Specifies that the new activity not be set as the current activity for the view.

-force

If no activity-selector is specified, the mkactivity command prompts for confirmation before generating a name. The -force option suppresses the confirmation step, using the default answer yes.

IDENTIFYING AN ACTIVITY. You can specify names for one or more new activities. Default: A name is generated if one is not specified.

activity-selector ...

Specifies one or more activities to create. The specifier must be unique within the project VOB.

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.

• Create an activity, but do not set it to be the current activity for the view.

cmd-context mkact -nset

Create activity with automatically generated name? [yes] yes
Created activity "activity990917.133218".

• Create an activity. The activity is created in the stream attached to the current view. Its name is generated automatically.

cmd-context mkact new_activity

Created activity "new_activity".
Set activity "new_activity" in view "java_int".

• Create an activity whose name is generated automatically. You are not prompted for confirmation.

cmd-context mkact -f

Created activity "activity990917.134751".
Set activity "activity990917.134751" in view "java_int".

• Create an activity in the specified stream.

cmd-context mkact -in joes_stream my_work

Created activity "my_work.3345".

SEE ALSO

chactivity, lsactivity, rmactivity, setactivity