kill(1)               MPE/iX Shell and Utilities               kill(1)
  ______________________________________________________________________

  NAME
       kill -- terminate process

  SYNOPSIS
       kill -l [exit_status]
       kill [-s signal_name] [pid...] [job-identifier...]
       kill [-signal_name] [pid...] [job-identifier...]
       kill [-signal_number] [pid...] [job-identifier...]

  DESCRIPTION
       kill terminates a process by sending it a signal.  The default
       signal is SIGTERM.

  Options
       kill accepts the following options:

       -l   displays the names of all supported signals.  If you specify
            exit_status, and it is the exit code of a terminated pro-
            cess, kill displays the terminating signal of that process.

       -s signal_name
            sends the signal signal_name to the process instead of the
            SIGTERM signal.

       -signal_name
            is an obsolete equivalent of-s signal_name.

       -signal_number
            is an obsolete method of specifying a positive integer which
            represents the signal to be used (instead of SIGTERM) as the
            sig argument in the effective call to kill. The relationship
            between signal_number and the portable signal_name is shown
            in Table 1, Integer Values of Signals.

                            ____________________________
                            |signal_number  signal_name |
                            |___________________________|
                            |       0       0           |
                            |       1       SIGHUP      |
                            |       2       SIGINT      |
                            |       3       SIGQUIT     |
                            |       6       SIGABRT     |
                            |       9       SIGKILL     |
                            |      14       SIGALRM     |
                            |      15       SIGTERM     |
                            |___________________________|

                         Table 1: Integer Values of Signals

                                                                       1

  kill(1)               MPE/iX Shell and Utilities               kill(1)
  ______________________________________________________________________

  Operands
       kill accepts the following operands:

       job-identifier
            is the job identifier reported by the shell when a process
            is started with &.  It is one way to identify a process. It
            is also reported by the jobs command.

       pid  is the process ID that the shell reports when a process is
            started with &.  You can also find it using the ps command.

       The killed process must belong to the current user, unless he or
       she is the system administrator

  DIAGNOSTICS
       Possible exit status values are:

       0  Successful completion.

       1  Failure due to one of the following:
            -- job or process did not exist -- error in command line
            syntax

       2  Failure due to one of the following:
            -- invalid command line argument -- invalid signal.

  Messages

       Message:  "job-identifier" is not a job
       Cause:    You specified a job-identifier that is not valid.
       Action:   Specify a valid job-identifier.

       Message:  pid: system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

       Message:  "signal" is not a valid signal
       Cause:    You specified a non-integer signal for kill that was
                 not a valid signal name, or you specified a signal that
                 is outside the range of valid signal numbers.
       Action:   Make sure that you specify a valid signal number or
                 name for signal.

  PORTABILITY
       POSIX.2.  x/OPEN Portability Guide 4.0.

  MPE/iX NOTES
       For information on how the current MPE/iX implementation may
       affect the operation of this utility, see Appendix A, MPE/iX
       Implementation Considerations.

                                                                       2

  kill(1)               MPE/iX Shell and Utilities               kill(1)
  ______________________________________________________________________

  SEE ALSO
       jobs(1), ps(1), sh(1)

                                                                       3