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

342 lines
21 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 ICF and display files" />
<meta name="abstract" content="The table in this topic shows the I/O feedback area for ICF and display files." />
<meta name="description" content="The table in this topic shows the I/O feedback area for ICF and display files." />
<meta name="DC.subject" content="I/O feedback area, ICF, display, ICF I/O feedback area, ICF (intersystem communications function) file, intersystem communications function (ICF) file, display I/O feedback area, feedback area, I/O" />
<meta name="keywords" content="I/O feedback area, ICF, display, ICF I/O feedback area, ICF (intersystem communications function) file, intersystem communications function (ICF) file, display I/O feedback area, feedback area, I/O" />
<meta name="DC.Relation" scheme="URI" content="rbal3fedbk.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal3openiofba.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3ddiof" />
<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 ICF and display files</title>
</head>
<body id="rbal3ddiof"><a name="rbal3ddiof"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">I/O feedback area for ICF and display files</h1>
<div><p>The table in this topic shows the I/O feedback area for ICF and
display 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 ICF and
display files</caption><thead align="left"><tr><th align="left" valign="bottom" width="13.333333333333334%" id="d0e53">Offset</th>
<th align="left" valign="bottom" width="17.59259259259259%" id="d0e55">Data type</th>
<th align="left" valign="bottom" width="13.703703703703704%" id="d0e57">Length</th>
<th align="left" valign="bottom" width="40.55555555555556%" id="d0e59">Contents</th>
<th align="left" valign="bottom" width="14.814814814814813%" id="d0e61">File type</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>0</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>2</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Flag bits.</strong> <dl><dt class="dlterm">Bit 1:</dt>
<dd>Cancel-read indicator. <dl><dt class="dlterm">0</dt>
<dd>The cancel-read operation did not cancel the read request.</dd>
<dt class="dlterm">1</dt>
<dd>The cancel-read operation canceled the read request.</dd>
</dl>
</dd>
<dt class="dlterm">Bit 2:</dt>
<dd>Data-returned indicator. <dl><dt class="dlterm">0</dt>
<dd>The cancel-read operation did not change the contents of the input buffer.</dd>
<dt class="dlterm">1</dt>
<dd>The cancel-read operation placed the data from the read-with-no-wait operation
into the input buffer.</dd>
</dl>
</dd>
<dt class="dlterm">Bit 3:</dt>
<dd>Command key indicator. <dl><dt class="dlterm">0</dt>
<dd>Conditions for setting this indicator did not occur.</dd>
<dt class="dlterm">1</dt>
<dd>The Print, Help, Home, Roll Up, Roll Down, or Clear key was pressed. The
key is enabled with a DDS keyword, but without a response indicator specified.</dd>
</dl>
</dd>
<dt class="dlterm">Bits 4-16:</dt>
<dd>Reserved.</dd>
</dl>
</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>2</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>1</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Attention indicator byte (AID). This field
identifies which function key was pressed.</strong> <p>For ICF files, this field
will always contain the value hex F1 to imitate the Enter key being pressed
on a display device.</p>
<div class="p">For display files, this field will contain the
1-byte hexadecimal value returned from the device. <dl><dt><strong>Hex codes</strong></dt>
<dd><strong>Function keys</strong></dd>
<dt class="dlterm">hex 31</dt>
<dd>1</dd>
<dt class="dlterm">hex 32</dt>
<dd>2</dd>
<dt class="dlterm">hex 33</dt>
<dd>3</dd>
<dt class="dlterm">hex 34</dt>
<dd>4</dd>
<dt class="dlterm">hex 35</dt>
<dd>5</dd>
<dt class="dlterm">hex 36</dt>
<dd>6</dd>
<dt class="dlterm">hex 37</dt>
<dd>7</dd>
<dt class="dlterm">hex 38</dt>
<dd>8</dd>
<dt class="dlterm">hex 39</dt>
<dd>9</dd>
<dt class="dlterm">hex 3A</dt>
<dd>10</dd>
<dt class="dlterm">hex 3B</dt>
<dd>11</dd>
<dt class="dlterm">hex 3C</dt>
<dd>12</dd>
<dt class="dlterm">hex B1</dt>
<dd>13</dd>
<dt class="dlterm">hex B2</dt>
<dd>14</dd>
<dt class="dlterm">hex B3</dt>
<dd>15</dd>
<dt class="dlterm">hex B4</dt>
<dd>16</dd>
<dt class="dlterm">hex B5</dt>
<dd>17</dd>
</dl>
</div>
</td>
<td valign="top" width="14.814814814814813%" headers="d0e61 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 ">&nbsp;</td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 ">&nbsp;</td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 ">&nbsp;</td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "> <dl><dt class="dlterm">hex B6</dt>
<dd>18</dd>
<dt class="dlterm">hex B7</dt>
<dd>19</dd>
<dt class="dlterm">hex B8</dt>
<dd>20</dd>
<dt class="dlterm">hex B9</dt>
<dd>21</dd>
<dt class="dlterm">hex BA</dt>
<dd>22</dd>
<dt class="dlterm">hex BB</dt>
<dd>23</dd>
<dt class="dlterm">hex BC</dt>
<dd>24</dd>
<dt class="dlterm">hex BD</dt>
<dd>Clear</dd>
<dt class="dlterm">hex F1</dt>
<dd>Enter/Rec Adv</dd>
<dt class="dlterm">hex F3</dt>
<dd>Help (not in operator-error mode)</dd>
<dt class="dlterm">hex F4</dt>
<dd>Roll Down</dd>
<dt class="dlterm">hex F5</dt>
<dd>Roll Up</dd>
<dt class="dlterm">hex F6</dt>
<dd>Print</dd>
<dt class="dlterm">hex F8</dt>
<dd>Record Backspace</dd>
<dt class="dlterm">hex 3F</dt>
<dd>Auto Enter (for Selector Light Pen)</dd>
</dl>
</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display, ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>3</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>2</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Cursor location (line and position)</strong>.
Updated on input operations that are not subfile operations that return data
to the program. For example, hex 0102 means line 1, position 2. Line 10, position
33 would be hex 0A21.</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>5</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Binary</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>4</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Actual data length</strong>. For an ICF file,
see the <a href="../books/sc415442.pdf" target="_blank">ICF
Programming</a> <img src="wbpdf.gif" alt="Link to&#xA;PDF" /> book for additional information. For a display file, this
is the length of the record format processed by the I/O operation.</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display, ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>9</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Binary</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>2</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Relative record number of a subfile record</strong>.
Updated for a subfile record operation. For input operations, updated only
if data is returned to the program. If multiple subfiles are on the display,
this offset will contain the relative record number for the last subfile updated.</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>11</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Binary</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>2</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Lowest subfile</strong>. ndicates the lowest
subfile relative record number currently displayed in the uppermost subfile
display area if the last write operation was done to the subfile control record
with SFLDSP specified. Updated for roll up and roll down operations. Reset
to 0 on a write operation to another record. Not set for message subfiles.</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>13</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Binary</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>2</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Total number of records in a subfile</strong>.
Updated on a put-relative operation to any subfile record. The number is set
to zero on a write or write-read operation to any subfile control record with
the SFLINZ keyword optioned on. If records are put to multiple subfiles on
the display, this offset will contain the total number of records for all
subfiles assuming that no write or write-read operations were performed to
any subfile control record with the SFLINZ keyword optioned on.</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>15</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>2</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Cursor location (line and position) within
active window</strong>. Updated on input operations that are not subfile operations
that return data to the program. For example, hex 0203 means line 2, position
3 relative to the upper-left corner of the active window.</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>17</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>17</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Reserved.</strong></td>
<td valign="top" width="14.814814814814813%" headers="d0e61 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>34</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>2</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Major return code.</strong> <dl><dt class="dlterm">00</dt>
<dd>Operation completed successfully.</dd>
<dt class="dlterm">02</dt>
<dd>Input operation completed successfully, but job is being canceled (controlled).</dd>
<dt class="dlterm">03</dt>
<dd>Input operation completed successfully, but no data received.</dd>
<dt class="dlterm">04</dt>
<dd>Output exception.</dd>
<dt class="dlterm">08</dt>
<dd>Device already acquired.</dd>
<dt class="dlterm">11</dt>
<dd>Read from invited devices was not successful.</dd>
<dt class="dlterm">34</dt>
<dd>Input exception.</dd>
<dt class="dlterm">80</dt>
<dd>Permanent server or file error.</dd>
<dt class="dlterm">81</dt>
<dd>Permanent session or device error.</dd>
<dt class="dlterm">82</dt>
<dd>Acquire or open operation failed.</dd>
<dt class="dlterm">83</dt>
<dd>Recoverable session or device error.</dd>
</dl>
</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display, ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>36</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>2</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Minor return code</strong>. For the values
for a display file, see the <a href="../books/sc415715.pdf" target="_blank">Application Display Programming</a> <img src="wbpdf.gif" alt="Link to PDF" /> book. For the values for
an ICF file, see the <a href="../books/sc415442.pdf" target="_blank">ICF
Programming</a> <img src="wbpdf.gif" alt="Link to&#xA;PDF" /> book and the appropriate communications-type programmer's
guide.</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>Display, ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>38</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>8</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Systems Network Architecture (SNA) sense
return code</strong>. For some return codes, this field might contain more detailed
information about the reason for the error. For a description of the SNA sense
codes, see the appropriate SNA book.</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>46</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>1</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Safe indicator:</strong> <dl><dt class="dlterm">0</dt>
<dd>An end-of-text (ETX) control character has not been received.</dd>
<dt class="dlterm">1</dt>
<dd>An ETX control character has been received.</dd>
</dl>
</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>47</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>1</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Reserved.</strong></td>
<td valign="top" width="14.814814814814813%" headers="d0e61 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>48</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>1</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Request Write (RQSWRT) command from remote
system/application.</strong> <dl><dt class="dlterm">0</dt>
<dd>RQSWRT not received</dd>
<dt class="dlterm">1</dt>
<dd>RQSWRT received</dd>
</dl>
</td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>49</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>10</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Record format name received from the remote
server.</strong></td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>59</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>4</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Reserved.</strong></td>
<td valign="top" width="14.814814814814813%" headers="d0e61 ">&nbsp;</td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>63</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>8</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Mode name.</strong></td>
<td align="left" valign="top" width="14.814814814814813%" headers="d0e61 "><strong>ICF</strong></td>
</tr>
<tr><td align="left" valign="top" width="13.333333333333334%" headers="d0e53 "><strong>71</strong></td>
<td align="left" valign="top" width="17.59259259259259%" headers="d0e55 "><strong>Character</strong></td>
<td align="left" valign="top" width="13.703703703703704%" headers="d0e57 "><strong>9</strong></td>
<td align="left" valign="top" width="40.55555555555556%" headers="d0e59 "><strong>Reserved.</strong></td>
<td valign="top" width="14.814814814814813%" headers="d0e61 ">&nbsp;</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 class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rbal3openiofba.htm" title="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.">Monitor file status with the open and I/O feedback area</a></div>
</div>
</div>
</body>
</html>