documented global variables used by DB functions