Checking the Status of Loaded Learn Models (lkt_rllist)

The following command returns a list of lists of TIBCO Patterns Learn Model information, one list per model specified. 
dvkerr_t lkt_rllist(lpar_t host, lpar_t names, lpar_t *rlstatlists );

The information returned includes the name of the model, the metadata associated with the model and the number of features in the model.

Input

host (optional)

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

names

specifies one or more Learn models to be listed. If the value of LPAR_NULL is given information on all currently loaded models is returned. If a single lpar is given information on the named model, LPAR_STR_RLMODELNAME is returned. Otherwise this must be a generic list (LPAR_LST_GENERIC) of LPAR_STR_RLMODELNAME values and information, on each of the named models, is returned.

Output

rlstatlists (required)

is the list of statistics lists. The value returned is a list of generic lists (LKT_LST_GENERIC) containing the following values:

•

LPAR_STR_RLMODELNAME the name of the model

•

LPAR_INT_RLNUMFEATURES the number of features in the model, that is, the number of input feature scores the model expects.

•

LPAR_STR_RLMETADATA the metadata for the model (arbitrary text data associated with the model when it was saved to file)

•

LPAR_STR_RLTAGSINFO shows all of the tags for this model. The values are encoded as: '<'tag-name'='tag-value'>' The currently defined tag-names are: THRESHOLD, ID, and VERSION. If there are no tags for this model "=NONE=" is returned.

•

LPAR_STR_RLMODEL_EXT_ID if an external ID has been assigned to this model this value is returned with the external ID value. Generally external IDs are only used in a clustered environment and are generated by the Gateway server.

•

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, returns LKT_TRAN_OBJ_EXISTS.

Error codes and items returned by lkt_rllist

EXPECTLIST	the item that should have been a list of model names
FEATURESET	(none)
INTERNAL	the details on the error that occurred
LOOKUP	(none)
NODBDESC	(none)
NOSYSINIT	(none)
PARAMVAL	an item that should be a LPAR_STR_RLMODELNAME or zero length LPAR_STR_RLMODELNAME value
RLINKMODELNOTFOUND	the name of the model not found