Modifying a release

About this task

This subcommand modifies one or more releases. You must be in the build_mgr or ccm_admin role to use this subcommand.

ccm release -m|-modify [-bl|-baseline release_spec] 
        [-desc|-description description] 
        [-desc_edit|-descriptionedit|-description_edit] 
        [-desc_file|-descriptionfile|-description_file file_path] 
        [-manager manager] ([-active] | [-inactive]) 
        ([-allow_dcm_transfer] | [-noallow_dcm_transfer]) 
        [-allow_parallel_check_out] [-noallow_parallel_check_out] 
        [-allow_parallel_check_in] [-noallow_parallel_check_in] 
        [-groups groups] ([-included_releases included_releases] | 
        [-included_releases_file included_releases_file]) 
        [-phase phase] 
        ([(-apr|-add_process_rule|-add_process_rules process_rule_spec)... 
        [-cpr|-clear_process_rules]] | [(-rpr|-remove_process_rule|
        -remove_process_rules process_rule_spec)...]) 
       ([-cct|-create_component_tasks] | [-nocct|-nocreate_component_tasks])
       release_spec...
-active
Sets the release to be active.
-allow_dcm_transfer
Specifies that the releases should be set as eligible for DCM replication if included by a transfer set's release scope and query.
-allow_parallel_check_in
Specifies that parallel check in for objects with this release is permitted. Note that the combination of parallel check in but no parallel check out is invalid.
-allow_parallel_check_out
Specifies that parallel check out for objects with this release is permitted. Note that the combination of parallel check in but no parallel check out is invalid.
-apr|-add_process_rule|-add_process_rules process_rule_spec
Adds the specified process rule to each of the releases specified by the arguments. See Process rule specification for details.
-baseline release_spec
Sets the baseline release for the releases being modified. See Release specification for details.
-cct|-create_component_tasks
Specifies to create corresponding component tasks when baselines are created for the release definition being modified. For example, use this option if you are modifying a release definition and know that your team will require component tasks. When you modify the baseline, component tasks will be created automatically.
-cpr|-clear_process_rules
Clears any existing process rules before adding a process rule (see -apr|-add_process_rule|-add_process_rules process_rule_spec), and sets an absolute set of process rules.
-desc|-description description
See -desc|-description description.
-desc_edit|-description_edit
See -desc_edit|-description_edit.
-desc_file|-description_file file_path
See -desc_file|-description_file file_path.
-groups groups
Specifies the groups that may modify the new release or create following releases from it. The groups value is a list of one or more group names separated by spaces commas.
-inactive
Specifies that the releases being modified shall be set to inactive. Inactive releases cannot be used by developers for development work.
-included_releases included_releases
See -included_releases included_releases.
-included_release_file file_path
See -included_releases_file file_path.
-manager manager
See -manager manager.
-m|-modify
Modifies the specified release.
-noallow_dcm_transfer
Specifies that the releases should be set as ineligible for DCM replication.
-noallow_parallel_check_in
Specifies that parallel check in for objects with this release is not permitted. Note that the combination of parallel check in but no parallel check out is invalid.
-noallow_parallel_check_out
Specifies that parallel check out for objects with this release is not permitted. Note that the combination of parallel check in but no parallel check out is invalid.
-nocct|-nocreate_component_tasks
Specifies that component tasks will not be automatically created when baselines are published for the release definition being modified. You can create component tasks manually after a baseline is published for the release by using the Creating component tasks for a baseline subcommand.
-phase phasename
Specifies that the release phase should be set for the specified releases. The valid release phases are defined in the model attribute release_phase_list. The default values are New, Requirements Definition, Function Definition, Implementation, Validation, and Released.
release_spec
Specifies the releases to modify. See Release specification for details.
-rpr|-remove_process_rule|-remove_process_rules process_rule_spec
Removes the specified process rule from each of the releases specified by the arguments. See Process rule specification for details.

Example

About this task

  • Modify the release information to set a new description, a new manager and a release in the Implementation phase.
    ccm release -modify -description "version a of release 1.0 without graphics capability" -manager jane -phase Implementation client/1.0a

Feedback