Message resend: resend_db command

The resend_db engine command is for resending messages. This command reads messages from a temporary, and optionally encrypted, database and sends them forward.

The IDE and Global Monitor use resend_db when using a database.

The resend command is used for file-based SMAT.

The -E and -D commands are for the database option. The other options are the same as the resend command.

Note: "Base site" is the site on which the newly created site is based. For example, for hcisiteinit.pl this is the site name passed with the -c option, or siteProto without the -c option. For hcirootcopy.pl, it refers to individual sites in the site list that are passed by the -s or -l option.

Usage:

resend_db ib_pre_tps|ib_post_tps|ob_pre_tps|ob_post_tps filename
 [-e msg_encoding] [-E [0|1]] [-D [sqlite]]
Option Scope Description
-E
  • + hcisiteinit.pl
  • + hcicreatesite.pl
  • + hcirootcopy.pl
  • + hcirsiterestore.pl
  • * resend_db cmd
  • SMAT is encrypted (=1), or not encrypted(=0).
  • Encryption key is read from $HCISITE.
  • + Indicates that values are stored in SMAT encrypted configuration in siteInfo of the new site, essentially overriding the value in base site.
  • * Indicates whether input files are encrypted. Default is 0.
-D
  • + hcisiteinit.pl
  • + hcicreatesite.pl
  • + hcirootcopy.pl
  • + hcirsiterestore.pl
  • * resend_db cmd

The driver is used to read/write SMAT.

Acceptable values are:

  • file: SMAT is stored in .msg and .idx files.
  • sqlite: SMAT is stored in SQLite database (with .smatdb file extension).

Using -E=1 and -D=file is an invalid combination.

+ indicates that values are stored in SMAT driver configuration in siteInfo of the new site, essentially overriding the value in base site.

* indicates the driver to be used for input files. For resend_db, -D is implied.

Note: SQLite is integral to engine functionality. When the first connection to a smatdb file is opened, wal and shm files are temporarily created. These are located in the same directory as the smatdb file and use the same name as the smatdb file. These are normally removed when the last connection to the smatdb file is closed. If you move the smatdb file, then you must also move these temporary files; otherwise, data is lost.

There are two formats for file based SMAT: old and new. This script converts between the file-based SMAT format and database-based SMAT format. This script can only be used as a database export utility.

When a SMAT database file is encrypted, the encryption information is read from $HCISITEDIR/siteInfo environment variable or it can be overridden with the -s option.