When trying to write custom tools or integrations using the java API it often comes to the point where the relationshipflags are of interest.
e.g. In a custom tool we need to indicate a suspect relationship to between two specific items, lets say req and test; while the req is linked to other 3 testcases and the testcase is linked to 6 other req.
The "Trace Status" field is of no use, as it is a "accumulated" not a "specific" value.
Currently the only way to get to these flags is via the "displayId" of the relationship field which gives you a string. Then this string must be parsed to find a "?" that indicates SUSPECT.
IMHO this is not only fiddly but also hard to maintain.
When using the mksapiviewer i can see that there is actually a "relationshipflags" attribute for each related item, so this should be accessable via the java api (read and write), as it already is in the trigger api ( see LocalTriggerManager.ScriptRelationshipBean)