You can show the work area properties of a project. If you do not specify a project, the command shows the work area properties of the project whose work area is associated with the current working directory.
About this task
ccm wa|work_area -s|-sh|-show [-r|-recurse] [-f|-format format]
[-nf|-noformat] ([-ch|-column_header] | [-nch|-nocolumn_header])
[-sep|-separator separator] ([-sby|-sortby sortspec] |
[-ns|-nosort|-no_sort]) [-gby|-groupby groupformat]
ccm wa|work_area -s|-sh|-show [-r|-recurse] [-p|-project]
[-f|-format format] [-nf|-noformat]
([-ch|-column_header] | [-nch|-nocolumn_header])
[-sep|-separator separator] ([-sby|-sortby sortspec] |
[-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] project_spec...
- -ch|-column_header
- Specifies to use a column header in the output format. See -ch|-column_headers for details.
- -f|-format format
- Specifies the command output format. See -f|-format for details.
A keyword can be built in (%fullname, %displayname, %objectname) or the name of any existing attribute such as %modify_time or %status.
See Built-In keywords for a list of keywords.
- -gby|-groupby groupformat
- Specifies how to group the command output. See -gby|-groupby for details.
- -nch|-nocolumn_header
- Specifies not to use a column header in the output format. See -nch|-nocolumn_headers for details.
- -nf|-noformat
- Specifies not to use column alignment. See -nf|-noformat for details.
- -ns|-nosort|-no_sort
- Specifies not to sort the output. See -ns|-nosort for details.
- p|-project
- It is not necessary to specify this option.
- project_spec
- Specifies the project to be shown. See Project grouping specification for details.
- -sby|-sortby sortspec
- Specifies how to sort the command output. See -sby|-sortby for details.
- -sep|-separator separator
- Used only with the -format option. Specifies a different separator character. See -sep|-separator for details.
- -r|-recurse
- Causes all projects in the project hierarchy to be shown along with the specified project. The default is to only show the specified project.
- -new
- Used with -find -replace to indicate that the database is new. This option is intended for two situations: when the work areas specified by the -find option are not visible, or are visible but are ignored.
- -ns|-nosync
- Specifies not to sync the work area.
- -reg|-regexp
- Indicates that new_string and find_string are regular expressions.
- You can use this option only with the -find option.
- -replace "new_string"
- Substitutes new_string for find_string in the work area paths of all of the projects found using the -find find_string option.
- Use the -reg option if you want to use a regular expression (for example, ".*") for new_string.
- You can use this option only with the -find option.
- -scope
- Establishes an initial criterion for which projects can be found using the -find or -dbpath options.
The scope option can be one of these states:
working (all of your working-state projects)
checkpoint (all of your checkpoint-state projects)
prep (all prep projects)
shared (all shared projects)
Alternatively, the scope option can be one of these case-sensitive keywords:
STATIC (all of your non-writable projects; for example, projects in the integrate, test, sqa, or released state)
ALL (all projects, regardless of status)
DB (all projects for the current database, regardless of ownership or status)
If the scope is working, checkpoint, or ALL, the projects must be owned by you.
The default scope is working.
You can use this option only with the -find or -dbpath option.
- -visible
- Indicates to consider only visible work areas for update.
A message is displayed for work areas skipped because the work area is not visible to the interface. The default is -visible.
See the -new option for information about updating work area paths of projects that are in a database in which work areas have not yet been created.
You can use this option only with the -find option.