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

106 lines
8.5 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="Monitor file status with the open and I/O feedback area" />
<meta name="abstract" content="The server monitors the status of a file in feedback areas once it has successfully opened the file. As the server performs operations on a file, it updates the feedback areas to reflect the latest status. These feedback areas give you greater control over applications and provide important information when errors occur." />
<meta name="description" content="The server monitors the status of a file in feedback areas once it has successfully opened the file. As the server performs operations on a file, it updates the feedback areas to reflect the latest status. These feedback areas give you greater control over applications and provide important information when errors occur." />
<meta name="DC.subject" content="file, shared feedback areas, sharing file, feedback areas, open feedback area, description, feedback area, open, general description, input/output, feedback area, I/O, common, file-dependent" />
<meta name="keywords" content="file, shared feedback areas, sharing file, feedback areas, open feedback area, description, feedback area, open, general description, input/output, feedback area, I/O, common, file-dependent" />
<meta name="DC.Relation" scheme="URI" content="rbal3open.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal3share.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal3feedb.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal3fedbk.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal3ddiof.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal3pddio.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3openiofba" />
<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>Monitor file status with the open and I/O feedback area</title>
</head>
<body id="rbal3openiofba"><a name="rbal3openiofba"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Monitor file status with the open and I/O feedback area</h1>
<div><p>The server monitors the status of a file in feedback areas once
it has successfully opened the file. As the server performs operations on
a file, it updates the feedback areas to reflect the latest status. These
feedback areas give you greater control over applications and provide important
information when errors occur.</p>
<p>The feedback areas are established at open time, and there is one feedback
area for each open file. One exception is for shared files, which share feedback
areas as well as the data path between the program and the file. For more
information about shared opens, see <a href="rbal3share.htm#rbal3share">Share files</a>.</p>
<div class="p">Some high-level languages on the server allow you to access the status
and other information about the file against which operations are being performed. There are two feedback areas of interest to you: <ul><li>Open feedback area <p>This area contains information of a general nature
about the file after the server has successfully opened the file. Examples
include the name and library of the file and the file type. See <a href="rbal3feedb.htm#rbal3feedb">Open feedback area</a> for
a complete list of the information that you can retrieve from the open feedback
area. In addition to general information about the file, the open feedback
area also contains file-specific information after the server has successfully
opened the file. The applicable fields depend on the file type.</p>
<p>The
open feedback area also contains information about each device or communications
session that is defined for the file.</p>
</li>
<li>Input/output feedback area <div class="p">There are two sections of the I/O feedback
area that are updated on the successful completion of input and output operations: <ul><li>Common area <p>This area contains information about I/O operations that
were performed on the file. This includes the number of operations and the
last operation performed. See <a href="rbal3fedbk.htm#rbal3fedbk">I/O feedback area</a> for
a complete list of the information that you can retrieve from the common I/O
feedback area.</p>
</li>
<li>File-dependent feedback area <p>This area contains file-specific information
for display, database, printer, and ICF files; for example, the major and
minor return code and amount of data received from the device. See <a href="rbal3ddiof.htm#rbal3ddiof">I/O feedback area for ICF and display files</a>, <a href="rbal3pddio.htm#rbal3pddio">I/O feedback area for printer files</a>,
and <a href="rbal3dbiof.htm#rbal3dbiof">I/O feedback area for database files</a> for a complete list of
the information that you can retrieve from the file-dependent I/O feedback
area.</p>
</li>
</ul>
</div>
</li>
</ul>
</div>
<p>The above information areas can be useful to you. For example,
when an error occurs with a device file, the program can determine predefined
error handling operations based on the major/minor return code in the file-dependent
feedback area. If data is being received from a communications device and
the application on the other end sends an error, the program can determine
that the next operation should be to wait until the next block of data is
sent indicating the error. Possibly, the next operation might be to close the
file and end the conversation with the application on the other side or wait
for the next request from the application.</p>
<p>Another way might include detecting the type of file that actually opened
to determine the type of operations that are allowed. If the file type is
printer, only output operations are allowed.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3open.htm" title="When you want an application to use a file, you do so by referring to that file by name. The file description for that file will then control how the program and the server will interact.">Open files</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rbal3share.htm" title="File management on iSeries provides several levels of support for shared files. Files can be shared among many users, many jobs, or many programs within the same job.">Share files</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="rbal3feedb.htm" title="The open feedback area is the part of the open data path (ODP) that contains general information about the file after it has been opened. It also contains file-specific information, depending on the file type, plus information about each device or communications session defined for the file. This information is set during open processing and can be updated as other operations are performed.">Open feedback area</a></div>
<div><a href="rbal3fedbk.htm" title="iSeries uses OS/400 messages and I/O feedback information to communicate the results of I/O operations to the program. The server updates the I/O feedback area for every successful I/O operation unless your program uses blocked record I/O.">I/O feedback area</a></div>
<div><a href="rbal3ddiof.htm" title="The table in this topic shows the I/O feedback area for ICF and display files.">I/O feedback area for ICF and display files</a></div>
<div><a href="rbal3pddio.htm" title="The table in this topic shows the I/O feedback area for printer files.">I/O feedback area for printer files</a></div>
</div>
</div>
</body>
</html>