Reading out the Application configuration of Litmus Production Record Database
Litmus Production Record Database keeps required settings in an internal table, which can be read by users.
User can do this either by using applications such as:
- Microsoft SQL Server Management Studio
- MSSQL CLI
This can also be used for building custom solutions based on applications which allow for an ODBC connection such as:
- Excel
- C#
- .Net
- Python
Run SELECT query with View PROREC_Misc_GetAppConfig as FROM clause.
To read out the application configuration of Litmus Production Record Database, execute a SELECT statement from the view PROREC_Misc_GetAppConfig. Below is an example using T-SQL in SQL Server Management Studio:
The view returns a table as result.
Example for a Windows Installation.
Example for a Linux Installation
Configuration Items which can be changed.
ConfigItem | Description | Changeable? |
---|---|---|
Days_to_Keep_Log | The number of days for which to keep data in the log tables before purging. The tables impacted are:
| Yes |
Days_to_Keep_ProRec | The number of days for which to keep production record event data before writing them into a backup text file and purging them. | Yes |
Days_to_Keep_Tag | The number of days for which to keep tag data before writing them into a backup text file and purging them. | Yes |
Misc_Transaction_Count | To prevent that a large number single data point insert can cause a performance slow down, the application will automatically monitor the average number of data points written to the database in a 5 second interval every 5 minutes. This number of data points is then used, to create a batch of this size of data before processing them. The largest batch can be 500. Users can modify this value, for example if they change to a note periodic data insert method. But the value can be overwritten by the automated routine if it detects a change which could cause a slower performance and the value for the config item "Misc_Transaction_Count_Mode" is set to 1. | Yes |
Misc_Transac_MaxAge | To ensure, data are not stuck in the transaction tables and are always processed, the system checks frequently for old data. To define what is considered old data, the system does use this value which is the age in minutes to verify if they should be processed. | Yes |
Backup_Path | This is the path where the backup files will be stored. By default, the system will use the same path used by the database. | Yes |
Backup_File_Seed_Tag | This is the prefix used for naming the backup files for tag data. | Yes |
Backup_File_Seed_Tag_Meta | This is the prefix used for naming the backup files for tag data meta data. | Yes |
Backup_File_Seed | This is the prefix used for naming the backup files for production record event data. | Yes |
Queue_Monitor_Graze_Period | The system constantly does monitor if any procedures which are scheduled have executed. In the case of a system restart, this value in minutes is used to give the system enough time to get up and running before monitoring again. | Yes |
Scheduler_NextRunAhead | This is the time in minutes into the future at which a newly scheduled task can execute the earliest | Yes |
Misc_Transaction_Count_Mode | This allows the user to enable or disable the automated monitoring for the transactions tables. If disabled, the system will use the value provided by the config item "Misc_Transaction_Count" and does not adjust it. | Yes |
Max_WaitTime_Broker_SID | This time in seconds is used by the system to identify blocking SID's to be able to clear them. | Yes |
Hierarchy_Backup_File_Seed | This is the prefix used for naming the backup files for production record data model hierarchies. | Yes |
Tag_Hierarchy_Backup_File_Seed | This is the prefix used for naming the backup files for tag definitions. | Yes |
AT_ServiceBroker_Verbose | This is a flag which can be used to control the type of log entries made into the table PROREC_AT_ServiceBroker_Logs. By default the value is 0 which disables the logging of any asynchronous query execution to save on disc pace used for the log table. The value 1 will enable logging. | Yes |
Hours_to_Keep_AT_Log | The number of hours for which to keep data in the log table before purging. The tables impacted are:
| Yes |
Debug_Log | This is a flag which can be used to control the type of log entries made into the table:
By default the value is 0 which will only store the start and end of an activity with no further detail. The value 1 will enable detailed logging. This will increase the number of rows stored in the log tables and therefore will also require more disc space. | Yes |
MaxIdentifiers | This value is used by the event monitoring subsystem. To be able to allocate new events correctly an assistance table calld PROREC_Event_Events_Identifiers is used to record when the Event monitoring subsystem found new identifier combinations including their exact timestamp. This is done before the data are actually stored in the Production Record data storage. To not have this assistance table hold to much unnecessary data, it is regularly (every 15 minutes) trimmed to this number of records for each event. | Yes |
Configuration Items which can not be changed.
ConfigItem | Description | Changeable? |
---|---|---|
Failed_Trans_Count_<X> | This is an internal value which is created for every data model. Where <X> is the data models ID. The value represents the number of items and is used to facilitate how often to try to reprocess production record events if they failed to process for example because of missing identifiers. | No |