Open topic with navigation

TIBCO® Patterns 6.1.2

# 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

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO® Patterns

Copyright © 2010-2025. Cloud Software Group, Inc. All Rights Reserved.