Showing work area properties

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.

Example


Feedback