Routines for diagapi.kb


DeleteHypernode

File Name

diagapi.kb

Syntax

intRet:= DeleteHypernode ( hypernode_id );

Parameters

whereClause - The where clause, which must be based

on the primary key (hypernode_id) only so that it

will work when applied to the response table.

Returns

INTEGER - Return values for the SQLDelete(s)

Side Effects

None

Description

This function will delete a Hypernode record from the database. For Informix (only) it will alse cascade the deletes for the associated Response records. The reason we cannot do it all from a series of before/during/after Hypernode delete triggers (like we do in Oracle), is that Informix does not allow you to modify the triggerring table in any triggered SQL statement, irregardless if it was fired "before" or "after". The only exceptions to this rule are: 1) The triggering event is an UPDATE AND the triggered SQL statement is and UPDATE AND there is no overlapp in the updated columns. - OR - 2) The triggered statement is a SELECT Since the delete trigger for Response causes the child hypernode's IS_ROOT column to be set to NULL, having the delete trigger on Hypernode cascade the Response deletes would violate this rule.

Dialog Forms Called

None


GetGotoNodes

File Name

diagapi.kb

Syntax

GetGotoNodes ( targetNode, nodeList );

Parameters

INTEGER - hypernode ID to search on

Returns

BOOLEAN - TRUE if secondary linkages were found.

Side Effects

None

Description

This function loads the list of hypernodes that act as secondary linkages to the given node.

Dialog Forms Called

None


GetHyperNodeWithID

File Name

diagapi.kb

Syntax

GetHyperNodeWithID ( hypernode_id, hyperNodeRec );

Parameters

INTEGER - hypernode ID to search on

Returns

INTEGER - SQLSelectInto return value

Side Effects

None

Description

This function loads information relating to a Diagnostic Node into the Hypernode reference parameter. The record loaded corresponds to the hypernode_id passed in.

Dialog Forms Called

None


GetMultipleRoots

File Name

diagapi.kb

Syntax

GetMultipleRoots ( RootList );

Parameters

RootList - variable that will hold the list of nodes to

be used as roots.

Returns

Nothing

Side Effects

None

Description

This function starts a dialog box which prompts the user to select which roots to be loaded. Used with hypertree editor.

Dialog Forms Called

diagedit.dfc[multirootprompt]


HyperNodetoSolution

File Name

diagapi.kb

Syntax

HyperNodetoSolution ( HYPERNODE, SolutionsRecord);

Parameters

Hypernode - record holding information relating to a

Diagnostic Aid

SolutionsRecord - record holding information relating to

a solution.

Returns

Nothing

Side Effects

None

Description

This function converts information in a HYPERNODE record to solution information.

Dialog Forms Called

None


InitializeHyperSolutionFields

File Name

diagapi.kb

Syntax

InitializeHyperSolutionFields ( hyperNodeRec );

Parameters

Hypernode - record holding information relating to a

Diagnostic Aid

Returns

Nothing

Side Effects

None

Description

This function initializes the solution information for a Hypernode record.

Dialog Forms Called

None