Event Log Query Result

This MotoHawk™ block is part of the Logging Blockset and allows the result of an Query Initiate or Query Next to be recovered.

Block ID

Event Log Query Result

Library

motohawk_logging_lib

Description

This MotoHawk™ block is part of the Logging Blockset and allows the result of an Query Initiate or Query Next to be recovered.

This block's execution is synchronous, but it is accessing an underlying service that might not be ready. If the status returns zero (Log - Busy) then the result of the last query is not yet available. The result will need to be examined again later. If the status returns one (Log - OK) then the result is available on the other output ports. A result of greater than one implies there has been an error of some kind. The 'motohawk_eventlog_status_enum' script enumerates the errors.

Output Ports

Status (uint8)

A status of [0](Log - Busy) indicates that the query is still underway. Try again later.

A staus of [1](Log - OK) indicates that the query was ready and the other outputs have captured the result.

A status of two or more indicates that the query was completed, but that there was an error. The value indicates the type of error. The error could relate to this specific log entry. For example, [2](Log - Bad CRC) implies the event was found, but it has been corrupted. A value of [5](Log - Event Not Found Range) is because there are no more events available while ([10](Log - Bad Handle) implies a query result request was made using a name query that was not initiated.

EventID (uint8)

The EventID of the recovered event.

EventCODE (uint8)

The EventCODE of the recovered event.

EventTime (uint32)

The EventTime of the recovered event.

Data (uint8)

An array of data. Data requested that exceeds what was recorded in the event log is indeterminate.

Block Parameters

Parameter Field	Values	Comments/Description
Query Name	Single quote enclosed c-legal alpha-numeric text	The name of the query that this result applies to (assigned via Query Initiate).
Num Data Bytes	Positive integer	How many data bytes to be recovered. Defines the width of the data port and does not populate when zero.