_ILEKILL()--Send ILE Signal for IBM PASE for i

Syntax

 #include <as400_protos.h>

 int _ILEKILL(pid_t pid,
              int   signo);

  Default Public Authority: *USE

  Library: Standard C Library (libc.a)

  Threadsafe: No

Note: This function can only be used in an IBM^® i PASE program. See the IBM PASE for i topic collection for more information about creating IBM PASE for i programs.

The _ILEKILL invokes the ILE kill function to send an ILE signal to a process or process group.

Parameters

pid: (Input) Specifies the identifier of a process or process group. See documentation for the ILE kill()--Send Signal to Process or Group of Processes function for more information.

signo: (Input) Specifies the signal to send. A signo value greater than zero is interpreted as an AIX^® signal number that the system converts to an equalent ILE signal number. For example, the AIX signal number for SIGTERM (15) is converted to the ILE signal number for SIGTERM (6). AIX signals that have no ILE equivalent return an error.
A signo value less than zero is negated to determine the ILE signal number, and signo zero simply checks that the target process or process group exists.

Authorities

See documentation for the ILE kill()--Send Signal to Process or Group of Processes function for information about required authorities.

Return Value

_ILEKILL returns zero for normal completion, or -1 wih an errno for any error.

Error Conditions

See ILE kill()--Send Signal to Process or Group of Processes for more information about error conditions.

Related Information

kill()--Send Signal to Process or Group of Processes

API introduced: V5R4

[ Back to top | IBM PASE for i APIs | APIs by category ]