When
you define a folder query, the -custom, -platform, -release, -subsystem,
and
-task_scope options contribute
to the final generated task query. You can use the
-platform, -release and -subsystem options
multiple times. When you use an option more than once, the query expression
relating to each usage is combined with an "or". For example, if you
specify -release 1.0 -release 2.0, this contributes
a query expression of (release='1.0' or release='2.0).
Contributions from different options are combined with "and". For
example, if you specify -release 1.0 -platform windows,
this contributes a query expression of (release='1.0') and
(platform='windows'). The -task_scope option
also results in a contribution to the task query based on the specified
scope, and this is modified by any -database_id options
specified. The final task query used combines all of these elements
in a single query expression.
ccm folder -m|-modify [-n|-name folder_name]
[-mode ((man|manual) | (uq|use_query))]
[-w|-writable (owner | (build_mgr|build_manager|buildmanager) |
all | none)] [-cus|-custom custom_query]
[(-db|-dbid|-database_id database_spec)...]
[(-plat|-platform platform)...] [(-purpose purpose)...]
[(-rel|-release release_spec)...]
[(-sub|-subsystem subsystem)...] [-ts|-scope|-task_scope
(user_defined | (all_my_assigned|all_owners_assigned) |
(all_my_assigned_or_completed|all_owners_assigned_or_completed) |
(all_my_completed|all_owners_completed) |
(all_my_tasks|all_owners_tasks) | all_completed | all_tasks)]
(ct_projs|ct_projects|component_task_projects) |
(ct_prods|ct_products|component_task_products) |
(ct_projs_prods|ct_projects_products|
component_task_projects_products))]
[(-at|-add_task|-add_tasks task_spec)...]
[(-rt|-remove_task|-remove_tasks task_spec)...]
[-related] [-up|-update] folder_spec...
If you modify a folder from manual to query-based, never defined a task query, and didn't specify any available options, then the folder is created as query-based with a default task query defined as follows.
This option typically applies to queries for component tasks that are specified with one of these scopes: component_task_projects, component_task_products, or component_task_projects_products.
This
scope is defined by the default task query option. If you specify
-database_id,
the query also includes a query expression for tasks modifiable in
or completed in the specified database.
This scope queries for all tasks assigned to you. If you specify -database_id, the query is for all tasks assigned to you that are modifiable in the specified database.
This scope queries for all tasks assigned to you or completed by you. If you specify -database_id, the query is for all tasks assigned to you and modifiable in the specified database, or completed by you in the specified database.
This scope queries for all tasks completed by you. If you specify -database_id, the query is for all tasks completed by you in the specified database.
This scope queries for all tasks for which you are the task resolver. If you specify -database_id, the query is for all tasks for which you are the task resolver and that are modifiable in the specified database or were completed in the specified database.
This scope queries for all completed tasks. If you specify -database_id, the query is for all tasks completed in the specified database.
This scope queries for all tasks. If you specify -database_id, the query is for all tasks that are modifiable in the specified database or that were completed in the specified database.
This scope queries for component tasks for projects, products, or projects and products. If you specify -database_id, the query is for all component tasks that were created in the specified database. If you specify -purpose, the query is for component tasks with the specified purpose.
ccm folder -modify -at 5-9 95
ccm folder -modify -rt 5-9 95
ccm folder -modify -add_task 5,12,14 51
ccm folder -m -up 160
ccm folder -modify -mode use_query 111
ccm folder -modify -ts all_my_tasks -rel 3.5 111
The query for folder '111: bob's Insulated Development Folder' has been changed to: owner='bob' and release='3.5'
ccm folder -modify -name "Completed tasks for release 3.5" 85