Built-in keywords

You can use the keywords that are built into the product to control the format of the output from query, list, and show operations on the command line and query operations in the GUI.

You also can use attribute names as keywords. To list the attributes that are associated with an object, use the ccm attr command with the -list option.

Keyword Description
%baseline Returns a baseline project for a project. Returns <No baseline> if no baseline exists.
%change_request Displays one or more change requests that are associated with the object. For a file, these change requests are determined based on the associated tasks and the change requests that are associated with those tasks.
%change_request_duplicates Returns a list of a duplicate change requests for a change request
%change_request_original For a change request in the duplicate state, returns the original change request that it is a duplicate of
%change_request_release Displays the release property of change requests that are associated with the object
%change_request_status Displays the status of one or more change requests that are associated with the object
%change_request_synopsis Displays the synopsis of one or more change requests that are associated with the object
%displayname Defaults to name-version for files, directories, and projects
%fullname Returns the four-part name in the following format: subsystem/cvtype/name/version
%has_relationship Displays the objects that have a relationship from the object in the query
%in_baseline Returns the display name of a baseline for a project, if the project is in a baseline
%in_build Returns the build number of the baseline for projects that are members of a baseline, if the project is in a baseline
%instance Is the alias for the %subsystem part of the object name
%is_relationship_of Displays those objects that have a relationship to the object in the query
%model Returns the %fullname of the current model object
%objectname Returns object name in the following format: name-version:cvtype:subsystem
%problem_duplicates Returns a list of duplicate problems for a problem
%problem_original For a problem in the duplicate state, returns the original problem that it is a duplicate of
%purpose Displays a project purpose
%requirement_id Displays the requirement ID saved on the change requests that are associated with the associated tasks for a task or object
%root If the object is a project with a root directory, the keyword expands to the fullname of the root directory of that project. If the object is a project that does not have a root directory, or if the object is not a project, the keyword expands to <no_root>.
%sourcename Defaults to the name of the object
%states Returns legal object states separated by spaces
%task Returns a comma-separated list of task numbers associated with this object. Returns <void> if no associated tasks exist.
%task_platform Returns a comma-separated list of platform values of the tasks associated with this object. Returns <void> if no associated tasks exist.
%task_release Returns a comma-separated list of release values of the tasks associated with this object. Returns <void> if no associated tasks exist.
%task_status Returns a comma-separated list of task statuses associated with this object. Returns <void> if no associated tasks exist.
%task_subsystem Returns a comma-separated list of subsystems (task_subsys) values of the tasks associated with this object. Returns <void> if no associated tasks exist.
%task_synopsis If the object is a task, this keyword returns the task_synopsis attribute. Otherwise, this keyword returns a semi-colon-separated list of task_synopses for the tasks associated with this object. The keyword returns <void> if no tasks are associated.
%type Returns the type of the object (stored in the cvtype attribute)

Feedback