Database Administrator command-line options
Some configuration options are available through the command line. Select any options to tailor your view of messages in the database.
Caution:
Do not
terminate hcidbdump! Termination before it is
finished corrupts the database.
Usage examples:
hcidbdump [-U userid] [-v] -B [tarfile]
hcidbdump {-r|-e} [-U userid] [-l] [-L [-x]] [-v] [-D] [-f source_system] [-o owner_system] [-d dest_system] [-t type] [-s state] [-S time] [-E time] [-M map] [-O time] [-a] [-b [eof]] [-F] [-n metadata_filename] [-m mid] [-c] [-C] [-R] [-w searchExp] [output_file]
-
-B
performs database backup. -
tarfile
specifies the file name where the database backup is written. If notarfile
is specified, thentar
is written to $DBFPATH/cldb.tar. -
-r
saves message from recovery database. -
-e
saves message from error database. -
-U userid
specifies the user ID to access database. -
-l
specifies long form output. This is ignored whenoutput_file
is specified. -
-L
specifies ultra-long form output. Overrides-l
. -
-x
gives an expanded view of flags. This is ignored unless using-L
. -
-v
specifies verbose operation. -
-D
deletes messages after processing. -
-f source_system
selects messages with a specified source. -
-o owner_system
selects messages with a specified owner. -
-d dest_system
selects messages with a specified destination. -
-t type
selects messages with a specified type:-
D
specifies data. -
R
specifies reply. -
U
specifies unknown.
-
-
-s state
selects messages with a specified state. -
-S time
selects messages at or after a specified date/time. -
-E time
selects messages at or before a specified date/time. -
-M map
applies the map to each message. Uses themsgmapdata
command. -
-O time
orders output by ascending date. Time flags are:-
i
specifies inbound arrival time. -
o
specifies outbound time. -
r
specifies recovery time. -
x
specifies xlate start time.
-
-
-a
appends data to output file. -
-b [eof]
dumps message to output file in length-encoded or end-of-file format.-
-b
dumps in length-encoded format. -
-b [eof]
dumps in end-of-file format. Argument[eof]
is optional.
You must provide an output file name for
-b [eof]
; otherwise, an error message results. -
-
-F
deletes sent messages without prompting for confirmation. -
-n metadata_filename
enables metadata to be dumped from the error database into a file of the necessary format. -
-m mid
selects messages with specified message IDs:-
x.y.z
specifies only this message. -
x.y.z1:x.y.z2
specifiesx.y
messagesz1
throughz2
. -
-m
overrides all other restrictions.-m
does not work with-o
.
-
-
-c
shows context from error database. -
-C
prints only the message count. -
-R
is recovery mode for the recovery database. -
-w searchExp
searches the message content with the specified expression. The search is case-sensitive, and works only for the Error Database. -
output_file
specifies the file name where messages are written. If no output file is specified, then message data is written to stdout.All specified constraints are ANDed together.