SYSEVENT – Read system log

Block SymbolLicensing group: STANDARD

Function Description
This block serves to read records from the system log or archive. The archive to be read is selected by the arc parameter. Not all entries are displayed, but only those that pass through the filter. It is possible to filter by item ID (in the case of the system log it is meaningless - currently, all entries have id=1), by the level of alarm/event (in the case of the system log, categories are encoded there), and in the case of a text item, also by value.

The filter by ID is set using the idfrom and idto parameters, which select the interval to be displayed. If both values are the same, only one id is displayed, and if idfrom>idto, filtering by id is turned off and all ids are displayed.

The filter by level is set using the lvlfrom and lvlto parameters, with the same rules as in the previous case applying.

The filter by value applies only to text items (in the system log, these are all entries). An item is displayed only if it contains the text from the filter parameter. If the parameter is empty, all items are displayed. This parameter has no effect on other than text items, and they are always displayed (if they meet the settings of other filters).

As long as there are items in the archive that meet the filter, they are displayed so that one item is on the output in each tick (in the order they are stored in the archive) and the VALID output is set to on. When there are no more items, the outputs have the values corresponding to the last read item, but VALID is set to off.

The output sVal contains the value of the text item (for other types of items, it is empty). The output iVal contains the value of the integer item (for other types of items, it is 0). In all cases, all parameters (including the value) are stored in JSON format on the sEvent output. To retrieve the required values, the PJSOCT block, or possibly the PJROCT block, can be used.

Note: If multiple sysevent blocks are used, each goes through the respective archive separately. Depending on the set filter, it can happen that a certain item from the archive is output by both blocks, but usually at a different moment.

This block does not propagate the signal quality. More information can be found in the 1.4 section.

Parameter

arc	Archive to read (0=system log) $↓$ 0 $↑$ 16	Long (I32)
filter	String that item must contain	String
idfrom	Minimum item ID to show $↓$ 0 $↑$ 65535	Long (I32)
idto	Maximum item ID to show $↓$ 0 $↑$ 65535 $⊙$ 65655	Long (I32)
lvlfrom	Minimum item level to show $↓$ 0 $↑$ 255	Long (I32)
lvlto	Maximum item level to show $↓$ 0 $↑$ 255 $⊙$ 255	Long (I32)

Output

VALID	Output data are valid (actual)	Bool
sEvent	Whole archive item in JSON	String
sVal	Archive item value (string)	String
iVal	Archive item value (integer)	Long (I32)

[Previous] [Back to top] [Up] [Next]