aaHistorianStatusSet
- Last UpdatedMar 10, 2025
- 2 minute read
Sets the value of the status flag, DbStatus, to a value greater than 0 when a database modification needs to be processed by the server (back end). Sets the value of DbStatus back to 0 when a database modification is complete.
Syntax
aaHistorianStatusSet DbStatus, Acquisition, Storage, DBServer
where:
|
Argument |
Description |
|---|---|
|
DbStatus |
For releases prior to 8.0, used to store the status of server reinitializations. 2 = Certain columns in the Tag, AnalogTag, DiscreteTag, StringTag, Topic, and IOServer tables were changed 3 = Reinitialization needed. 4 = Commit phase of a database update is in progress. 0 = Reinitialization complete. A negative value indicates that an error was encountered during reinitialization. This value is of data type int, with no default. |
|
Acquisition |
Used with DbStatus to indicate to the back end whether the acquisition subsystem needs to be restarted. 0 = Restart not needed. 1 = Restart needed. Currently not used. This value is of data type int, with a default of 0. |
|
Storage |
Used with DbStatus to indicate to the back end whether the Storage subsystem needs to be restarted. 0 = Restart not needed. 1 = Restart needed. Currently not used. This value is of data type int, with a default of 0. |
|
DBServer |
Used with DbStatus to indicate to the back end whether the database server needs to be restarted. 0 = Restart not needed. 1 = Restart needed. Currently not used. This value is of data type int, with a default of 0. |
Note: Only the first argument is required; the others are used to indicate that a specific subsystem needs to be initialized.
Remarks
When a change is made to the Runtime database configuration using the Operations Control Management Console, the value of the DbStatus attribute in the StorageNode table is set to a value greater than 0, meaning that modifications are outstanding and a reinitialization has yet to occur. The Operations Control Management Console, after detecting that a change is outstanding based on the value of DbStatus, makes the required changes, reinitializes the AVEVA Historian, if necessary, and then sets the value of DbStatus back to 0, meaning that reinitialization has been completed.
Permission
Execute permission defaults to the aaPowerUsers and aaAdministrators groups.