settask

Associates change-management tasks with views (base ClearCase®).

Applicability

Product

Command type

ClearCase

cleartool subcommand

Platform

UNIX

Linux

Windows

Synopsis

  • Find tasks that are available from the specified change-management task-provider:
    settask -find [ -provider provider_name ] { -pname pname | -brtype brtype_name }
  • Associate a task with a view:
    settask [ -view view-tag ] { task-selector
    | [ [ -add_task task-selector[,...] ] [ -remove_task [ task-selector[,...] ] ]
    | -none }

Description

The settask command associates a default task, or list of default tasks, with a view (base ClearCase). When a ClearCase element is created, checked out, or checked in, the version that is created is associated by default with a task, or tasks, that have been previously associated with the view by this command. You can also use this command to query the change-management provider for a list of tasks that are available for association with the view.

Restrictions

None.

Options and arguments

-find
Finds available tasks.
-provider provider_name
Specifies the provider of the tasks that are to be located by -find. Default: Current effective provider configured for pname or brtype_name.
-pname pname
Specifies the element for which tasks are to be located.
-brtype brtype_name
Specifies the branch for which tasks are to be located.
-view view-tag
Specifies the view with which tasks are to be associated. This option is required if no view is set; otherwise, the default is the current view.
task-selector
A task selector of the form, task-id@provider_name.
-add_task
Adds the task specified by task-selector to the specified view.
-remove_task
Removes the task specified by task-selector to the specified view.
-none
Deletes any associations of tasks with the specified view. Before checking in a new version (created by the mkelem or checkout commands), you must set the its task using the chtask command.

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.

  • Associate a task that is located at provider RTCPROV with the current view.

    cmd-context settask 1234@RTCPROV

  • Replace task 1234 with task 5678 as the default task for the current view.
    cmd-context settask -add 5678@RTCPROV -rem 1234@RTCPROV
  • Clear the default task from the current view. A new version (created through cleartool mkelem or checkout) must have its task set explicitly with cleartool chtask before it can be checked in.
    cmd-context settask -none  
  • Find a list of available tasks at provider RTCPROV for the branch type dev:

    cmd-context settask -find -provider RTCPROV -brtype dev