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

SIS-Application Programmatic Interface, Reference Manual
that took place between a begin_transaction() and an end_transaction() have
not been committed.
int abort_transaction(int sessionID)
Aborts a transaction session. It returns 1 on success, APIFail(-1) on failure. In
case of failure the operations that took place between a begin_transaction()
and an abort_transaction() have not been committed.
6.1.4 Using the locking mechanism
int get_writelock(int sessionID)
Gets writelock on the database. It returns APIFail on failure,
API_DB_CHANGED if the database is changed since last update,
API_DB_NOT_CHANGED if database has not changed.
int get_readlock(int sessionID)
Gets readlock on the database. It returns APIFail on failure, API_DB_CHANGED
if the database is changed since last update, API_DB_NOT_CHANGED if database
has not changed.
int release_lock(int sessionID)
Releases the lock got on the database with functions get_writelock() or
get_readlock(). It returns APIFail on failure, API_DB_CHANGED if the
database is changed since last update, API_DB_NOT_CHANGED if database has
not changed.
6.2 Set global parameters
There is a set of functions that set or alter values to global parameters that effect or
are used by the query functions. Such parameters are the current node where a query
function may apply on, the link categories that recursive queries use for traversing
link etc.
Most of the functions return APIFail(-1) on error and APISucc(0) on success,
except the ones that set the current node, which return the system identifier of the
new current node that has been set.
int reset_query(int sessionID)
Reset all variables at server site so that everything is at the state they are when
starting a new query session. Pop everything out of the name stack and free all
temporary sets.
int set_current_node(int sessionID, l_name node)
Set current node the object with logical name node. If the name scope is the
whole SIS base (default at the beginning of a query session or result of
reset_name_scope() call) the argument must be the name of a node object
otherwise it must be the logical name of a link object pointing from the current
node. The function returns the system id of the current node or APIFail(-1) on
failure.
August 2002/v2.2.2 -11- ICS-FORTH