poekill
 
 
  NAME
 
  poekill - terminates all remote tasks for a give program.
 
 
  SYNOPSIS
 
  poe poekill pgm_name [poe_options]
 
  or
 
  rsh remote_node poekill pgm_name
 
 
  poekill is a Korn shell script that searches for the existence of
  running programs (named pgm_name) owned by the user, and terminates
  them via SIGTERM signals.  If run under POE, poekill uses the standard
  POE mechanism for identifying the set of remote nodes (host.list,
  Resource Manager, etc.).  If run under rsh, poekill applies only to
  the node specified as remote_node.
 
 
  FLAGS
 
  When run as a POE program, standard POE flags apply.
 
 
  DESCRIPTION
 
  poekill determines the user ID of the user that submitted the command.
  It then uses the ID to obtain a list of active processes, which is
  filtered by the pgm_name argument into a scratch file in /tmp.  The
  file is processed by an awk script that sends a SIGTERM signal (15) to
  each process in the list, and echoes the action back to the user.  The
  scratch file is then erased, and the script exits with code of 0.
 
  If you do not provide a pgm_name, an error message is printed and the
  script exits with a code of 0.
 
  The pgm_name can be a substring of the program name.
 
 
  RELATED INFORMATION
 
  Commands:  rsh(1), poe(1), kill(1)