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

SIS- Application Programmatic Interface, Reference Manual
int set_current_node_id(int sessionID, int nodeid)
Set current node the object with system identifier nodeid. This object is now at
the top of the name stack and if it is a link object the name stack is changed
properly (see section 4 where name stack is described).
int reset_name_scope(int sessionID)
Set current name scope the whole SIS base. The next set_current_node() will
refer to a class node.
int pop_name_scope(int sessionID)
Go one level below the current name scope. Useful when you have set for
example as current node an attribute of some class and want to refer to (set
current node) another attribute of the same class.
int set_categories(int sessionID, categories_set categs)
Set the categories for any subsequent call of some special recursive query.
Whenever this function is called, any previous set of categories is deleted. The
data type used for defining the categories is described in section 6.8.1.
int set_depth(int sessionID, int depth)
Set the depth the recursive queries are going to traverse links, starting from a
node object. If depth is a negative integer recursive queries traverse links with
no limit to depth.
6.3 Queries
Here follows the set of functions that query the SIS data base and calculate and
answer. The first group consists of very simple queries that give the system identifier
of an object if we know the logical name and vice versa. The other two groups consist
of functions that apply on the current node or on each object in a temporary set,
calculate an answer and put it into a new temporary set.
6.3.1 Low level queries
These functions return APISucc(0) on success and APIFail(-1) on error.
int get_classid(int sessionID, l_name lname, int *sysid)
Given the logical name lname of a node object, the function returns the system
identifier sysid of this object.
int get_linkid(int sessionID, l_name fromcls, l_name label, int *sysid)
Given the logical name label of a link object, the function returns the system
identifier sysid of this object. Since the logical name of a link object may not
be unique in the SIS base, the logical name fromcls of the node object the link
is pointing from must be given.
August 2002/v2.2.2 -12- ICS-FORTH