SIS - Application Programmatic Interface, Reference Manual - ICS ...

SIS-Application Programmatic Interface, Reference Manual
set_tl_cond( sessionID,FAIL(sessionID));
set_fl_cond( sessionID,
BELONGS( sessionID,
LINK( sessionID,"PhysicalObj","Parts"),
GET_CLASSES( sessionID, SET_ID( sessionID, 0))
)
);
set_tv_cond( sessionID,
OR( sessionID,
EQ( sessionID,
VAL(sessionID,1),
CARD(sessionID,
GET_LINK_TO(sessionID, SET_ID(sessionID,0))
)
),
BELONGS( sessionID,
SYS_ID(sessionID,0),
SET_ID(sessionID,3)
)
)
);
6.3.6 Special recursive queries
There are some recursive queries, special cases of the general recursive query, that are
frequently used and are explicitly implemented for efficiency. The only condition
taking into account in these queries is the category or the meta-category of the
traversed links. These categories must have been defined with set_categories().
When traversing is done with restricted depth, the nodes which have links that could
be traversed but this didn’t happed because of the depth, are accumulated into an
edge_set at the server site and can be given to the client application with the
These functions return APIFail(-1) on error or the set identifier of the temporary
set where the answer is stored.
return_edge_node() described below.
int get_traverse_by_category(int sessionID, int set_id, int isa)
Before calling this query function some categories must have been defined
with the set_categories() function. If set_id is 0, starts from the current node
and traverses all the links whose category is one of those previously defined
with the set_categories() function. With the set_depth() function the depth of
traversing can be controlled. The isa argument can be any of UPWARDS,
DOWNWARDS, UP_DOWN or NOISA. If UPWARDS is used, then for each node visited
on traversing, all superclasses of this node are visited too. If DOWNWARDS is
used, then for each node visited on traversing, all subclasses of this node are
visited too. In case of UP_DOWN both all superclasses and all subclasses for
each node are traversed. Nothing of these two happens when NOISA is used.
The answer set contains the system identifiers of all the traversed links.
If set_id is a positive integer, apply get_traverse_by_category() on each
object in temporary set set_id.
int get_traverse_by_meta_category(int sessionID, int set_id, int isa)
August 2002/v2.2.2 -29- ICS-FORTH