You can remove a project from a specified directory and
its associated context project. The directory must be specified using
a project reference specification form or a work area reference form
to provide the context project.
Before you begin
If the context project is in the
working state,
you must be the owner of that project. If the context project is in
prep state,
you must be a build manager.
About this task
ccm unuse -p|-project -dir dir_spec [-t|-task task_spec]
[-d|-delete [-f|-force]] [-r|-replace] project_spec...
- -d|-delete
- Remove the object from the directory and its context project,
then delete the object from the database.
- -dir dir_spec
- Specifies the directory to remove the object from. The dir_spec is
a file_spec (see File specification) that resolves to a single
directory object and provides a context project. A project reference
spec form or a work area reference form provides such a context project.
- -force
- This option must be used with the -d|-delete option.
Forcing a removal specifies that the deleted object is removed from
all projects that are modifiable by you before it is deleted from
the database. Without specifying -force, the object
is removed from the context project. The object is removed from the
database if the object is not a member of any project.
- project_spec
- Specifies the projects to be unused. See Project specification for details.
- -r|-replace
- Replace the object in the directory with its predecessor. When
this option is specified, the list of files in the directory remains
unchanged; only the version of the specified object changes.
- -t|-task task_spec
- Specifies to associate the specified task with the directory that
is automatically checked out. If -r|-replace is not
specified, the directory that contains the object is updated to remove
the entry for that object. If the directory is nonmodifiable, the
directory is automatically checked out. If the -t|-task option is
not specified, then the current task is used by default. See Task specification for details.
Example
- Remove the ico_jan5 and ico_jan6 subprojects
from the ico_jan4-1 top-level project.
ccm unuse ico_jan5 ico_jan6
Member ico_jan5-1 removed from project ico_jan4-1Member ico_jan6-1 removed from project ico_jan4-1
- Unuse the subproject SubProject_One-1 under the Dir of
the project Project_One-1.
ccm unuse -p -dir Project_One\Dir@Project_One-1 SubProject_One-1:project:1