SCM versus API

I do not believe that there is API available to do this so the command line would be the way to go.

Yup, there is, but it's certainly more involved. You can use the following to query for a snapshot:

IBaselineSetSearchCriteria query = IBaselineSetSearchCriteria.FACTORY.newInstance();

query.setExactName(name);



IWorkspaceManager client = ...

List<IBaselineSetHandle> results = client.findBaselineSets(query, Integer.MAX_VALUE, null);

if (results.size() > 0) {

    IBaselineSet snapshot = (IBaselineSet)itemManager.fetchCompleteItem(

        results.get(0), 

        IItemManager.DEFAULT, 

        null);

    return snapshot;

}

Then use this code to get the current baseline for a component in the workspace:

IWorkspaceConnection conn = ...

IHistoricBaselineIterator history = conn.getBaselinesInHistory(componentHandle, 1, null);

if (history == null || history.getBaselines().size() == 0)

    return null;

IBaseline baseline = (IBaseline)itemManager.fetchCompleteItem(history.getBaselines().get(0), IItemManager.DEFAULT, null);

Then this to generate a comparison report:

IWorkspaceManager mgr = ...

IBaselineConnection baselineConn = mgr.getBaselineConnection(baseline, null);

IChangeHistorySyncReport report = baselineConn.compareTo(otherBaselineHandle, null);

The IChangeHistorySyncReport class has all the methods to pull diff changesets. Getting a full changeset is very easy, and the class is uncomplicated:

IChangeSet cs = (IChangeSet)itemManager.fetchCompleteItem(handle, IItemManager.DEFAULT, null);

Hope this helps.

While the above code should do what you want, I think it is worth mentioning that it is not official API so you can not assume that it will work when used against future versions of RTC.

It seems my previous post was not accurate. The code in the com.ibm.team.scm.client package is API.