
.. _zombie_fail_cli:

zombie_fail
///////////

::

   
   zombie_fail
   -----------
   
   Locates the task in the servers list of zombies, and sets to fail.
   Next time a child command (init,event,meter,label,abort,complete) which matches zombie, communicates with the server, will be set to fail.
   Depending on the job setup this may force a abort, the abort will also fail.
   Hence job structure should use 'set -e' in the error trapping functions to prevent
   infinite recursion.
   The references to the zombie in the server is automatically deleted after 1 hour
     args = list of task paths, at least one expected
     --zombie_fail=/path/to/task  /path/to/task2
   
   The client reads in the following environment variables. These are read by user and child command
   
   |----------|----------|------------|-------------------------------------------------------------------|
   | Name     |  Type    | Required   | Description                                                       |
   |----------|----------|------------|-------------------------------------------------------------------|
   | ECF_HOST | <string> | Mandatory* | The host name of the main server. defaults to 'localhost'         |
   | ECF_PORT |  <int>   | Mandatory* | The TCP/IP port to call on the server. Must be unique to a server |
   | ECF_SSL  |  <any>   | Optional*  | Enable encrypted comms with SSL enabled server.                   |
   |----------|----------|------------|-------------------------------------------------------------------|
   
   * The host and port must be specified in order for the client to communicate with the server, this can 
     be done by setting ECF_HOST, ECF_PORT or by specifying --host=<host> --port=<int> on the command line
   
