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

204 lines
11 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="reference" />
<meta name="DC.Title" content="I/O feedback area for database files" />
<meta name="abstract" content="The table in this topic shows the I/O feedback area for database files." />
<meta name="description" content="The table in this topic shows the I/O feedback area for database files." />
<meta name="DC.subject" content="I/O feedback area, database, feedback area, I/O" />
<meta name="keywords" content="I/O feedback area, database, feedback area, I/O" />
<meta name="DC.Relation" scheme="URI" content="rbal3fedbk.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3dbiof" />
<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> I/O feedback area for database files</title>
</head>
<body id="rbal3dbiof"><a name="rbal3dbiof"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1"> I/O feedback area for database files</h1>
<div><p>The table in this topic shows the I/O feedback area for database
files.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="hsides" border="0" rules="none"><caption>Table 1. I/O feedback area for database
files</caption><thead align="left"><tr><th align="left" valign="bottom" width="16.666666666666664%" id="d0e34">Offset</th>
<th align="left" valign="bottom" width="21.48148148148148%" id="d0e36">Data type</th>
<th align="left" valign="bottom" width="22.77777777777778%" id="d0e38">Length</th>
<th align="left" valign="bottom" width="39.07407407407407%" id="d0e40">Contents</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">0</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">4</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Size of the database feedback area, including
the key and the null key field byte map.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">4</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Character</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">4</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 "> <dl><dt class="dlterm">Bits 1-32:</dt>
<dd>Each bit represents a join logical file in JFILE keyword. <dl><dt class="dlterm">0</dt>
<dd>JDFTVAL not supplied for file</dd>
<dt class="dlterm">1</dt>
<dd>JDFTVAL supplied for file</dd>
</dl>
</dd>
</dl>
</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">8</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">2</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Offset from the beginning of the I/O feedback
area for database files to the null key field byte map which follows the key
value (which begins at offset 34 in this area).</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">10</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">2</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Number of locked records.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">12</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">2</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Maximum number of fields.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">14</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">4</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Offset to the field-mapping error-bit map.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">18</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Character</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">1</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Current file position indication. <dl><dt class="dlterm">Bit 1:</dt>
<dd>Current file position is valid for get-next-key equal operation. <dl><dt class="dlterm">0</dt>
<dd>File position is not valid.</dd>
<dt class="dlterm">1</dt>
<dd>File position is valid.</dd>
</dl>
</dd>
<dt class="dlterm">Bits 2-8:</dt>
<dd>Reserved.</dd>
</dl>
</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">19</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Character</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">1</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Current record deleted indication: <dl><dt class="dlterm">Bits 1-2:</dt>
<dd>Reserved.</dd>
<dt class="dlterm">Bit 3:</dt>
<dd>Next message indicator. <dl><dt class="dlterm">0</dt>
<dd>Next message not end of file.</dd>
<dt class="dlterm">1</dt>
<dd>Next message might be end of file.</dd>
</dl>
</dd>
<dt class="dlterm">Bit 4:</dt>
<dd>Deleted record indicator. <dl><dt class="dlterm">0</dt>
<dd>Current file position is at an active record.</dd>
<dt class="dlterm">1</dt>
<dd>Current file position is at a deleted record.</dd>
</dl>
</dd>
<dt class="dlterm">Bit 5:</dt>
<dd>Write operation key feedback indicator. <dl><dt class="dlterm">0</dt>
<dd>Key feedback is not provided by last write operation.</dd>
<dt class="dlterm">1</dt>
<dd>Key feedback is provided by last write operation.</dd>
</dl>
</dd>
<dt class="dlterm">Bit 6:</dt>
<dd>File position changed indicator. Set only for read and positioning I/O
operations. Not set for write, update, and delete I/O operations. <dl><dt class="dlterm">0</dt>
<dd>File position did not change.</dd>
<dt class="dlterm">1</dt>
<dd>File position did change.</dd>
</dl>
</dd>
<dt class="dlterm">Bit 7:</dt>
<dd>Pending exception indicator. Valid for files open for input only and SEQONLY(*YES
N) where N is greater than 1. <dl><dt class="dlterm">0</dt>
<dd>Pending retrieval error does not exist.</dd>
<dt class="dlterm">1</dt>
<dd>Pending retrieval error does exist.</dd>
</dl>
</dd>
<dt class="dlterm">Bit 8:</dt>
<dd>Duplicate key indicator. <dl><dt class="dlterm">0</dt>
<dd>The key of the last read or write operation was not a duplicate key.</dd>
<dt class="dlterm">1</dt>
<dd>The key of the last read or write operation was a duplicate key.</dd>
</dl>
</dd>
</dl>
</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">20</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">2</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Number of key fields. Use this offset for
binary operations. Use the next offset (offset 21) for character operations.
These offsets overlap and provide the same value (there can be no more than
32 key fields, and only the low-order byte of offset 20 is used).</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">21</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Character</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">1</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Number of key fields.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">22</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Character</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">4</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Reserved.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">26</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">2</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Key length.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">28</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">2</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Data member number.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">30</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Binary</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">4</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Relative record number in data member.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">34</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Character</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">*</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Key value.</td>
</tr>
<tr><td align="left" valign="top" width="16.666666666666664%" headers="d0e34 ">*</td>
<td align="left" valign="top" width="21.48148148148148%" headers="d0e36 ">Character</td>
<td align="left" valign="top" width="22.77777777777778%" headers="d0e38 ">*</td>
<td align="left" valign="top" width="39.07407407407407%" headers="d0e40 ">Null key field byte map.</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <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>
</div>
</body>
</html>