FC_GetNextExpiringException - General Information

Overview

Type:	Function
Available as of:	V1.0.4.0

Task

Determining the exception that will next lead to a certain reaction.

Description

The function searches the ExceptionDelayList. Searches for exceptions that trigger the specified reaction. The exception is stated that will become active next.

Interface

Input	Data type	Description
i_udiReaction	UDINT	Reaction the list of exceptions with delayed reaction shall be searched for.

Output	Data type	Description
q_etDiag	GD.ET_Diag	General, library-independent statement on the diagnostic. A value unequal GD.ET_Diag.Ok equates an error message.
q_etDiagExt	ET_DiagExt	POU-specific output on the diagnostic. q_etDiag = GD.ET_Diag.Ok -> status message q_etDiag <> GD.ET_Diag.Ok -> diagnostic message

Output

Data type

Description

q_etDiag

GD.ET_Diag

General, library-independent statement on the diagnostic.

A value unequal GD.ET_Diag.Ok equates an error message.

q_etDiagExt

ET_DiagExt

POU-specific output on the diagnostic.

q_etDiag = GD.ET_Diag.Ok -> status message

q_etDiag <> GD.ET_Diag.Ok -> diagnostic message

Input/Output	Data type	Description
iq_stException	ST_Exception	Structure into which the exception is written to, which next results in the searched reaction.
iq_stExceptionList	ST_ExceptionList	Exception list in which the list of exceptions with delayed reaction shall be searched.

Diagnostic Messages

q_etDiag	q_etDiagExt	Enumeration value	Description
OK	ExceptionWithSpecifiedReactionFound	89	Exception with a specified reaction was found
OK	NoExceptionWithSpecifiedReactionFound	88	No exception with a defined reaction was found.
InputParameterInvalid	ReactionRange	73	The reaction is outside the specified range.
UnexpectedProgramBehavior	ExceptionDelayListCorrupt	87	The ExceptionDelayList is damaged. The list must be created again.
UnexpectedProgramBehavior	InitExceptionListFailed	46	Initialization of the exception list failed.

ExceptionDelayListCorrupt

Enumeration name:	ExceptionDelayListCorrupt
Enumeration value:	87
Description:	The ExceptionDelayList is damaged. The list must be created again.

Issue	Cause	Solution
-	The exception list with delayed reactions is damaged.	Please inform the support team about this error.

ExceptionWithSpecifiedReactionFound

Enumeration name:	ExceptionWithSpecifiedReactionFound
Enumeration value:	89
Description:	Exception with a specified reaction was found

An exception with the specified reaction was found.

InitExceptionListFailed

Enumeration name:	InitExceptionListFailed
Enumeration value:	46
Description:	Initialization of the exception list failed.

Issue	Cause	Solution
-	Initialization of the exception list failed. - An internal execution error occured.	Try to initialize the exception list using the FC_InitExceptionList function. Please inform the support team about this error.

Issue

Cause

Solution

-

Initialization of the exception list failed. - An internal execution error occured.

Try to initialize the exception list using the FC_InitExceptionList function.

Please inform the support team about this error.

NoExceptionWithSpecifiedReactionFound

Enumeration name:	NoExceptionWithSpecifiedReactionFound
Enumeration value:	88
Description:	No exception with a defined reaction was found.

No exceptions with the specified reaction were found.

ReactionRange

Enumeration name:	ReactionRange
Enumeration value:	73
Description:	The reaction is outside the specified range.

Issue	Cause	Solution
-	An invalid value was transferred at the i_udiReaction input.	The following must apply: 1 <= i_udiReaction <= Gc_udiMaxNumberOfReactions