ibm-information-center/dist/eclipse/plugins/i5OS.ic.dm_5.4.0.1/rbal3majminrcs.htm

155 lines
10 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Major and minor return codes in files by the server" />
<meta name="abstract" content="Major and minor return codes report errors and certain status information for ICF, display, and printer files. They are not used for other files. They typically appear as four characters: the first two refer to the major code and the second two refer to the minor code." />
<meta name="description" content="Major and minor return codes report errors and certain status information for ICF, display, and printer files. They are not used for other files. They typically appear as four characters: the first two refer to the major code and the second two refer to the minor code." />
<meta name="DC.subject" content="return code, definition, use" />
<meta name="keywords" content="return code, definition, use" />
<meta name="DC.Relation" scheme="URI" content="rbal3ts.htm" />
<meta name="DC.Relation" scheme="URI" content="../books/sc415715.pdf" />
<meta name="DC.Relation" scheme="URI" content="../rzahg/rzahgprint.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3majminrcs" />
<meta name="DC.Language" content="en-us" />
<!-- 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. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Major and minor return codes in files by the server</title>
</head>
<body id="rbal3majminrcs"><a name="rbal3majminrcs"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Major and minor return codes in files by the server</h1>
<div><p>Major and minor return codes report errors and certain status information
for ICF, display, and printer files. They are not used for other files. They
typically appear as four characters: the first two refer to the major code
and the second two refer to the minor code.</p>
<p>The major code indicates the general type of error, and the minor provides
further detail. Minor codes, except zero, have the same or a similar meaning,
regardless of the major code with which they are combined.</p>
<p>The application program can test the return code after each I/O operation.
If the major return code is 00, the operation completed successfully and the
minor return code contains status information that indicates whether a read
or a write operation should be performed next. A major return code of 04 or
higher indicates that an error occurred. The program can test for any specific
errors for which it will attempt programmed recovery. The application program
can test for a specific condition by comparing the major and minor codes as
a unit, or can identify a class of conditions by testing the major code alone.</p>
<p>Most major and minor return codes are accompanied by any one of several
message numbers, for which the typical recovery action is similar. The individual
languages file status codes; they can set based on the major and minor return
codes.</p>
<p><a href="#rbal3majminrcs__rbal3majrcd">Table 1</a> defines the major return
codes. See the <a href="../books/sc415715.pdf" target="_blank">Application
Display Programming</a> <img src="wbpdf.gif" alt="Link&#xA;to PDF" /> book for specific definitions of the major and minor
return codes as they are used for display files and the message numbers associated
with each. Similar specific definitions for printer files and each of the
communications types valid on an ICF file can be found in the <a href="../rzahg/rzahgprint.htm">Printing</a> topic and the
books for each communications type.</p>
<table cellpadding="4" cellspacing="0" border="1" class="tableborder"><tr><td>
<a name="rbal3majminrcs__rbal3majrcd"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rbal3majminrcs__rbal3majrcd" width="100%" border="0"><caption>Table 1. Major return code definitions. The major return codes and their definitions are outlined.</caption><thead align="left"><tr><th align="left" valign="bottom" width="34.074074074074076%" id="d0e48">Code</th>
<th align="left" valign="bottom" width="65.92592592592592%" id="d0e50">Definition</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">00</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">The operation requested by your program completed
successfully. The minor includes state information, such as change direction.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">02</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">Input operation completed successfully, but
job is being ended (controlled). The minor includes state information.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">03</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">Successful input operation, but no data was
received. The minor includes state information.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">04</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">Error occurred because an output operation
was attempted while data was waiting to be read.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">08</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">An acquire operation failed because the device
has already been acquired or the session has already been established.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">11</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">A read-from-invited-program-devices operation
failed because no device or session was invited.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">34</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">An input exception occurred. The data length
or record format was not acceptable for the program.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">80</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">A permanent (unrecoverable) server or file
error occurred. Programmer action is required to correct the problem.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">81</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">A permanent (unrecoverable) device or session
error occurred during an I/O operation.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">82</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">A device or session error occurred during
an open or acquire operation. Recovery might be possible.</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 "> </td>
<td valign="top" width="65.92592592592592%" headers="d0e50 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="34.074074074074076%" headers="d0e48 ">83</td>
<td align="left" valign="top" width="65.92592592592592%" headers="d0e50 ">A device or session error occurred during
an I/O operation. Recovery might be possible.</td>
</tr>
</tbody>
</table>
</td></tr></table>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3ts.htm" title="iSeries provides server reports and error messages when errors occur. You can take corresponding actions according to the errors.">Troubleshoot database file management</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../books/sc415715.pdf" target="_blank">Application Display Programming PDF</a></div>
<div><a href="../rzahg/rzahgprint.htm">Printing</a></div>
</div>
</div>
</body>
</html>