342 lines
12 KiB
HTML
342 lines
12 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 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™) 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–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>
|