Checking the Status of Loaded Thesauri (lkt_thlist)

The following command returns a list of lists of thesaurus statistics - one list per thesaurus - specified.

dvkerr_t lkt_thlist(lpar_t host, lpar_t names, lpar_t *thstatlists );

At this time only the thesaurus name, type and number of unique terms is returned.

Input

host (optional)

This is used to identify the server. For more information, see Communicating with TIBCO Patterns Servers

names (optional)

is a list of thesaurus names (LPAR_STR_THESAURUSNAME's) of existing loaded thesauri. It is an error (DVK_ERR_THESNOTFOUND) if any of these thesauri do not exist.

A value of LPAR_NULL might be supplied for names. This causes statistics lists for all currently loaded thesauri to be returned.

Output

thstatlists (required)

is the list of statistics lists. Each item in the list is a generic lpar list containing the following values:

•

LPAR_STR_THESAURUSNAME the name of the thesaurus.

•

LPAR_STR_THESAURUSTYPE one of: substitution, weighted term, combined.

•

LPAR_INT_NUMTOKENS a count of the total number of tokens (words) in the thesaurus. This is mostly useful as a rough check of whether two versions of a thesaurus are the same.

•

LPAR_LONGINT_TRAN_ID is the transaction id of the transaction that owns or claims the object at that instance.

•

LPAR_INT_TRAN_OBJ_STATE is the state of an object when a transaction owns or claims it; if there is no such transaction, it returns LKT_TRAN_OBJ_EXISTS.

 

Error codes and items returned by lkt_thlist

THESNOTFOUND	list of names of nonexistent thesauri
EXPECTLIST	item that was expected to be a list
PARAMVAL	item that had an invalid value
NODBDESC	(none)
NOSYSINIT	(none)