89 lines
6.8 KiB
HTML
89 lines
6.8 KiB
HTML
|
<?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="File error detection and handling by the server" />
|
||
|
|
<meta name="abstract" content="The server can detect errors when a file is opened, when a program device is acquired or released, during I/O operations to a file, and when the file is closed. When appropriate, the server will automatically try to run a failing operation again, up to a try again limit. When a try again is successful, neither operator nor program action is required." />
|
||
|
|
<meta name="description" content="The server can detect errors when a file is opened, when a program device is acquired or released, during I/O operations to a file, and when the file is closed. When appropriate, the server will automatically try to run a failing operation again, up to a try again limit. When a try again is successful, neither operator nor program action is required." />
|
||
|
|
<meta name="DC.subject" content="error recovery, handling, handling application program error, application program, error handling, error, message, file status code, code, file status, major/minor return code, server error log, alert message, alert, permanent errors, job, log error messages, error message" />
|
||
|
|
<meta name="keywords" content="error recovery, handling, handling application program error, application program, error handling, error, message, file status code, code, file status, major/minor return code, server error log, alert message, alert, permanent errors, job, log error messages, error message" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbal3ts.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../rbam6/rbam6clmain.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../rzal2/rzal2kickoff.htm" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rbal3eh" />
|
||
|
|
<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>File error detection and handling by the server</title>
|
||
|
|
</head>
|
||
|
|
<body id="rbal3eh"><a name="rbal3eh"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">File error detection and handling by the server</h1>
|
||
|
|
<div><p>The server can detect errors when a file is opened, when a program
|
||
|
|
device is acquired or released, during I/O operations to a file, and when
|
||
|
|
the file is closed. When appropriate, the server will automatically try to
|
||
|
|
run a failing operation again, up to a try again limit. When a try again
|
||
|
|
is successful, neither operator nor program action is required.</p>
|
||
|
|
<div class="section"><h4 class="sectiontitle">How the server reports errors</h4><div class="p">The
|
||
|
|
server reports errors that can affect the processing of the program in any
|
||
|
|
or all of the following ways: <ul><li>A notify, status, diagnostic, or escape message might be sent to the program
|
||
|
|
message queue of the program using the file. These messages might also appear
|
||
|
|
in the job log, depending on the message logging level that is set for the
|
||
|
|
job. See <a href="rbal3mmm.htm#rbal3mmm">Messages and message monitors in files by the server</a> for more information.</li>
|
||
|
|
<li>The high-level language might return a file status code.</li>
|
||
|
|
<li>A major and minor return code is returned in the I/O feedback area for
|
||
|
|
intersystem communications function (ICF), display, and printer files. See <a href="rbal3majminrcs.htm#rbal3majminrcs">Major and minor return codes in files by the server</a> for more information.</li>
|
||
|
|
<li>A notify, status, diagnostic, or escape message might be sent to the operator
|
||
|
|
message queue (QSYSOPR) or the history message queue (QHST).</li>
|
||
|
|
<li>Information regarding the error might be saved in the server error log for
|
||
|
|
use by the problem analysis and resolution programs.</li>
|
||
|
|
<li>An alert message might be sent to an operator at another server in the network.</li>
|
||
|
|
<li>The normal program flow might be interrupted and control might be transferred
|
||
|
|
to an error-handling subroutine, or other language operations might occur. For
|
||
|
|
additional information about how to handle run-time errors, see the appropriate
|
||
|
|
book for the high-level language.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>Only some of these are significant to a program that is attempting
|
||
|
|
error recovery.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Actions to take when you receive an error</h4><p>See <a href="rbal3recoveryerr.htm#rbal3recoveryerr">Recover from file server errors</a> for information about
|
||
|
|
the actions you should take when you receive an error.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Unrecoverable errors</h4><p>Not all file errors allow programmed
|
||
|
|
error recovery. Some errors are permanent; that is, the file, device, or
|
||
|
|
program cannot work until you take some corrective action. This might involve
|
||
|
|
resetting the device by varying it off and on again, or correcting an error
|
||
|
|
in the device configuration or the application program. Some messages and
|
||
|
|
return codes inform the user or the application program of conditions that
|
||
|
|
are information rather than errors, such as change in the status of a communications
|
||
|
|
line, or server action taken for an unexpected condition. In many cases,
|
||
|
|
it is possible for the application program to test for an error condition
|
||
|
|
and take some preplanned recovery action which allows the program to continue
|
||
|
|
without intervention from the operator.</p>
|
||
|
|
</div>
|
||
|
|
</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="../rbam6/rbam6clmain.htm">Control language (CL)</a></div>
|
||
|
|
<div><a href="../rzal2/rzal2kickoff.htm">Basic system operations</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|