Deleting Thesauri (lkt_delete_thesaurus)

This function deletes one thesaurus, a list of thesauri, or all thesauri.

dvkerr_t lkt_delete_thesaurus(lpar_t host, lpar_t names);
dvkerr_t lkt_delete_thesaurusT(lpar_t host, lpar_t names, lpar_t tran);

If a delete of multiple thesauri is requested all thesauri that can be deleted are deleted even if one or more deletes should fail. If one or more deletes fail a list of those that failed are returned as the error item.

Input

host (optional)

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

name (required)

identifies the thesaurus or thesauri to be deleted. If this is LPAR_NULL all currently defined thesauri are deleted. If this is LPAR_STR_THESAURUSNAME the thesaurus named is deleted. If this is a generic list (LPAR_LST_GENERIC) then each item of the list must be an LPAR_STR_THESAURUSNAME that names a thesaurus to be deleted. It is invalid to name the same thesaurus more than once.

tran (optional)

identifies the user transaction (LPAR_LONG_TRAN_ID) under which the thesaurus is to be deleted

Error codes and items returned by lkt_delete_thesaurus

DBNOTFOUND	list of database names not found
DBPARAM	invalid lpar from names parameter
DUPDBDESCS	duplicate thesaurus name
EXPECTDBDESC	item that should have been a thesaurus name
EXPECTLIST	item that should be a generic list of thesaurus names
FEATURESET	LPAR_NULL
INTERNAL	list of thesauri that failed to delete
NODBDESC	(none)
NOSYSINIT	(none)
PARAMVAL	item that should be a LPAR_STR_THESAURUSNAME value or zero length LPAR_STR_THESAURUSNAME value
THESNOTFOUND	list of thesauri from names that did not exist
TRAN_UNKNOWN	lpar that contains the unknown transaction id
TRAN_IN_USE	lpar that contains the transaction id
TRANCONFLICT	list that contains LPAR_LONGINT_TRAN_ID and LPAR_STR_ERRORDETAILS