ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzalu_5.4.0.1/rzalurefiofedbk.htm

342 lines
12 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 xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" 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. -->
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<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))' />
<title>I/O feedback area</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="rzalurefiofedbk"></a>
<h4 id="rzalurefiofedbk">I/O feedback area</h4>
<p>The results of I/O operations are communicated to the program using i5/OS
messages and I/O feedback information. The I/O feedback area is updated for
every I/O operation unless your program is using blocked record I/O. In that
case, the feedback area is updated only when a block of records is written.
Some of the information reflects the last record in the block. Other information,
such as the count of I/O operations, reflects the number of operations on
blocks of records and not the number of records. See your high-level language
manual to determine if your program uses blocked record I/O.</p>
<p>The I/O feedback area consists of two parts: a common area and a file-dependent
area. The file-dependent area varies by the file type. This topic discusses
device file type of printers only.</p>
<p><span class="bold">Common I/O feedback area</span></p>
<a name="wq365"></a>
<table id="wq365" width="100%" summary="" border="1" frame="border" rules="all" class="singleborder">
<thead valign="bottom">
<tr class="tablemainheaderbar">
<th id="wq366" width="15%" align="left" valign="bottom">Offset</th>
<th id="wq367" width="22%" align="left" valign="bottom">Data Type</th>
<th id="wq368" width="19%" align="left" valign="bottom">Length in Bytes</th>
<th id="wq369" width="42%" align="left" valign="bottom">Contents</th>
</tr>
</thead>
<tbody valign="top">
<tr>
<td align="left" valign="top" headers="wq366">0</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">2</td>
<td align="left" valign="top" headers="wq369">Offset to file-dependent
feedback area.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">2</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">4</td>
<td align="left" valign="top" headers="wq369">Write operation count.
Updated only when a write operation completes successfully. For blocked
record I/O operations, this count is the number of blocks, not the number
of records.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">6</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">4</td>
<td align="left" valign="top" headers="wq369">Read operation count.
Not applicable to printers.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">10</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">4</td>
<td align="left" valign="top" headers="wq369">Write-read operation
count. Not applicable to printers.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">14</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">4</td>
<td align="left" valign="top" headers="wq369">Other operation count.
Number of successful operations other than write, read, or write-read. Updated
only when the operation completes successfully. This count includes force-end-of-data.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">18</td>
<td align="left" valign="top" headers="wq367">Character</td>
<td align="left" valign="top" headers="wq368">1</td>
<td align="left" valign="top" headers="wq369">Reserved.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">19</td>
<td align="left" valign="top" headers="wq367">Character</td>
<td align="left" valign="top" headers="wq368">1</td>
<td align="left" valign="top" headers="wq369">Current operation.
<dl>
<dt class="bold">hex 05</dt>
<dd>Write or write block
</dd>
<dt class="bold">hex 09</dt>
<dd>Force-end-of-data
</dd>
</dl></td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">20</td>
<td align="left" valign="top" headers="wq367">Character</td>
<td align="left" valign="top" headers="wq368">10</td>
<td align="left" valign="top" headers="wq369">Name of the record
format just processed, which is either:
<ul>
<li>Specified on the I/O request, or</li>
<li>Determined by default or format selection processing</li></ul></td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">30</td>
<td align="left" valign="top" headers="wq367">Character</td>
<td align="left" valign="top" headers="wq368">2</td>
<td align="left" valign="top" headers="wq369">Device class:
<p>Byte
1: </p>
<dl>
<dt class="bold">hex 00</dt>
<dd>Database
</dd>
<dt class="bold">hex 01</dt>
<dd>Display
</dd>
<dt class="bold">hex 02</dt>
<dd>Printer
</dd>
<dt class="bold">hex 04</dt>
<dd>Diskette
</dd>
<dt class="bold">hex 05</dt>
<dd>Tape
</dd>
<dt class="bold">hex 09</dt>
<dd>Save
</dd>
<dt class="bold">hex 0B</dt>
<dd>ICF
</dd>
</dl>
<p>Byte 2 (if byte 1 is 02 for printer): </p>
<dl>
<dt class="bold">hex 02</dt>
<dd>5256 Printer
</dd>
<dt class="bold">hex 0C</dt>
<dd>5224/5225 printers
</dd>
<dt class="bold">hex 0F</dt>
<dd>5219 Printer
</dd>
<dt class="bold">hex 10</dt>
<dd>5583 Printer (DBCS)
</dd>
<dt class="bold">hex 11</dt>
<dd>5553 Printer (DBCS)
</dd>
<dt class="bold">hex 14</dt>
<dd>3270 Printer
</dd>
<dt class="bold">hex 21</dt>
<dd>4234 (SCS) Printer
</dd>
<dt class="bold">hex 22</dt>
<dd>3812 (SCS) Printer
</dd>
<dt class="bold">hex 23</dt>
<dd>4214 Printer
</dd>
<dt class="bold">hex 24</dt>
<dd>4224 (IPDS&trade;) Printer
</dd>
<dt class="bold">hex 25</dt>
<dd>4245 Printer
</dd>
<dt class="bold">hex 29</dt>
<dd>5262 Printer
</dd>
<dt class="bold">hex 30</dt>
<dd>3812 (IPDS) Printer
</dd>
<dt class="bold">hex 31</dt>
<dd>4234 (IPDS) Printer
</dd>
<dt class="bold">hex 32</dt>
<dd>IPDS printer, model unspecified
</dd>
<dt class="bold">hex 55</dt>
<dd>6252 (SCS) Printer
</dd>
<dt class="bold">hex 57</dt>
<dd>4230 (IPDS) Printer
</dd>
<dt class="bold">hex 63</dt>
<dd>3935 (IPDS) Printer
</dd>
</dl></td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">32</td>
<td align="left" valign="top" headers="wq367">Character</td>
<td align="left" valign="top" headers="wq368">10</td>
<td align="left" valign="top" headers="wq369">Device name. The name
of the device for which the operation just completed. The device name is
supplied only for printer, display, tape, diskette, and ICF files. For printer
files being spooled, the value is *N. For printer files not being spooled,
the value is the device description name.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">42</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">4</td>
<td align="left" valign="top" headers="wq369">Not applicable to printer.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">46</td>
<td align="left" valign="top" headers="wq367">Character</td>
<td align="left" valign="top" headers="wq368">80</td>
<td align="left" valign="top" headers="wq369">Reserved.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">126</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">2</td>
<td align="left" valign="top" headers="wq369">Not applicable to printer.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">128</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">2</td>
<td align="left" valign="top" headers="wq369">For printers, the field
value is the record format length, including first-character forms control,
option indicators, source sequence numbers, and program-to-system data. If
the value is zero, use the field at offset 42.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">130</td>
<td align="left" valign="top" headers="wq367">Character</td>
<td align="left" valign="top" headers="wq368">2</td>
<td align="left" valign="top" headers="wq369">Reserved.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">132</td>
<td align="left" valign="top" headers="wq367">Binary</td>
<td align="left" valign="top" headers="wq368">4</td>
<td align="left" valign="top" headers="wq369">Not applicable to printer.</td>
</tr>
<tr>
<td align="left" valign="top" headers="wq366">136</td>
<td align="left" valign="top" headers="wq367">Character</td>
<td align="left" valign="top" headers="wq368">8</td>
<td align="left" valign="top" headers="wq369">Reserved.</td>
</tr>
</tbody>
</table>
<p><span class="bold">I/O feedback area for printer files</span></p>
<a name="wq370"></a>
<table id="wq370" width="100%" summary="" border="1" frame="border" rules="all" class="singleborder">
<thead valign="bottom">
<tr class="tablemainheaderbar">
<th id="wq371" width="15%" align="left">Offset</th>
<th id="wq372" width="22%" align="left">Data Type</th>
<th id="wq373" width="19%" align="left">Length in Bytes</th>
<th id="wq374" width="42%" align="left">Contents</th>
</tr>
</thead>
<tbody valign="top">
<tr>
<td headers="wq371">0</td>
<td headers="wq372">Binary</td>
<td headers="wq373">2</td>
<td headers="wq374">Current line number in a page.</td>
</tr>
<tr>
<td headers="wq371">2</td>
<td headers="wq372">Binary</td>
<td headers="wq373">4</td>
<td headers="wq374">Current page count.</td>
</tr>
<tr>
<td headers="wq371">6</td>
<td headers="wq372">Character</td>
<td headers="wq373">1</td>
<td headers="wq374">Miscellaneous flags
<dl>
<dt class="bold">Bit 1:</dt>
<dd>Spooled file deleted.
</dd>
<dt class="bold">Bit 2&ndash;8:</dt>
<dd>Reserved.
</dd>
</dl>.</td>
</tr>
<tr>
<td headers="wq371">7</td>
<td headers="wq372">Character</td>
<td headers="wq373">27</td>
<td headers="wq374">Reserved.</td>
</tr>
<tr>
<td headers="wq371">34</td>
<td headers="wq372">Character</td>
<td headers="wq373">2</td>
<td headers="wq374">Major return code.
<dl>
<dt class="bold">00</dt>
<dd>Operation completed successfully
</dd>
<dt class="bold">80</dt>
<dd>Permanent system or file error
</dd>
<dt class="bold">81</dt>
<dd>Permanent device error
</dd>
<dt class="bold">82</dt>
<dd>Open operation failed
</dd>
<dt class="bold">83</dt>
<dd>Recoverable device error occurred
</dd>
</dl></td>
</tr>
<tr>
<td headers="wq371">36</td>
<td headers="wq372">Character</td>
<td headers="wq373">2</td>
<td headers="wq374">Minor return code.</td>
</tr>
</tbody>
</table>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>