settask

The settask command associates a default task, or list of default tasks, with a view (base VersionVault). When a VersionVault 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.

-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.

The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you may 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 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 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

chtask, cmiregister, lsprovider, lstask, mkcmprovider, rmprovider