Start/notes.ini Parameters/DBMT_FILTER

DBMT_FILTER

🛠️
Parameter: DBMT_FILTER
Short description: Restricts which NSF databases the Database Maintenance Tool (dbmt) processes – e.g. only mail/*.nsf or individual directories.

Profile

Parameter
DBMT_FILTER
Category
Performance / Memory
Component
Server
Available since
10.0
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
Comma-separated path/file patterns, e.g. mail/*.nsf,apps/*.nsf

Description

By default, dbmt processes all databases in the data directory. On large servers or for a staged rollout, it makes sense to restrict maintenance to specific areas – e.g. mail files first, then applications. DBMT_FILTER contains a comma-separated list of path/file patterns. Only databases matching at least one pattern are processed by the next dbmt run.
Alternatively, the filters can also be passed directly on the dbmt command line – the notes.ini entry acts as a default for all automatic invocations (e.g. from the Program document).

Example configuration

DBMT_FILTER=mail/*.nsf,apps/*.nsf

Notes & pitfalls

  • Paths relative to the DataDirectory.
  • Wildcards * are supported; recursive patterns (e.g. **/*.nsf) depend on the version.
  • Complementary to DBMT_COMPACT_THREADS, Compact_Max_Threads, Update_*.
  • Do not use as a security measure – excluded NSFs are still opened/read.
  • Takes effect on the next dbmt run; a server restart is not strictly required.