Deleting a Database (lkt_dbdelete)

This command deletes a database, releasing all storage associated with it and with its records.

dvkerr_t lkt_dbdelete(lpar_t host, lpar_t name );
dvkerr_t lkt_dbdeleteT(lpar_t host, lpar_t name, lpar_t tran );

If the database has been checkpointed (see Checkpointing and Restoring a Database) the checkpoint is also deleted when the transaction is committed, and thus the database can no longer be restored with the lkt_restore command.

If durable-data is enabled, all of the files backing the table are removed when the transaction is committed.

Input

host (optional)

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

name (required)

is the name of the database (LPAR_STR_DBDESCRIPTOR) to be destroyed.

tran (optional)

identifies the user transaction (LPAR_LONG_TRAN_ID) under which the table delete operation is to be performed.

Error codes and items returned by lkt_dbdelete

CHKPT_CORRUPT	Name of table that has corrupt checkpoint information
DBNOTFOUND	name of nonexistent database
EXPECTDBDESC	item that should have been a table name
INTERNAL	details of unexpected error encountered
JOINSET	Name of parent table that has child tables linked to it
NODBDESC	(none)
NOSYSINIT	(none)
PARAMVAL	invalid table name
TRAN_UNKNOWN	lpar that contains the unknown transaction id
TRAN_IN_USE	lpar that contains the transaction id
TRANCONFLICT	list that contains LPAR_LONG_INT_TRAN_ID and LPAR_STR_ERRORDETAILS