Solutions
...
Litmus Production Record Datab...
Interacting with Litmus Produc...

Reading out the Application configuration of Litmus Production Record Database

6min

Use Cases

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

Method

Run SELECT query with View PROREC_Misc_GetAppConfig as FROM clause.

How to use

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:

SELECT [ConfigItem] ,[ConfigValue] FROM [LE_ProductionRecord].[dbo].[PROREC_Misc_GetAppConfig];

Result

The view returns a table as result.

Example for a Windows Installation.

Document image


Example for a Linux Installation

app config linux
app config linux


Understanding the Output

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:

  • PROREC_Event_Log
  • PROREC_Misc_Log
  • PROREC_Tag_Log
  • PROREC_ProRec_Log
  • PROREC_ERROR_Log

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:

  • PROREC_AT_ServiceBroker_Logs

Yes

Debug_Log

This is a flag which can be used to control the type of log entries made into the table:

  • PROREC_Event_Log
  • PROREC_Misc_Log
  • PROREC_Tag_Log
  • PROREC_ProRec_Log

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