You can change the work area properties of a project, such
as the work area path and whether the work area is maintained. If
you do not specify a project, the command updates the project whose
work area is associated with the current working directory.
About this task
ccm wa|work_area ([-wa|-maintain_wa] | [-nwa|-no_wa])
([-cb|-copy_based] | [-lb|-link_based|-ncb|-not_copy_based])
([-rel|-relative] | [-nrel|-not_relative])
([-mod|-modifiable] | [-nmod|-not_modifiable])
([-wat|-wa_time] | [-nwat|-no_wa_time])
([-tl|-translate|-translation] | [-ntl|-no_translate|-no_translation])
[-set|-path|-setpath absolute_path]
[-pst|-project_subdir_template template_value]
([-r|-recurse] | [-nr|-norecurse|-no_recurse])
ccm wa|work_area ([-wa|-maintain_wa] | [-nwa|-no_wa])
([-cb|-copy_based] | [-ncb|-not_copy_based])
([-rel|-relative] | [-nrel|-not_relative])
([-mod|-modifiable] | [-nmod|-not_modifiable])
([-wat|-wa_time] | [-nwat|-no_wa_time])
([-tl|-translate|-translation] | [-ntl|-no_translate|-no_translation])
[-set|-path|-setpath absolute_path]
[-pst|-project_subdir_template template_value]
([-r|-recurse] | [-nr|-norecurse|-no_recurse]) [-p|-project]
project_spec...
- -cb|-copy_based
- Specifies that any work area is copy based.
- -lb|-link_based|-ncb|-not_copy_based
- Specifies that any work area is link based. This option is available
to UNIX users only.
- -mod|-modifiable_wa
- Specifies that files in the work area have permissions set so
they are modifiable even if they have not been checked out. The default
is -nmod|-not_modifiable_wa.
- -nmod|-not_modifiable_wa
- Specifies that files in the work area have permissions set so
they are modifiable by default only if they are in a writable state
such as working. The default is -not_modifiable_wa.
- -nr|-no_recurse
- Do not recurse the project hierarchy when applying these options.
Change only the specified project. The default is -no_recurse.
- -nrel|-not_relative
- Specifies that any work area is located on an absolute path.
- -ntl|-no_translate|-no_translation
- Specifies that ASCII files in the work area are copied between
Windows and UNIX without newline translation. The default is -translate.
- -nwa|-no_wa
- Specifies not to maintain the work area for the project. This
default is -maintain_wa.
- -nwat|-no_wa_time
- Specifies to use timestamps for the files in the project's work
are. The timestamps must show the modification time rather than the
time they were copied into the work area. This default is -no_wa_time.
- -p|-project
- It is not necessary to specify this option.
- project_spec
- Specifies the project to be modified. See Project specification for details.
- -pst|-project_subdir_template template_value
- Changes the specified work area path for the project (where the
project is synchronized to the file system) to a new location. This
parameter changes only the project-specific portion of the work area
path. To change to a different part of the file system for your work
area or synchronize your work area to a different platform, see the setpath_absolute_pathoption.
- The default directory in which all project work areas are created
is ccm_wa followed by the database_name in
your home directory. By default, the project name and version are
appended to the database_name. You can change the
project-specific portion of the name to include project_name, project_version, release, platform,
and delimiter by modifying the work area template.
- If the previous path is visible to the interface host, it is moved
to the new location. Otherwise, the work area is created when you execute the work_area command with this option.
- -r|-recurse
- Causes all projects in the project hierarchy to be updated along
with the specified project. The default is -nr|-norecurse.
- -rel|-relative
- Specifies to locate any work area on a path relative to the parent project's path.
- -set|-path|-setpath absolute_path
- Changes the specified work area path for the project to the new
location. This option changes the non-project-specific portion of
the work area path. To change the project-specific portion of the
name, such as project_name, project_version, release, platform,
and delimiter by modifying the work area template,
see the -project_subdir_templateoption.
- If the previous path is visible to the interface host, it is moved
to the new location. Otherwise, the work area is created when you execute the work_area command with this option.
- You can change the work area path of a read-only project only
if you are a build manager or a user in the ccm_admin role.
- tl|-translate|-translation
- Specifies to copy ASCII files in the work area between Windows
and UNIX with newline translation.
- -wa|-maintain_wa
- Maintain a work area. Setting this option synchronizes the work
area and keeps it synchronized.
- To stop a sync from the CLI, enter <CTRL+C> at
any time.
- If you stop the sync, an error message reports that errors might
occur in your work area. However, the errors do not occur until you
try to use the work area. To avoid problems, perform a synchronization
of the entire work area before you use it.
- You can use this option on a read-only project only if you are
in the ccm_admin role.
- -wat|-wa_time
- Specifies to use timestamps for the files in the project's work are. The timestamps must show the time they were copied
into the work area, rather than the modification time. The default
is -no_wa_time.