ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahh_5.4.0.1/printrsf.htm

58 lines
4.1 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 lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<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="Reading spooled files and AFP resources" />
<meta name="abstract" content="" />
<meta name="description" content="" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="printrsf" />
<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>Reading spooled files and AFP resources</title>
</head>
<body id="printrsf"><a name="printrsf"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Reading spooled files and AFP resources</h1>
<div><p></p>
<div class="section"><p>You can use the <a href="javadoc/com/ibm/as400/access/PrintObjectInputStream.html"> PrintObjectInputStream</a> class to read the raw contents
of a spooled file or Advanced Function Printing™ (AFP™)
resource from the server. The class extends the standard JDK java.io.InputStream
class so that it can be used anywhere an InputStream is used.</p>
<p>Obtain
a PrintObjectInputStream object by calling either the <a href="javadoc/com/ibm/as400/access/SpooledFile.html#GETINPUTSTREAM()"> getInputStream()</a> method on an instance of the SpooledFile
class or the <a href="javadoc/com/ibm/as400/access/AFPResource.html#GETINPUTSTREAM()"> getInputStream()</a> method on an instance of the AFPResource
class. Getting an input stream for a spooled file is supported for Version
3 Release 2 (V3R2), V3R7, and later versions of i5/OS™. Getting input streams for AFP resources is
supported for V3R7 and later.</p>
<p>Use one of the <a href="javadoc/com/ibm/as400/access/PrintObjectInputStream.html#READ()"> read()</a> methods for reading from the input stream. These
methods all return the number of bytes actually read, or -1 if no bytes were
read and the end of file was reached.</p>
<p>Use the <a href="javadoc/com/ibm/as400/access/PrintObjectInputStream.html#AVAILABLE()"> available()</a> method of PrintObjectInputStream to return
the total number of bytes in the spooled file or AFP resource. The PrintObjectInputStream
class supports marking the input stream, so PrintObjectInputStream always
returns true from the <a href="javadoc/com/ibm/as400/access/PrintObjectInputStream.html#MARKSUPPORTED()"> markSupported()</a> method. The caller can use the <a href="javadoc/com/ibm/as400/access/PrintObjectInputStream.html#MARK(INT)"> mark()</a> and <a href="javadoc/com/ibm/as400/access/PrintObjectInputStream.html#RESET()"> reset()</a> methods to move the current read position backward
in the input stream. Use the <a href="javadoc/com/ibm/as400/access/PrintObjectInputStream.html#SKIP(LONG)"> skip()</a> method to move the read position forward in the
input stream without reading the data.</p>
</div>
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to use
PrintObjectInputStream to read an existing server spooled file</p>
<blockquote><a href="npexamplereadsplf.htm#npexamplereadsplf">Example: Reading spooled files</a></blockquote>
</div>
</div>
</body>
</html>