settask
Associates change-management tasks with views (base VersionVault).
Applicability
Product |
Command type |
---|---|
VersionVault |
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[,...] ] ]
Description
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.
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 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