Modifying work area properties

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.

Feedback