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 specific directories.

Profile

Parameter
DBMT_FILTER
Category
Performance / Memory
Component
Server
Available since
9.0.1
Supported versions
9.0.1, 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 phased rollout, it makes sense to restrict maintenance to specific areas — e.g. first only the mail files, later also applications. DBMT_FILTER contains a comma-separated list of path/file patterns. Only databases that match 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) are version-dependent.
  • Complementary to DBMT_COMPACT_THREADS, Compact_Max_Threads, Update_*.
  • Do not use for security — excluded NSFs are still opened/read.
  • Takes effect on the next dbmt run; a server restart is not strictly required.

Sources (HCL Product Documentation)