This subcommand modifies the specified folders. The folders must be modifiable by you.
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)...] [-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.
Updating folder 95: Tested Tasks for Release 3.2 ...
Added task 5
Added task 6
Added task 7
Added task 8
Task 9 is already in the folder
Added 4 tasks.
Updating folder 95: Tested Tasks for Release 3.2 ...
Removed task 5
Removed task 6
Removed task 7
Removed task 8
Removed task 9
Removed 5 tasks.
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