Database Dump (lkt_dbdump)

Warning: This command is deprecated. The lkt_dbrecnext command should be used instead.

 

This function performs a non-destructive database dump. It is the opposite of the lkt_dbload command, in the sense that it converts from a database to a record list.

dvkerr_t lkt_dbdump( lpar_t dbdesc, lpar_t dump_opts, 
                     lpar_t *dbstatslist, lpar_t *reclist);

The original database is not unloaded or altered in any way.

Warning: When a database is dumped into a record list, new memory is allocated to store the new copy of the database. If the database is large, dumping the database can nearly double the amount of memory required by the application.
Note: This command is not supported when working through a gateway. Attempts to use this command with a gateway returns a feature set not supported error. For more information on gateways see Federated Tables and Gateways.

 

Input

dbdesc (required)

is the descriptor of the database (LPAR_STR_DBDESCRIPTOR) to be dumped.

For an explanation of descriptors see Communicating with TIBCO Patterns Servers.

dump_opts (optional)

is a list of lpars to control the dump behavior. The only supported option is an LPAR_INT_LOCKKEY to allow dumping a locked database.

Output

dbstatslist (optional)

is a list of lpars that give statistics on the database dumped, similar to those returned by lkt_dbload.

reclist (required)

is a list of the records which compose the database.

 

Error codes and items returned by lkt_dbdump

FEATURESET

(none)

DBLOCKED

database descriptor

DBNOTFOUND

database descriptor

EXPECTDBDESC

item that should have been a database descriptor

INTERNAL

description of error

NODBDESC

(none)

NOSYSINIT

(none)

PARAMVAL

lpar that contains an illegal value