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

127 lines
3.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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">
<title>_CVTERRNO()--Convert ILE errno to i5/OS PASE errno</title>
<!-- 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 -->
<!--File Edited April 2001 -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<!-- Java sync-link -->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<a name="Top_Of_Page"></a>
<h2>_CVTERRNO()--Convert ILE errno to i5/OS PASE errno</h2>
<div class="box" style="width: 60%;">
<br>
&nbsp;&nbsp;Syntax
<pre>
#include &lt;as400_protos.h&gt;
int _CVTERRNO(int <em>errno_ile</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: Yes<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.</p>
<p>The <strong>_CVTERRNO()</strong> function converts an ILE errno value to a
corresponding i5/OS PASE errno value.</p>
<br>
<h3>Parameters</h3>
<dl>
<dt><strong>errno_ile</strong></dt>
<dd>(Input) Specifies the ILE errno value to convert to a corresponding i5/OS
PASE errno value. ILE and i5/OS PASE errno values correspond if they have the
same name (for example, EFAULT) in a system-provided header file.</dd>
</dl>
<br>
<h3>Authorities</h3>
<p><strong>_CVTERRNO</strong> requires no authority.</p>
<br>
<h3>Return Value</h3>
<p><strong>_CVTERRNO</strong> returns the i5/OS PASE equivalent of the input
ILE errno value. If the input has no i5/OS PASE errno equivalent (for example,
EAPAR is an ILE errno value with no i5/OS PASE equivalent), the input is
returned unchanged.</p>
<br>
<h3>Usage Notes</h3>
<ol>
<li>The errno value set by an ILE runtime function must be determined by code
running in the same thread and activation group that called the runtime
function because ILE runtime sometimes maintains a separate errno variable for
each activation group.<br>
<br>
</li>
</ol>
<br>
<h3>Related Information</h3>
<ul>
<li><a href="qp2runpase.htm">Qp2RunPase()</a>--Run an i5/OS PASE Program</li>
</ul>
<br>
<hr>
API introduced: V5R1
<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>