si locate limit to active paths

[MF2]

Hello!

We are trying to get some meta data out of integrity and want to use "si locate" to find a list of locations where the current project is reused. In the GUI, there is an option named "Limit Search to Active Paths". But this functionality is not documented for the "si locate" command.

Is this an undocumented feature, or is it implemented in another command for the commandline tools?

BR,

Markus

[awalsh · Accepted solution]

Active Paths means only registered projects will be searched for the member/subproject. If a project is dropped, then it does not show up in the list if you use --limittoactivepaths. 

The man page for si locate and Online help for Locate have some additional details for the --limittoactivepaths option:

--[no]limittoactivepaths
specifies whether to search projects referenced by current registered top level projects on the server.

Limit Search to Active Projects searches projects that are accessible from head revision 
and are registered projects.

Note: there was an issue with the Active Paths prior to 11.0, which require re-computing the active paths to fix. Please see information in the 11.0 Release Notes, under Software Configuration Management: Integrity Lifecycle Manager 11.0 General Notes. 

[awalsh]

The Active Paths are managed using the isutil -c cmactiveon command, which is documented in the Installation and Upgrading Guide, under Server Configuration > Server Troubleshooting > Using isutil to Manage the Database Repository. By default, active paths are turned on.