Queries the database for baselines that match the specified information.
Queries the database for baselines that have the specified build string. This query function expands to "cvtype='baseline' and build='build_string'", which returns the set of all baselines with the given build string, i.e., with a matching build attribute.
Queries the database for change requests that have the specified number.
Queries the database for folders that have the specified number.
Queries the database for all object versions that have the attribute attr_name (e.g., is_product or platform).
has_child ('object_name','project_name')
Queries the database for all directory object versions in project_name that have object_name as a member.
Queries the database for all project object versions that have the specified object version as a member.
Queries the database for all of the object versions that use the specified model object version as their model.
For example, if you use the Base Model, this query is has_model(base-1:model:base').
Queries the database for objects that do not have a relationship of that name to any object.
For example, has_no_successor returns every object that does not have a successor.
has_predecessor ('object_name')
Queries the database for all object versions that have the specified object version as an immediate predecessor.
privilege_name specifies the name of a privilege, such as read or write.
Queries the database for all projects that have the specified purpose.
has_relationship ('object_name')
Queries the database for all object versions that have a relationship of type relationship with object_name. For example, Rational Synergy uses has_successor to show history relationships in the History dialog box.
The relationship can be any established relationship such as associated_cv or associated_task.
Note that is_relationship('objectspec', 'operator', time) is the inverse query of has_relationship_of('objectspec', 'operator', time).
Queries the database for all object versions of type type_name.
For example, a query of has_type ('csrc-1:cvtype:base') might find HelloWorld-1:csrc:1.
hierarchy_project_members ('project_name', order_spec)
Queries the database for all projects in the project hierarchy specified by project_name. The order_spec argument specifies the search order, as described in order_spec.
The query returns an ordered list of object version names. Use of other queries in conjunction with this query may change the order of the results.
Note that the project_name is returned from this query.
For a description of order_spec, see order_spec.
Queries the database for object versions that are members of any project. This is best used when specifying other limiting options, such as the name of a project.
is_child_of('object_name','project_name')
Queries the database for all object versions that are used in directory object_name in project project_name.
Queries the database for objects that are leaf nodes in the History dialog box (i.e., queries for objects that do not have successors).
Queries the database for objects that are root nodes in the History View (i.e., queries for objects that do not have predecessors).
Queries the database for all object versions that are members of the specified project.
Queries the database for the model object version associated with the specified object version.
Queries the database for every object that is not the target of a relationship of that name to any object.
For example, is_no_successor returns any objects that are not successors.
is_predecessor_of ('object_name')
Queries the database for all object versions that are immediate predecessors of the specified object version.
is_relationship_of ('objectspec', 'operator', time)
Queries for all objects having the specified relation from the specified object whose relation create time matches the specified operator (that is, =, !=, >,<=, >, or >=) and time value.
For example:
is_associated_cv_of
( 'task23-1:task:M', '>', time ('May 1,
2002') )
This query finds all the associated objects of task M#23 that were related to the task after May 1, 2002.
Note that has_relationship('objectspec', 'operator', time) is the inverse query of is_relationship_of('objectspec', 'operator', time).
Queries for the type object version in the model that was used to create object_name.
recursive_is_member_of ('project_name', order_spec)
Queries the database for all members of all projects of the project hierarchy specified by project_name.
The query returns a list of object version names, with all non-projects occurring first in the list followed by the projects that are members of the hierarchy. Only the projects' positions within the results are significant to the search order. Use of other queries in conjunction with this query may change the order of the results.
Note that the project_name is not returned from this query.
For a description of order_spec, see order_spec.
Queries the database for tasks requests that have the specified number.
versions_in_a_baseline ('project_spec')
Queries for project versions in a baseline. This query function expands to "cvtype='project' and name='<project_name>' and instance='<project_subsystem>' and not is_no_project_in_baseline()'", which returns, for the project object, the set of all project versions that are in any baseline.