CHECK FILE Precondition receives function 'lstat', error code 2

Document ID : KB000088201
Last Modified Date : 14/04/2018
Show Technical Document Details
Issue:
Error Message :
U02000102 Error when calling the function 'lstat', error code '2(No such file or directory)'.
U00020411 The command 'EXIT' in 'XC_INC.CONDITION.CHECK_FILE', line '00086' stopped the generation of this task.

When executing a CHECK FILE Precondition, an error similar to the one above is displayed and the task hangs in a Waiting for Preconditions status.

This is only an issue on Unix Agents.

Investigation

The Precondition CHECK FILE checks for the existence of a file on a Linux Agent. If the file is present, the job runs as expected. However, if the file is not found, the task hangs in a "Waiting for Preconditions" status while doing the check for the existance of the file over and over again.

In the report, messages similar to these will reoccurr approximately every 20 seconds:
2016-02-02 09:35:08 - IF file 'pathtofile/file.txt' does not exist (check via SERVER).
2016-02-02 09:35:08 - U02000102 Error when calling the function 'lstat', error code '2(No such file or directory)'.
2016-02-02 09:35:08 - U00020411 The command 'EXIT' in 'XC_INC.CONDITION.CHECK_FILE', line '00086' stopped the generation of this task.
Environment:
OS: Unix
OS Version: N/A
Cause:
Cause type:
Defect
Root Cause: Wrong messages are sent between the Unix Agent and the Automation Engine which causes an error when the file to be checked in a CHECK FILE on a Precondition does not exist.
Resolution:
Update to a fix version listed below or a newer version if available.

Fix Status: Released

Fix Version(s):
Component(s): Agent Unix

Automation Engine 12.0.0 – Available
Automation Engine 11.2.2 – Available
Automation Engine 11.1.3 – Available
Additional Information:
Workaround :
Make sure that CHECK FILE finds at least one file.