NTAdmin_RunDos Knowledge Script Exec Command Failed. Error: 'Failed because Exit value = -1' (NETIQKB42258)

  • 7742258
  • 02-Feb-2007
  • 12-Nov-2010

Environment

NetIQ AppManager 6.x
NetIQ AppManager 7.0.x

Situation

NTAdmin_RunDos Knowledge Script Exec Command Failed. Error: 'Failed because Exit value = -1'
NTAdmin_RunDos Knowledge Script occasionally raise an Event with an Exit Value of '-1'.

Resolution

If the job raises an event on an iteration reporting an Exit Value of '-1' as the cause, it means that the executable that the Knowledge Script (KS) is being told to run was successfully started by the KS, but:

  1. The executable itself has terminated without completing.
  2. The executable has experienced an error that it was not programmed to account for or deal with.

In either case, the KS was successful in starting the executable, but the executable itself failed for some reason.  This is not an AppManager issue.  This is an OS/Network issue, or an issue with the code in the executable itself.

Cause

An Exit Value of '-1' indicates that the executable itself failed or terminated prematurely.  The Knowledge Script will generate an Event on any specific iteration of the KS if it is sent an exit value of '-1' by the Operating System.  The KS will then terminate that failed iteration, but it will continue to run, and will attempt to run the executable again at the next scheduled iteration.

Additional Information

Formerly known as NETIQKB42258

If the KS itself were failing to actually start the executable it is being told to run, the Event that it would generate would indicate one of the following:

  1. The attempt by the KS to start the executable timed out with an event message containing: "<executablename> Timeouts w/retcode= <errcode>" indicating that the AppManager Client had a lack of permissions needed to start the executable.
  2. The KS was unable to find the executable resulting in an event message containing: "<executablename> not found" indicating that the file wasn't where the KS was being told to go.