Handling failed commands

At runtime, commands may be executed on files that are published to a file share. If such a command does not finish successfully, the file is copied to a failures subfolder of the file share. In the configuration console, you can retry the command on the failed items.

To perform a retry:

  1. In the configuration console, open the connection node and select the file share.
    The number of failures is listed in the Failures section. If there are any failures, the Retry button is enabled.
  2. Click Retry to retry the command on all failed items.
    When processing more than one item, you can click Cancel to interrupt the retry process. In that case the command for the current item continues, but the remainder of the items is not processed.
    After all items have been processed, a message box is displayed, showing how many items succeeded, and how many items failed.
  3. Click OK to close the message box.
If a retry is successful, the corresponding file is removed from the failures subfolder of the file share. If Delete file after executing command is selected, the original file on the file share is also removed.

If a retry failed, the corresponding file remains in the failures subfolder. In this case, you should try and find the cause for the failure, fix the problem, and try again.