Scheduled Column in KIC Message Connector Monitor

Last updated
Save as PDF

Article # 3041735 - Page views: 61

Issue

In the KIC Message Connector Monitor, what does the Scheduled column value represent, and is there any method for adjusting the value?

Solution

The time shown in the Scheduled column of the Inbound Status - Active view in the Kofax Import Connector Message Connector Monitor for received messages in storage is described with tool-tips such as next retry if current transfer times out, time of transfer, time of transfer failure, or transfer confirmation time, depending on the state of the message.

The next retry if current transfer times out description is appropriate for the typical time shown (about one hour ahead of current time).

When KIC encounters certain errors, it will attempt to re-try the processing of a message to see if the error condition has been resolved. For these errors, KIC will attempt ten (10) retries of the message. There is a set delay between each retry. The delay depends on the break code of the error.

The default delays are:

0 minutes (no delay) for BreakCode='1'
1 minute for BreakCode='2'
4 minutes for BreakCode='3'
9 minutes for BreakCode='4'
1 hour for BreakCode='5'

As can be seen in the information above, for a break code 5, there is a 1 hour delay. This can lead to a 10 hour delay before the message is seen as an error.

An example of an error that can fall into the retry condition is:
Failed to retrieve message content from server.

This retry behavior can be changed in the Create_Config.xslt file under C:\Program Files (x86)\Kofax\KIC-ED\Message Connector\xcd.

Before editing this file, make a backup copy.

The delay for each break code is configured within the <xsl:choose> element:

<xsl:choose>
    <xsl:when test="BreakCode='1'">
        <xsl:value-of select="tsl:time()"/>
    </xsl:when>
    <xsl:when test="BreakCode='2'">
        <xsl:value-of select="tsl:time(,60)"/>
    </xsl:when>
    <xsl:when test="BreakCode='3'">
        <xsl:value-of select="tsl:time(,240)"/>
    </xsl:when>
    <xsl:when test="BreakCode='4'">
        <xsl:value-of select="tsl:time(,900)"/>
    </xsl:when>
    <xsl:otherwise>
        <xsl:value-of select="tsl:time(,3600)"/>
    </xsl:otherwise>
</xsl:choose>

The time values are in seconds. To change the delay for a specific break code, simply replace the tsl:time value with the desired number of seconds.

The total number of retries for all break codes can be configured in the following section of the Create_Config.xslt file:

<xsl:when test="substring($tries,10,1)!=''">
    <!-- reached retry limit: neg. terminated -->
    <State>400</State>
    <xsl:copy-of select="$starttime"/>
    <xs:if test="not(General/KeepFailedInbound='1')">
        <Delete/>
    </xs:if>
</xsl:when>

The number of retries is configured here: ($tries,10,...

This is the default, which results in 10 retries. To change it to a specific number, replace 10 with the number of retries desired. For example, to configure 5 retries, change to ($tries,5,...

Level of Complexity

Moderate

Applies to

Product	Version	Build	Environment	Hardware
KIC	2.7; 2.8; 2.9; 2.10	N/A	N/A	N/A

References

Article # 3041735