98 lines
3.9 KiB
HTML
98 lines
3.9 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">
|
||
|
|
<title>i5/OS Messages and the ILE CEE API Feedback Code</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 -->
|
||
|
|
<!-- ILE1A SCRIPT A converted by B2H R4.1 (346) (CMS) by NLJONES at -->
|
||
|
|
<!-- RCHVMX on 25 Feb 1999 at 10:33:07 -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>i5/OS Messages and the ILE CEE API Feedback Code</h2>
|
||
|
|
|
||
|
|
<p>As input to an ILE CEE API, you have the option of coding a feedback code,
|
||
|
|
and using the feedback code as a return (or feedback) code check in a
|
||
|
|
procedure. The feedback code is a condition token value that is provided for
|
||
|
|
flexibility in checking returns from calls to other procedures. You can then
|
||
|
|
use the feedback code as input to a condition token. For information on the
|
||
|
|
condition tokens, see Condition Management APIs. For more information on
|
||
|
|
condition handling, see <strong>Condition Handling</strong> in the
|
||
|
|
<a href="../books/sc415606.pdf" target="_blank">ILE
|
||
|
|
Concepts</a><img src="wbpdf.gif" alt="Link to PDF">book.</p>
|
||
|
|
|
||
|
|
<p>If you code the feedback code parameter in your application to receive
|
||
|
|
feedback information from an ILE CEE API, the following sequence of events
|
||
|
|
occurs when a condition is raised:</p>
|
||
|
|
|
||
|
|
<ol>
|
||
|
|
<li>An informational message is sent to the caller of the API, communicating
|
||
|
|
the message associated with the condition.</li>
|
||
|
|
|
||
|
|
<li>The ILE CEE API in which the condition occurred builds a condition token
|
||
|
|
for the condition. The ILE CEE API places information into the instance
|
||
|
|
specific information area. The instance specific information of the condition
|
||
|
|
token is the message reference key of the informational message. This is used
|
||
|
|
by the system to react to the condition.</li>
|
||
|
|
|
||
|
|
<li>If a detected condition is critical (severity is 4), the system sends an
|
||
|
|
exception message to the caller of the ILE CEE API.</li>
|
||
|
|
|
||
|
|
<li>If a detected condition is not critical (severity less than 4), the
|
||
|
|
condition token is returned to the routine that called the ILE CEE API.</li>
|
||
|
|
|
||
|
|
<li>When the condition token is returned to your application, you have the
|
||
|
|
following options:
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Ignore it and continue processing.</li>
|
||
|
|
|
||
|
|
<li>Signal the condition using the Signal a Condition (CEESGL) bindable
|
||
|
|
API.</li>
|
||
|
|
|
||
|
|
<li>Get, format, and dispatch the message for display using the Get, Format,
|
||
|
|
and Dispatch a Message (CEEMSG) bindable API.</li>
|
||
|
|
|
||
|
|
<li>Store the message in a storage area using the Get a Message (CEEMGET)
|
||
|
|
bindable API.</li>
|
||
|
|
|
||
|
|
<li>Use the Dispatch a Message (CEEMOUT) bindable API to dispatch a
|
||
|
|
user-defined message to a destination that you specify.</li>
|
||
|
|
|
||
|
|
<li>When the caller of the API regains control, the informational message is
|
||
|
|
removed and does not appear in the job log.</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
|
||
|
|
<p>If you omit the feedback code parameter when you are calling an ILE CEE API,
|
||
|
|
the ILE CEE API sends an exception message to the caller of the bindable
|
||
|
|
API.</p>
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<table align="center" cellspacing="2" cellpadding="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td align="center" valign="top">
|
||
|
|
<a href="#Top_Of_Page">Top</a> |
|
||
|
|
<a href="ile1a1.htm">ILE CEE APIs</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|