---

infos_node: database_info

comment:    database_info is a node returned by the built-in Salang function
            get_database_info().
            (accessible from the command line with "sawmill -p profile -a pdi")

structure:

  database_info:
    profile_name:                       string
    database_directory:                 string
    database_info:                      node
    built:                              bool
    database_is_ready_for_reporting:    bool
    write_locked:                       bool
    writing_task_id:                    string
    writing_for_report_id:              string    # TODO -- Is this still used?
    earliest_date_time:                 string
    latest_date_time:                   string
    last_operation:                     string
    last_modification_time:             string
    last_modification_time_localtime:   string
    date_time_dbfieldnum:               int

infos:

  - node:               profile_name
    comment:            The internal name of the profile that created and
                        manages this database.

  - node:               database_directory
    comment:            The directory containing this database.

  - node:               database_info
    comment:            The contents of the info.cfg file in the database
                        directory.

  - node:               built
    comment:            True if the database has been built.

  - node:               database_is_ready_for_reporting
    comment:            True if this database is ready to deliver reports
                        (e.g., is built, or is a real-time database that is
                        building and has gotten far enough into the build that
                        it can now report).

  - node:               write_locked
    comment:            True if a process has locked the database for writing.

  - node:               writing_task_id
    comment:            The task ID (pid) of the process which is writing this
                        database, if any.

  - node:               writing_for_report_id
    comment:            The report ID of the report that will be generated when
                        this writing task is done writing the database.

  - node:               earliest_date_time
    comment:            The date/time of the earliest day in the data in the
                        database.

  - node:               latest_date_time
    comment:            The date/time of the latest (farthest-future) day in
                        the data in the database.

  - node:               last_operation
    comment:            A human-readable description of the most recent
                        operation done on the database.

  - node:               last_modification_time
    comment:            The date/time of the last modification to this
                        database, in UTC.

  - node:               last_modification_time_localtime
    comment:            The date/time of the last modification to this
                        database, in local time zone.

  - node:               date_time_dbfieldnum
    comment:            The database field number of the date_time field, if
                        any.
...