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

76 lines
6.2 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="Completion with exceptions of errors by the server" />
<meta name="abstract" content="The server assigns several rather specific major return codes such as 02, 03, 0309, and so on to conditions for which a specific response from the application program is appropriate." />
<meta name="description" content="The server assigns several rather specific major return codes such as 02, 03, 0309, and so on to conditions for which a specific response from the application program is appropriate." />
<meta name="DC.subject" content="return code, description, major 02, completion message, with exceptions, major return codes, command, CL, ENDJOB (End Job), End Job (ENDJOB) command, job, ending command, ENDJOB (End Job) command, ENDJOB (End Job), End Job (ENDJOB), major 03, ending, major 08 and 11, major 04, message, completion with exceptions" />
<meta name="keywords" content="return code, description, major 02, completion message, with exceptions, major return codes, command, CL, ENDJOB (End Job), End Job (ENDJOB) command, job, ending command, ENDJOB (End Job) command, ENDJOB (End Job), End Job (ENDJOB), major 03, ending, major 08 and 11, major 04, message, completion with exceptions" />
<meta name="DC.Relation" scheme="URI" content="rbal3recoveryerr.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3comex" />
<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>Completion with exceptions of errors by the server</title>
</head>
<body id="rbal3comex"><a name="rbal3comex"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Completion with exceptions of errors by the server</h1>
<div><p>The server assigns several rather specific major return codes such
as 02, 03, 0309, and so on to conditions for which a specific
response from the application program is appropriate.</p>
<p>A major return code of 02 indicates that the requested input operation
completed successfully, but the server is ending the job in a controlled. The application program should complete its processing as quickly as possible. The controlled cancel is intended to allow programs time to end in an orderly
manner. If your program does not end within the time specified on the <a href="../cl/endjob.htm">ENDJOB</a> command,
the server will end the job without further notice.</p>
<p>A major return code of 03 indicates that an input operation completed successfully
without transferring any data. For some applications, this might be an error
condition, or it might be expected when the user presses a function key instead
of entering data. It might also indicate that all the data has been processed,
and the application program should proceed with its completion processing. In any case, the contents of the input buffer in the program should be ignored.</p>
<p>A major and minor code of 0309 indicates that the server received no data <em>and</em> is
ending the job in a controlled manner. A major and minor code of 0310 indicates
that there is no data because the specified wait time has ended. Other minor
return codes accompanying the 02 or 03 major code are the same as for a 00
major code, indicating communications status and the operation to be performed
next.</p>
<p>A major return code of 04 indicates that an output exception occurred. Specifically, your program attempted to send data when data should have been
received. This is probably the result of not handling the minor return code
properly on the previous successful completion. Your program can recover
by just receiving the incoming data and then repeating the write operation.</p>
<p>A major return code of 34 indicates that an input exception occurred. The
received data was either too long or incompatible with the record format. The minor return code indicates what was wrong with the received data, and
whether the data was truncated or rejected. Your program can probably handle
the exception and continue. If the data was rejected, you might be able to
read it by specifying a different record format.</p>
<p>Two other return codes in this group, 0800 and 1100, are both typically
the result of application programming errors, but are still recoverable. 0800
indicates that an acquire operation failed because the device has already
been acquired or the session has already been established. 1100 indicates
that the program attempted to read from invited devices with no devices invited. In both cases, the program ignored the request that is not valid, and the
program can continue.</p>
<p>No message is issued with a 02 major code or most minor codes with the
03 major code, but the other exceptions in this group are typically accompanied
by a message in the CPF4701-CPF47FF or CPF5001-CPF50FF range.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3recoveryerr.htm" title="This section describes the errors you might receive and the actions you should take to recover from those errors.">Recover from file server errors</a></div>
</div>
</div>
</body>
</html>