Receiver Last Error

Issue/error types

An issue/error may be related to the channel itself and so affect all active receivers under it, or be related to an individual receiver and affect only that receiver.

If the issue/error is channel related, the issue/error is assigned to all active receivers under the channel and the Last Error Type on each receiver is set to “Channel."

If the issue/error is related to a specific individual receiver, the issue/error is assigned only to that receiver and the Last Error Type on the receiver is set to “Receiver."

Whether or not a “Channel” issue/error will override a previously assigned “Receiver” issue/error depends on the nature of the channel issue and circumstances. Channel level issues encountered during processing that do not warrant automatic deactivation of receivers will be assigned to all active receivers for the channel except those that currently have a “Receiver” level issue and are in an “Active With Issue” status. An example of when the override would occur would be cases where the channel issue is such that the receivers are being automatically deactivated, such as when a JMS channel connection is lost, or a FileSystemManager instance cannot be acquired for a File.

Receiver status

Assignment of “Active With Issue” or “Failed” status

If a channel receiver encounters issues while it is active, it may, depending upon the nature of the issue, go into an "Active With Issue" or a “Failed” status.

If the nature of the issue is such that it may “self correct” or be remedied by manual intervention without need for receiver deactivation, the receiver will go into an "Active With Issue" status. Receivers in this state remain active and will continue to attempt normal processing. If normal processing is reestablished, their status will be reset to “Active”. (This is described in the next section, See “Active With Issue” status resets:

If the nature of the issue is such that it is improbable that normal processing can be reestablished without intervention and receiver deactivation, the receiver will go into a "Failed" status and deactivate. Both “Channel” and “Receiver” type issues may cause receivers to automatically deactivate and go into “Failed” status. If the issue was a channel issue, the issue is assigned as a “Channel” type to all active receivers under the channel overriding any pre-existing receiver type error information for receivers currently in an “Active With Issue” status with a “Receiver” type issue/error. If the cause was a receiver related issue, the issue is assigned as a “Receiver” type issue/error to the single receiver only.

Resets of "Active with Issue" status to "Active"

Active receivers with “Active With Issue” status are reset to “Active” status as they continue to attempt normal processing.

When processing begins for a channel, all its receivers that have an "Active With Issue" status with a “Channel” type issue are reset to “Active” status. Those with “Receiver” type issues are not reset at this point.

Receivers in "Active With Issue" status with a “Receiver” type issue are reset to “Active” status when processing begins for that specific receiver.

If the original issue does not recur (and no new issue is encountered), the receiver status will remain “Active.” Otherwise, issue assignment will occur as described elsewhere and the status set accordingly.

Indication of channel/receiver issues in the user interface

Indication of channel/receiver issues in User Interface If any receiver for an active channel is in “Active With Issue” status, the “Is Active” value in the channel list will be decorated with a warning icon and the text will be red. Rest on the “Is Active” value to indicate “Monitoring issues exist”.

If a receiver is in “Active With Issue” or “Failed” status, its status in the receiver list will be decorated with a warning icon and text will be red. Rest on the status to display the first part of the related error information details. The details of the error information can be accessed via the Receiver form.