poekill

NAME

poekill - terminates all remote tasks for a given 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, LoadLeveler, and so
on). 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 1.

The pgm_name can be a substring of the program name.

RELATED INFORMATION

Commands: rsh(1), poe(1), kill(1)