ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/pase__ilekill.htm

146 lines
3.7 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<!-- Begin Header Records -->
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- Created by V2DCIJB on 23 Nov 1999 -->
<!-- Edited by Kersten Jan 02 -->
<!-- End Header Records -->
<title>_ILEKILL()--Send ILE Signal for i5/OS PASE</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<a name="Top_Of_Page"></a>
<h2><img src="delta.gif" alt="Start of change">_ILEKILL()--Send ILE Signal for i5/OS PASE</h2>
<div class="box" style="width: 60%;"><br>
&nbsp;&nbsp;Syntax
<pre>
#include &lt;as400_protos.h&gt;
int _ILEKILL(pid_t <em>pid</em>,
int <em>signo</em>);
</pre>
<br>
&nbsp;&nbsp;Default Public Authority: *USE
<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Library: Standard C Library (libc.a)
<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No
<br>
<!-- iddvc RMBR -->
<br>
</div>
<p><strong>Note:</strong> This function can only be used in an i5/OS PASE
program. See <a href="../rzalf/rzalfintro.htm">i5/OS PASE</a> for more
information about creating i5/OS PASE programs.</p>
<p>The <strong>_ILEKILL</strong> invokes the ILE <strong>kill</strong> function
to send an ILE signal to a process or process group.</p>
<br>
<h3>Parameters</h3>
<dl>
<dt><strong>pid</strong></dt>
<dd>(Input) Specifies the identifier of a process or process group. See
documentation for the ILE <a href="sigkill.htm">kill()--Send Signal to Process
or Group of Processes</a> function for more information.</dd>
</dl>
<dl>
<dt><strong>signo</strong></dt>
<dd>(Input) Specifies the signal to send. A <em>signo</em> 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.
<p>A <em>signo</em> value less than zero is negated to determine the ILE signal
number, and <em>signo</em> zero simply checks that the target process or
process group exists.</p>
</dd>
</dl>
<br>
<h3>Authorities</h3>
<p>See documentation for the ILE <a href="sigkill.htm">kill()--Send Signal to
Process or Group of Processes</a> function for information about required
authorities.</p>
<br>
<h3>Return Value</h3>
<p><strong>_ILEKILL</strong> returns zero for normal completion, or -1 wih an
<strong>errno</strong> for any error.</p>
<br>
<h3>Error Conditions</h3>
<p>See ILE <a href="sigkill.htm">kill()--Send Signal to Process or Group of
Processes</a> for more information about error conditions.
<br>
</p>
<br>
<h3>Related Information</h3>
<ul>
<li><a href="sigkill.htm">kill()</a>--Send Signal to Process or Group of
Processes</li>
</ul>
<img src="deltaend.gif" alt="End of change">
<br>
<hr>
API introduced: V5R4
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"pase1.htm">i5/OS PASE APIs</a> | <a href="aplist.htm">APIs by category</a>
</td>
</tr>
</table>
</center>
</body>
</html>