All these methods can be used to get the first (oldest), next, last (newest) or previous
diagnosis message stored in diagnosis system. The only difference are the details
the methods provide. While, e.g., Get-xxx-Val just provides the basic information in numeric format, Get-xxx-ValExt additionally provides this information by the extended diagnosis data of the entry.
The numeric format provided by these methods can be converted into textual format
later on if required⮫ “Function DiagValToTxt”. Alternatively, the methods Get-xxx-ValAndTxt and Get-xxx-ValAndTxtExt can be used for numeric and textual format in parallel⮫ “Method Get-xxx-ValAndTxt / DiagGet-xxx-ValAndTxt: numeric values and text”⮫ “Method Get-xxx-ValAndTxtExt / DiagGet-xxx-ValAndTxtExt: numeric values, extended
numeric values and
text”.
All methods may need multiple cycles to process the request. Therefore, they must be called in successive cycles until they return a final result⮫ “Enumeration ERROR_ID”.
All diagnosis messages sorted by time, ascending
-
Call any
GetFirst...method until it indicates a final result. -
If the result is not "NO_ERROR_NO_DATA": Call any
GetNext...method as long as its final result is "NO_ERROR".
All diagnosis messages sorted by time, descending
-
Call any
GetLast...method until it indicates a final result. -
If the result is not "NO_ERROR_NO_DATA": Call any
GetPrev...method as long as its final result is "NO_ERROR".