FC_CopyExceptionDelayList - General Information

Overview

Type:

Function

Available as of:

V1.0.4.0

Task

A copy of the exception list with delayed reactions is created to display it in an HMI or to perform own evaluations.

Description

The function copies the ExceptionDelayList. It creates an array from the internal display of the ExceptionDelayList (linked list). The list is only copied when it has changed. Communication in the exception list is achieved here using the functions that manipulate the list via the xExceptionDelayListHasChanged variable. As a result, the entries for the time remaining until the exceptions become active (todElapsedTime) are not updated. If these time stamps are relevant to the user, copying must always be forced by setting the i_xForceCopy input to TRUE.

Interface

Input

Data type

Description

i_xCopy

BOOL

Copying of the data when the list has changed.

i_xForceCopy

BOOL

Forces copying of the data even if the list has not changed.

To this end, i_xCopy must also be set to TRUE.

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_stExceptionList

ST_ExceptionList

Exception list from which the list of exceptions with delayed reactions shall be copied.

iq_astException

ARRAY[1..Gc_udiMaxNumberOfDelay] OF ST_Exception

Array into which the list shall be copied to.

iq_udiNumberOfExceptions

UDINT

Number of exceptions that were entered into the array.

Diagnostic Messages

q_etDiag

q_etDiagExt

Enumeration value

Description

OK

ExceptionDelayListCopied

85

The ExceptionDelayList has been copied

OK

ExceptionDelayListNoChange

86

There are no changes in exception delay list

OK

WaitForCopy

50

Waiting for copy job

UnexpectedProgramBehavior

ExceptionDelayListCorrupt

87

The ExceptionDelayList is damaged. The list must be created again.

UnexpectedProgramBehavior

InitExceptionListFailed

46

Initialization of the exception list failed.

ExceptionDelayListCopied

Enumeration name:

ExceptionDelayListCopied

Enumeration value:

85

Description:

The ExceptionDelayList has been copied

The exception list with delayed reactions has been copied.

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.

ExceptionDelayListNoChange

Enumeration name:

ExceptionDelayListNoChange

Enumeration value:

86

Description:

There are no changes in exception delay list

The list of exceptions with delayed reactions has not changed since the last copying.

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.

WaitForCopy

Enumeration name:

WaitForCopy

Enumeration value:

50

Description:

Waiting for copy job

The function waits for i_xCopy = TRUE before it copies the list of exceptions with delayed reactions.