Loading a Learn Model (lkt_create_rlmodel)

Using the following command you can load a TIBCO Patterns Learn Model either locally or on a remote server.

 

dvkerr_t lkt_create_rlmodel(lpar_t host, lpar_t name, lpar_t model );
dvkerr_t lkt_create_rlmodelT(lpar_t host, lpar_t name, lpar_t tran, 
                             lpar_t model );
dvkerr_t lkt_create_rlmodelX(lpar_t host, lpar_t name, lpar_t tran, 
                             lpar_t options, lpar_t model);

Input

host (optional)

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

name (required)

This must be an lpar of type LPAR_STR_RLMODELNAME. Like the database name, this is a null-terminated character string that is unique to the model.

model (required)

This is the location of the model file on disk. If the model exists on the local file system and a host is specified, use an LPAR of type LPAR_RN_FILE. Otherwise, use an LPAR of type LPAR_STR_RLMODELFILE. If no host is specified, the interface will read from the local file system. If a host is specified, the host will read the file, and the file must exist within the host's loadable-data directory.

If a model with the specified model name has already been loaded, it is replaced.

tran (optional)

This identifies the user transaction (LPAR_LONG_TRAN_ID) under which the Learn model is to be created.

options (optional)

This is either a supported option or a list of supported options.

Currently the only supported option is LPAR_BOOL_USE_MEMBLOCK.

LPAR_BOOL_USE_MEMBLOCK is only used by gateway engines (non-gateway engines ignore it). This option enables the transfer of very large Learn models through the gateway without the use of a temporary file; this might consume large amounts of memory on the gateway engine. This option is off by default. For more information, see the -G command line option in the TIBCO Patterns Installation Guide.

 

 

Error codes and items returned by lkt_create_rlmodel

NORLINKMODEL	(none)
PARAMVAL	the item that had an invalid value
PARAMMISSING	(none)
TRAN_UNKNOWN	the lpar that contains the unknown transaction id
TRAN_IN_USE	the lpar that contains the transaction id
TRANCONFLICT	the list that contains LPAR_LONGINT_TRAN_ID and LPAR_STR_ERRORDETAILS