ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/QIMGCVTI.htm

5216 lines
132 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Convert Image (QIMGCVTI, QimgCvtImg) API</title>
<!-- Begin Header Records ======================================== -->
<!-- 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. -->
<!-- Print SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- File Edited by Kersten Oct 2001 -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<h2>Convert Image (QIMGCVTI, QimgCvtImg) API</h2>
<div class="box" style="width: 70%;">
<br>
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="50%">Control structure</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Input image structure</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">Main storage input image</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Output image structure</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Main storage output image</td>
<td align="left" valign="top">Output</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="left" valign="top">Feedback structure</td>
<td align="left" valign="top">Output</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">7</td>
<td align="left" valign="top">Error code</td>
<td align="left" valign="top">I/O</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Service Program Name: QIMGCIMG<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Convert Image (OPM, QIMGCVTI; ILE, QimgCvtImg) API converts an image or
print data stream from one format to another, and optionally prints the result.
The input and output data streams can reside in a stream file, a spooled file,
or main storage. The supported input data stream formats are Graphics
Interchange Format (GIF), Tag Image File Format (TIFF), OS/2 and Windows Bitmap
(BMP), and PostScript Level. The supported output data stream formats are
Advanced Function Print (AFP), Hewlett-Packard Printer Control Language (PCL),
and PostScript Level 1.</p>
<p>In addition to the input data stream formats listed above, the following
input data stream formats may be supported through the use of a valid
registered exit program: Hewlett-Packard Printer Control Language (PCL) and
Portable Document Format (PDF). In addition to the output data stream formats
listed above, the following output data stream format may be supported through
the use of a valid registered exit program: PostScript (including Level 2 and
above). By specifying UNKNOWN for the input data stream or the output data
stream, the user may also, through the use of a valid registered exit program,
transform data streams that are not listed here.</p>
<p>For more information, refer to the <a href=
"../rzahg/rzahgprint.htm">Printing</a> topic.</p>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>Image Configuration Authority</em></dt>
<dd>*USE</dd>
<dt><em>Image Configuration Lock</em></dt>
<dd>*SHRRD</dd>
<dt><em>Input Stream File Authority</em></dt>
<dd>*R</dd>
<dt><em>Input Stream File Open Sharing Mode</em></dt>
<dd>Share with readers</dd>
<dt><em>All Directory in Input Path Authority</em></dt>
<dd>*X</dd>
<dt><em>Input Spooled File Authority</em></dt>
<dd>See <a href="#HDRCVSPAUT">Input Spooled File Authorities</a>.</dd>
<dt><em>Input Spooled File Lock</em></dt>
<dd>*LSRD</dd>
<dt><em>Font Stream File Authority</em></dt>
<dd>*R</dd>
<dt><em>Font Stream File Open Sharing Mode</em></dt>
<dd>Share with readers</dd>
<dt><em>All Directory in Font Path Authority</em></dt>
<dd>*X</dd>
<dt><em>Output Stream File Authority</em></dt>
<dd>*W</dd>
<dt><em>Output Stream File Open Sharing Mode</em></dt>
<dd>Share with neither readers nor writers</dd>
<dt><em>All Directory in Output Path Authority</em></dt>
<dd>*X</dd>
<dt><em>Lowest Directory in Output Path Authority</em></dt>
<dd>*XW</dd>
<dt><em>Printer Device Authority</em></dt>
<dd>*USE</dd>
<dt><em>Output Queue Authority</em></dt>
<dd>*USE</dd>
<dt><em>Printer File Authority</em></dt>
<dd>*USE</dd>
<dt><em>Printer File Lock</em></dt>
<dd>*SHRNUP</dd>
</dl>
<br>
<h4><a name="HDRCVSPAUT">Input Spooled File Authorities</a></h4>
<p>The requester is authorized to the input spooled file if one or more of the
following conditions are met:</p>
<ul>
<li>The requester is the owner of the spooled file.</li>
<li>The requester has *READ authority to the queue on which the spooled file
resides, and the queue is specified as DSPDTA(*YES).</li>
<li>The requester has *SPLCTL authority.</li>
<li>The requester has *JOBCTL authority, and the queue on which the spooled
file resides is specified as OPRCTL(*YES).</li>
<li>The requester has ownership of the queue on which the spooled file resides,
and the queue is specified as AUTCHK(*OWNER).</li>
<li>The requester has read, add, and delete authorities to the queue on which
the spooled file resides, and the queue is specified as AUTCHK(*DTAAUT).</li>
</ul>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Control structure</strong></dt>
<dd>INPUT; CHAR(*)
<p>Information that controls the conversion process. This information does not
pertain specifically to either the input or output image or print data streams.
See <a href="#HDRCVIP1">Control Structure Format</a> for information about the
format.</p>
</dd>
<dt><strong>Input image structure</strong></dt>
<dd>INPUT;CHAR(*)
<p>A description of the input image or print data stream. See <a href=
"#HDRCVIP2">Input Image Structure Format</a> for information about the
format.</p>
</dd>
<dt><strong><a name="SPTCVIP3">Main storage input image</a></strong></dt>
<dd>INPUT;CHAR(*)
<p>When the format field of the input image structure is IMGI0300, this
parameter contains the input image or print data stream.</p>
<p>When this parameter does not contain the input data stream, it must contain
4 bytes of hexadecimal zeros.</p>
</dd>
<dt><strong>Output image structure</strong></dt>
<dd>INPUT;CHAR(*)
<p>A description of the output image or print data stream and where it is to be
written. See <a href="#HDRCVIP4">Output Image Structure Format</a> for
information about the format.</p>
</dd>
<dt><strong><a name="SPTCVIP5P">Main storage output image</a></strong></dt>
<dd>OUTPUT; CHAR(*)
<p>When the format field of the output image structure is IMGO0300, this
parameter is the destination of the converted image or print data stream.</p>
<strong>Notes:</strong>
<ol>
<li>The space provided field of the output image structure specifies the
available size of this storage area.</li>
<li>The output data stream length field of the feedback structure specifies the
amount of storage used by the converted data stream.</li>
<li>If the space provided field is insufficient to contain the converted data
stream, an error condition is returned, and no data stream is returned in this
parameter.</li>
</ol>
<br>
</dd>
<dt><strong>Feedback structure</strong></dt>
<dd>OUTPUT;CHAR(*)
<p>Additional output information from the API, such as a spooled file
identifier, size of main storage output, or a handle for future API calls for
multiple page output. See <a href="#HDRCVIP6">Feedback Structure Format</a> for
information about the format.</p>
</dd>
<dt><strong>Error code</strong></dt>
<dd>I/O; CHAR(*)
<p>The structure in which to return error information. For the format of the
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
</dd>
</dl>
<br>
<h3><a name="HDRCVIP1">Control Structure Format</a></h3>
<p>The table below shows the organization of the control structure parameter.
For detailed descriptions of each field, see <a href="#HDRCSFD">Field
Descriptions</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Operation</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">CHAR(32)</td>
<td align="left" valign="top">Handle for multipage output</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Space provided for feedback structure</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Feedback structure format</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Reverse</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Color reduction</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resize</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Stretch</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Horizontal justify</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Vertical justify</td>
</tr>
<tr>
<td align="center" valign="top">84</td>
<td align="center" valign="top">54</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Keep color</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Keep quality</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Cancel on error</td>
</tr>
<tr>
<td align="center" valign="top">96</td>
<td align="center" valign="top">60</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Severity level</td>
</tr>
</table>
<br>
<h3><a name="HDRCSFD">Field Descriptions</a></h3>
<p><strong>Cancel on error.</strong> Whether the conversion should be ended
when a non catastrophic error condition is detected. When yes is specified, the
severity level field may be used to control which errors end the
conversion.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">No</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Yes</td>
</tr>
</table>
<br>
<p><strong>Color reduction.</strong> Whether or not to reduce the output data
stream's pixel information content. If color reduction is set to same, the
pixel information content of the output data stream will be either that of the
input data stream or the destination device, whichever is less. Setting color
reduction to gray scale will reduce the output pixel information content to
gray scale if it would have been color and will otherwise have no effect.
Setting color reduction to black and white will force the output to black and
white. See <a href="#HDRCVICRF">Color Reduction Field</a> for more details.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Same</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Gray scale</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Black and white</td>
</tr>
</table>
<br>
<p><strong>Feedback structure format.</strong> The format of the feedback
structure. See <a href="#HDRCVIP6">Feedback Structure Format</a> for a
description of the feedback structure. This field must contain the value
IMGF0100.</p>
<p><strong>Format.</strong> The format of the control structure. This field
must contain the value IMGC0100.</p>
<p><strong>Handle for multipage output.</strong> This parameter is not passed
to any transform program registered under exit point QIBM_QIMG_TRANSFORMS. The
handle that was returned in the feedback structure of a prior call to this API
that specified first for the operation field. See <a href="#HDRCVIP6">Feedback
Structure Format</a> and <a href="#HDRCVIMPG">Multipage Output</a> for more
information.</p>
<p>The handle is required when append, last, or end is specified for the
operation field. For all other values of operation, this field must be set to
hexadecimal zeros.</p>
<p><strong>Horizontal justify.</strong> The horizontal position of an image on
the page if the image is smaller than the page.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Center</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Left</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Right</td>
</tr>
</table>
<p><strong>Note:</strong> This field has no effect for PostScript input data
streams. It also may not work as expected if the input image is larger than the
page.</p>
<p><strong>Keep color.</strong> Whether all coloring in the source data stream
must be kept. If the conversion would result in loss of the number of colors or
number of gray scale shades, it is ended with an error condition and no
converted data stream is produced.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">No</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Yes</td>
</tr>
</table>
<p><strong>Note:</strong> This field has no effect for PostScript input data
streams.</p>
<p><strong>Keep quality.</strong> This parameter is not passed to any transform
program registered under exit point QIBM_QIMG_TRANSFORMS. Whether image or
print resolution must be kept. If the conversion would result in loss of
resolution, it is ended with an error condition and no converted data stream is
produced.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">No</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Yes</td>
</tr>
</table>
<p><strong>Note:</strong> This field has no effect for PostScript input data
streams or for any other data streams which do not contain resolution
information.<br>
</p>
<p><strong>Length.</strong> The length of the control structure. This length
must be 52 when the end option is specified for the operation field. In all
other cases, this length must be 100, or an error is returned.</p>
<p><strong>Operation.</strong> Whether or not a conversion is done, and if so,
when the conversion is to take place.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Calculate. An immediate or delayed conversion is selected,
based on the destination of the converted data stream. If the destination is a
spooled file, delayed is selected; otherwise, immediate is selected.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Immediate. The input data stream is converted before control
is returned to the API caller.</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Delayed. The input data stream is placed in a spooled file and
converted (if necessary) when the spooled file is printed. This value is only
valid for output format IMGO0200.</td>
</tr>
<tr>
<td valign="top"><em>3</em></td>
<td valign="top">No conversion. The input data stream is copied to the output
destination as is.</td>
</tr>
<tr>
<td valign="top"><em>4</em></td>
<td valign="top">First. A multipage conversion is initiated with the first
input data stream.</td>
</tr>
<tr>
<td valign="top"><em>5</em></td>
<td valign="top">Append. A multipage conversion is continued with another input
data stream.</td>
</tr>
<tr>
<td valign="top"><em>6</em></td>
<td valign="top">Last. A multipage conversion is ended with the last input data
stream.</td>
</tr>
<tr>
<td valign="top"><em>7</em></td>
<td valign="top">End. A multipage conversion is ended with no input data
stream.</td>
</tr>
</table>
<br>
<p>The calculate option selects the immediate or delayed option, based on the
destination of the converted data stream.</p>
<p>The delayed option is only valid when output is spooled. See format IMGO0200
in <a href="#HDRCVIP4">Output Image Structure Format</a> for output
specifications.</p>
<p>When no conversion is specified for operation and output is spooled to a PCL
or PostScript printer, the input data stream is passed through to the printer.
The caller must ensure that the input image or print data stream is compatible
with the destination printer. Otherwise, results are unpredictable.</p>
<p>When first, append, or last is specified, the input is converted before
control is returned to the API caller.</p>
<p>Refer to <a href="#HDRCVIMPG">Multipage Output</a> for more details about
the first, append, last, and end options.</p>
<p>Multipage conversion is not supported when transforming to an exit
program.</p>
<p><strong>Resize.</strong> This parameter is not passed to any transform
program registered under exit point QIBM_QIMG_TRANSFORMS. Controls resizing of
the output print or image data stream relative to the page size. Resize does
not change the aspect ratio of the image unless the stretch field is set to 1
(yes).</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Scale down if needed to fit page</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Keep size</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Keep pixels</td>
</tr>
<tr>
<td valign="top"><em>3</em></td>
<td valign="top">Scale up or down to fit page</td>
</tr>
<tr>
<td valign="top"><em>4</em></td>
<td valign="top">Scale up to fit page.</td>
</tr>
</table>
<p><strong>Note:</strong> Resize works by changing the resolution in the output
data stream and relies on the printer's ability to support that resolution.
Consequently, resize will not work on all printers. Resize has no effect for
PostScript input data streams.</p>
<p><strong>Reverse.</strong> If yes, black becomes white and white becomes
black. This parameter has no effect for color output. It also has no effect for
color images output as gray on a Printer Control Language (PCL) color
printer.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">No</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Yes</td>
</tr>
</table>
<p><strong>Note:</strong> This can also be done by changing the photometric
interpretation of pixels for the input or output data stream, either using
image configurations or the photometric interpretation fields that describe the
input and output data streams.</p>
<p><strong>Severity level.</strong> The severity level of error required to end
the conversion or print request when yes is specified for the cancel on error
field. Valid values are 0 through 99.</p>
<p><strong>Space provided for
feedback structure.</strong> The length of the storage that is provided for the
<a href="#HDRCVIP6">Feedback Structure Format</a>. The length must be either 0,
108, or 130.</p>
<p><strong>Stretch.</strong> This parameter is not passed to any transform
program registered under exit point QIBM_QIMG_TRANSFORMS. Whether, when
resizing the image, to stretch the image to fit the output size exactly, or to
preserve the image aspect ratio. If no, the image aspect ratio will not be
changed. If yes, the horizontal and vertical dimensions of the image will be
scaled independently and the aspect ratio may change if the image is
resized.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">No</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Yes</td>
</tr>
</table>
<p><strong>Note:</strong> This field has no effect for PCL or Advanced Function
Printing data stream (AFPDS) output or for PostScript input data streams. It
only takes effect if the image is resized; therefore this field has no effect
when the resize field contains 1 or 2 and possibly for other resize values.</p>
<p><strong>Vertical justify.</strong> The vertical position of an image on the
page if the image is smaller than the page.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Center</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Top</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Bottom</td>
</tr>
</table>
<p><strong>Note:</strong> This field has no effect for PostScript input data
streams. It also may not work as expected if the input image is larger than the
page.</p>
<h3><a name="HDRCVIP2">Input Image Structure Format</a></h3>
<p>The input image structure describes the input image or print data
stream.</p>
<p>The different formats specify the location of the input image or print data
stream to be converted: file, spooled file, or main storage. The formats
contain many common fields that specify attributes of the input image or print
data stream:</p>
<ul>
<li>Data stream format</li>
<li>Photometric interpretation</li>
<li>Resolution units</li>
<li>Horizontal resolution</li>
<li>Vertical resolution</li>
</ul>
<br>
<h4><a name="HDRCVIP2F1">IMGI0100 Format</a></h4>
<p>Use this format for input from a stream file.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Data stream format</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Photometric interpretation</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resolution units</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Horizontal resolution</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Vertical resolution</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Input object type</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to input object name</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of input object name</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Input object name</td>
</tr>
</table>
<br>
<h4><a name="HDRCVIP2F2">IMGI0200 Format</a></h4>
<p>Use this format for input from a spooled file.</p>
<p>This format contains fields used in combination to uniquely identify the
input spooled file:</p>
<ul>
<li>Qualified job name</li>
<li>Internal job identifier</li>
<li>Internal spooled file identifier</li>
<li>Spooled file name</li>
<li>Spooled file number</li>
<li>Job system name</li>
<li>Spooled file create date</li>
<li>Spooled file create time
</li>
</ul>
<br>
<p>Refer to the <a href="QSPOPNSP.htm">Open Spooled File</a> API for
information about the valid combinations of these fields.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Data stream format</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Photometric interpretation</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resolution units</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Horizontal resolution</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Vertical resolution</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">CHAR(26)</td>
<td align="left" valign="top">Qualified job name</td>
</tr>
<tr>
<td align="center" valign="top">78</td>
<td align="center" valign="top">4E</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internal job identifier</td>
</tr>
<tr>
<td align="center" valign="top">94</td>
<td align="center" valign="top">5E</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internal spooled file identifier</td>
</tr>
<tr>
<td align="center" valign="top">110</td>
<td align="center" valign="top">6E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Spooled file name</td>
</tr>
<tr>
<td align="center" valign="top">120</td>
<td align="center" valign="top">78</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Spooled file number</td>
</tr>
<tr>
<td align="center" valign="top">124</td>
<td align="center" valign="top">7C</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Job system name</td>
</tr>
<tr>
<td align="center" valign="top">132</td>
<td align="center" valign="top">84</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Spooled file create date</td>
</tr>
<tr>
<td align="center" valign="top">139</td>
<td align="center" valign="top">8B</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">140</td>
<td align="center" valign="top">8C</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Spooled file create time</td>
</tr>
</table>
<br>
<h4><a name="HDRCVIP2F3">IMGI0300 Format</a></h4>
<p>Use this format for input from main storage. See the <a href="#SPTCVIP3">
main storage input image parameter</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Data stream format</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Photometric interpretation</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resolution units</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Horizontal resolution</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Vertical resolution</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of input data stream</td>
</tr>
</table>
<br>
<h4><a name="HDRIIFD">Field Descriptions</a></h4>
<p><strong>Data stream format.</strong> Format of the input print or image data
stream. Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Format is determined from the input data
stream.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">TIFF (Tag Image File Format) (Only the first
image of a multiple-page TIFF image is transformed.)</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">BMP (Bitmap)</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">GIF (Graphics Interchange Format) (Only the first
image of an animated GIF image is transformed.)</td>
</tr>
<tr>
<td align="left" valign="top"><em>22</em></td>
<td align="left" valign="top">PCL (Printer Control Language) (Available only if
a transform exit program that supports PCL input has been registered to the
QIBM_QIMG_TRANSFORMS exit point)</td>
</tr>
<tr>
<td align="left" valign="top"><em>23</em></td>
<td align="left" valign="top">PostScript (PostScript level 2 and above
available only if a transform exit program that supports PostScript Level 2 or
above has been registered to the QIBM_QIMG_TRANSFORMS exit point)</td>
</tr>
<tr>
<td align="left" valign="top"><em>25</em></td>
<td align="left" valign="top">PDF (Portable Document Format) (Available only if
a transform exit program that supports PDF input has been registered to the
QIBM_QIMG_TRANSFORMS exit point)</td>
</tr>
<tr>
<td align="left" valign="top"><em>99</em></td>
<td align="left" valign="top">Unknown (Input data stream format unknown)</td>
</tr>
</table>
<br>
<p><strong>Format.</strong> The format of the input image structure, determined
by the location of the input data stream.</p>
<p>The following formats are defined:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>IMGI0100</em></td>
<td valign="top">Input is from a stream file.</td>
</tr>
<tr>
<td valign="top"><em>IMGI0200</em></td>
<td valign="top">Input is from a spooled file.</td>
</tr>
<tr>
<td valign="top"><em>IMGI0300</em></td>
<td valign="top">Input is from main storage.</td>
</tr>
</table>
<br>
<p><strong>Horizontal resolution.</strong> This parameter is not passed to any
transform program registered under exit point QIBM_QIMG_TRANSFORMS.</p>
<p>The number of horizontal pixels per resolution unit, or the following
special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Resolution determined from the input data stream. If
resolution cannot be determined from the data stream, a resolution of 300 dots
per inch is used.</td>
</tr>
</table>
<br>
<p><strong>Input object type.</strong> For format IMGI0100, the type of the
input object name.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Stream file</td>
</tr>
</table>
<br>
<p><strong>Input object name.</strong> For format IMGI0100, the input object
name. For stream file object type, this is the full name of the input stream
file, including path.</p>
<p><strong>Internal job identifier.</strong> For format IMGI0200, the internal
job identifier for the job that owns the spooled file. This field is used
only when the job name component of the qualified job name field is *INT, and
the other two components contain all blanks. For more information, see the List
Job (QUSLJOB) API in the Work Management part.</p>
<p><strong>Internal spooled file identifier.</strong> For structure format
IMGI0200, the internal spooled file identifier. This field is used only when
the spooled file name is *INT. For more information, see the <a href=
"QUSLSPL.htm">List Spooled Files (QUSLSPL) API</a>.</p>
<p><strong>Job system
name.</strong> The name of the system where the job that created the spooled
file ran or blank when the spooled file name is *INT.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*ONLY</em></td>
<td valign="top">There is one job with the specified job name, user name, job
number, spooled file name, spooled file number, spooled file creation date, and
spooled file creation time.</td>
</tr>
<tr>
<td valign="top"><em>*CURRENT</em></td>
<td valign="top">The job on the current system with the specified job name,
user name, job number, spooled file name, spooled file number, spooled file
create date, and spooled file create time is used.</td>
</tr>
<tr>
<td valign="top"><em>*ANY</em></td>
<td valign="top">The job system name is not considered when selecting a spooled
file. Use this value when you want the Spooled file create date and Spooled
file create time fields to take precedence over the job system name when
selecting a spooled file.</td>
</tr>
<tr>
<td valign="top"><em>system-name</em></td>
<td valign="top">The name of the system where the job that created the spooled
file ran.</td>
</tr>
</table>
<br>
<p>When the Length field is less than 146 bytes, the API assumes blanks when
the spooled file name is *INT. When spooled file name is not *INT, the API
assumes *ONLY.</p>
<p><strong>Length.</strong> The length of this structure, which varies
depending on the format specified.</p>
<p>When the convert field in the control structure specifies the end option,
the length must be 4.</p>
<p>For format IMGI0100, the length must be 68 plus the length of the input
object name.</p>
<p>For format IMGI0200, the
length must be 124 or 146.</p>
<p>For format IMGI0300, the length must be 56.</p>
<p><strong>Length of input data stream.</strong> For format IMGI0300, the
length of the input data stream in main storage.</p>
<p><strong>Length of input object name.</strong> For format IMGI0100, the
length of the input object name.</p>
<p><strong>Offset to input object name.</strong> For format IMGI0100, the
offset in bytes from the start of the Input Image Structure to the input object
name. This value must be 68.</p>
<p><strong>Photometric interpretation.</strong> This parameter is not passed to
any transform program registered under exit point QIBM_QIMG_TRANSFORMS. The
interpretation of the pixel data contained in the input image or print data
stream.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Photometric interpretation is determined from the input data
stream.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Monochrome where white is zero</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Monochrome where black is zero</td>
</tr>
</table>
<br>
<p><strong>Qualified job name.</strong> For format IMGI0200, the qualified job
name for the job that owns the spooled file.</p>
<p>The qualified job name has three parts:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>job name</em></td>
<td valign="top">CHAR(10). A specific job name, or one of the following special
values:
<table cellpadding="5">
<tr>
<td valign="top"><em><strong>*</strong></em></td>
<td valign="top">The job in which this program is running. The rest of the job
name parameter must be blank.</td>
</tr>
<tr>
<td valign="top"><em>*INT</em></td>
<td valign="top">The internal job identifier that is used to locate the spooled
file. The user name and job number must be set to blank.</td>
</tr>
</table>
<br>
</td>
</tr>
<tr>
<td valign="top"><em>user name</em></td>
<td valign="top">CHAR(10). A specific user profile name, or blanks when the job
name is * or *INT.</td>
</tr>
<tr>
<td valign="top"><em>job number</em></td>
<td valign="top">CHAR(6). A specific job number, or blanks when the job name is
* or *INT.</td>
</tr>
</table>
<br>
<p><strong>Reserved.</strong> Space reserved for future use. This field must be
set to hexadecimal zero(s).</p>
<p><strong>Resolution units.</strong> This parameter is not passed to any
transform program registered under exit point QIBM_QIMG_TRANSFORMS. The units
of measure for the horizontal and vertical resolution fields.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Resolution units are determined from the input data
stream.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">No resolution is given</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Inch</td>
</tr>
<tr>
<td valign="top"><em>3</em></td>
<td valign="top">Centimeter</td>
</tr>
</table>
<br>
<p><strong>Spooled file create
date.</strong> The date the spooled file was created on the system or blank
when the spooled file name is *INT. This field is considered after the job
name, user name, job number, spooled file name, spooled file number, and job
system name field requirements have been met.</p>
<p>The date must be in the CYYMMDD format or one of the following special
values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*ONLY</em></td>
<td valign="top">There is only one spooled file with the specified job name,
user name, job number, spooled file name, spooled file number, and job system
name.</td>
</tr>
<tr>
<td valign="top"><em>*LAST</em></td>
<td valign="top">The spooled file with the latest date and time which also has
the specified job name, user name, job number, spooled file name, spooled file
number, and job system name is used.</td>
</tr>
<tr>
<td valign="top"><em>date</em></td>
<td valign="top">The date the spooled file was created on the system in the
format CYYMMDD. See field Date file opened in API QUSRSPLA under field
descriptions for more information on the date format.</td>
</tr>
</table>
<br>
<p>When the Length field is less than 146 bytes, the API assumes blanks when
the spooled file name is *INT. When spooled file name is not *INT, the API
assumes *ONLY.</p>
<p><strong>Spooled file create time.</strong> The time the spooled file was
created on the system or blank when the spooled file name is *INT. This field
must be set to blanks when special values *LAST or *ONLY are used for field
Spooled file create date. This field must have a value set if a date is
specified for field Spooled file create date. This field is considered after
the job name, user name, job number, spooled file name, spooled file number,
job system name, and spooled file create date field requirements have been met.
The time must be in the HHMMSS format or one of the following special
values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*ONLY</em></td>
<td valign="top">There is only one spooled file with the specified job name,
user name, job number, spooled file name, spooled file number, job system name,
and spooled file create date.</td>
</tr>
<tr>
<td valign="top"><em>*LAST</em></td>
<td valign="top">&gt;The spooled file with the latest time which also has the
specified job name, user name, job number, spooled file name, spooled file
number, job system name, and spooled file create date is used.</td>
</tr>
<tr>
<td valign="top"><em>time</em></td>
<td valign="top">The time the spooled file was created on the system in the
format HHMMSS. See field Time file opened in API QUSRSPLA under field
descriptions for more information on the time format.</td>
</tr>
<tr>
<td valign="top"><em>blanks</em></td>
<td valign="top">This field must be set to blanks if the spooled file create
date field is set to *LAST or *ONLY.</td>
</tr>
</table>
<br>
<p>When the Length field is less than 146 bytes, the API assumes blanks for
this field.</p>
<p><strong>Spooled file name.</strong> For format IMGI0200, the spooled file
name. The special value *INT means that the internal spooled file identifier is
used.</p>
<p><strong>Spooled file number.</strong> For format IMGI0200, the spooled file
number. When the spooled file name is given (that is, not *INT), this uniquely
identifies the spooled file if the job has multiple spooled files with the same
name.</p>
<p>The following special values are allowed:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Use the only spooled value with the specified name.</td>
</tr>
<tr>
<td valign="top"><em>-1</em></td>
<td valign="top">Use the highest-numbered spooled file with the specified
spooled file name.</td>
</tr>
<tr>
<td valign="top"><em>-2</em></td>
<td valign="top">The spooled file number is not used to determine which spooled
file to process. Use this value when you want the Job system name field or the
Spooled file create date and Spooled file create time fields to take precedence
over the spooled file number when selecting a spooled file.</td>
</tr>
</table>
<br>
<p><strong>Vertical resolution.</strong> This parameter is not passed to any
transform program registered under exit point QIBM_QIMG_TRANSFORMS.</p>
<p>The number of vertical pixels per resolution unit, or the following special
value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Resolution determined from the input data stream.</td>
</tr>
</table>
<br>
<h3><a name="HDRCVIP4">Output Image Structure Format</a></h3>
<p>The output image structure describes the output image or print data
stream.</p>
<p>The different formats specify the destination of the converted image or
print data stream: file, spooled file, or main storage. The formats contain
many common fields that specify attributes of the output image or print data
stream:</p>
<ul>
<li>Data stream format</li>
<li>Photometric interpretation</li>
<li>Resolution units</li>
<li>Horizontal and vertical resolutions</li>
<li>Size units</li>
<li>Horizontal and vertical sizes</li>
<li>Compression type and quality</li>
<li>Paper size</li>
<li>User paper size units</li>
<li>Horizontal and vertical user paper sizes</li>
<li>Paper orientation</li>
<li>Left, right, top, and bottom unprintable borders</li>
</ul>
<p>These attribute values override any corresponding values present in the
destination image configuration object, if specified.</p>
<p>For multipage considerations regarding some fields in this structure, see <a
href="#HDRCVIMPG">Multipage Output</a>.</p>
<br>
<h4><a name="HDRCVIP4F1">IMGO0100 Format</a></h4>
<p>Use this format to store output in a stream file.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="30%">BINARY(4)</td>
<td align="left" valign="top" width="50%">Length</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Destination image configuration</td>
</tr>
<tr>
<td align="center" valign="top">22</td>
<td align="center" valign="top">16</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">
Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Data stream format</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Photometric interpretation</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resolution units</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Horizontal resolution</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Vertical resolution</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Size units</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Horizontal size</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Vertical size</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Compression type</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Compression quality</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bits per sample</td>
</tr>
<tr>
<td align="center" valign="top">84</td>
<td align="center" valign="top">54</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Paper size</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">User paper size units</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Horizontal user paper size</td>
</tr>
<tr>
<td align="center" valign="top">100</td>
<td align="center" valign="top">64</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Vertical user paper size</td>
</tr>
<tr>
<td align="center" valign="top">108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Paper orientation</td>
</tr>
<tr>
<td align="center" valign="top">112</td>
<td align="center" valign="top">70</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Left unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">116</td>
<td align="center" valign="top">74</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Right unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">120</td>
<td align="center" valign="top">78</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Top unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">124</td>
<td align="center" valign="top">7C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bottom unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">128</td>
<td align="center" valign="top">80</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Output object type</td>
</tr>
<tr>
<td align="center" valign="top">132</td>
<td align="center" valign="top">84</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to output object name</td>
</tr>
<tr>
<td align="center" valign="top">136</td>
<td align="center" valign="top">88</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of output object name</td>
</tr>
<tr>
<td align="center" valign="top">140</td>
<td align="center" valign="top">8C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">144</td>
<td align="center" valign="top">90</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Output object name</td>
</tr>
</table>
<br>
<h4><a name="HDRCVIP4F2">IMGO0200 Format</a></h4>
<p>Use this format to store output in a spooled file.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="30%">BINARY(4)</td>
<td align="left" valign="top" width="50%">Length</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Destination image configuration</td>
</tr>
<tr>
<td align="center" valign="top">22</td>
<td align="center" valign="top">16</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">
Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Data stream format</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Photometric interpretation</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resolution units</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Horizontal resolution</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Vertical resolution</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Size units</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Horizontal size</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Vertical size</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Compression type</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Compression quality</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bits per sample</td>
</tr>
<tr>
<td align="center" valign="top">84</td>
<td align="center" valign="top">54</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Paper size</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">User paper size units</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Horizontal user paper size</td>
</tr>
<tr>
<td align="center" valign="top">100</td>
<td align="center" valign="top">64</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Vertical user paper size</td>
</tr>
<tr>
<td align="center" valign="top">108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Paper orientation</td>
</tr>
<tr>
<td align="center" valign="top">112</td>
<td align="center" valign="top">70</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Left unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">116</td>
<td align="center" valign="top">74</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Right unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">120</td>
<td align="center" valign="top">78</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Top unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">124</td>
<td align="center" valign="top">7C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bottom unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">128</td>
<td align="center" valign="top">80</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output device</td>
</tr>
<tr>
<td align="center" valign="top">138</td>
<td align="center" valign="top">8A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue</td>
</tr>
<tr>
<td align="center" valign="top">148</td>
<td align="center" valign="top">94</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue library name</td>
</tr>
<tr>
<td align="center" valign="top">158</td>
<td align="center" valign="top">9E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Printer file</td>
</tr>
<tr>
<td align="center" valign="top">168</td>
<td align="center" valign="top">A8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Printer file library name</td>
</tr>
<tr>
<td align="center" valign="top">178</td>
<td align="center" valign="top">B2</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User data</td>
</tr>
<tr>
<td align="center" valign="top">188</td>
<td align="center" valign="top">BC</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Copies</td>
</tr>
<tr>
<td align="center" valign="top">192</td>
<td align="center" valign="top">C0</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Save</td>
</tr>
<tr>
<td align="center" valign="top">196</td>
<td align="center" valign="top">C4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Request spooled feedback</td>
</tr>
</table>
<br>
<h4><a name="HDRCVIP4F3">IMGO0300 Format</a></h4>
<p>Use this format to store output in main storage. See <a href="#SPTCVIP5P">
main storage output image parameter</a>.</p>
<p><strong>Note:</strong> This format is not allowed for multipage output.
Refer to <a href="#HDRCVIMPG">Multipage Output</a> for details.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="30%">BINARY(4)</td>
<td align="left" valign="top" width="50%">Length</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Destination image configuration</td>
</tr>
<tr>
<td align="center" valign="top">22</td>
<td align="center" valign="top">16</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">
Reserved</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Data stream format</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Photometric interpretation</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resolution units</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Horizontal resolution</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Vertical resolution</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Size units</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Horizontal size</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Vertical size</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Compression type</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Compression quality</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bits per sample</td>
</tr>
<tr>
<td align="center" valign="top">84</td>
<td align="center" valign="top">54</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Paper size</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">User paper size units</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Horizontal user paper size</td>
</tr>
<tr>
<td align="center" valign="top">100</td>
<td align="center" valign="top">64</td>
<td align="left" valign="top">PACKED(15,5)</td>
<td align="left" valign="top">Vertical user paper size</td>
</tr>
<tr>
<td align="center" valign="top">108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Paper orientation</td>
</tr>
<tr>
<td align="center" valign="top">112</td>
<td align="center" valign="top">70</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Left unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">116</td>
<td align="center" valign="top">74</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Right unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">120</td>
<td align="center" valign="top">78</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Top unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">124</td>
<td align="center" valign="top">7C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bottom unprintable border</td>
</tr>
<tr>
<td align="center" valign="top">128</td>
<td align="center" valign="top">80</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Space provided</td>
</tr>
</table>
<br>
<h4><a name="HDROIFD">Field Descriptions</a></h4>
<p><strong>Bits per sample.</strong> This parameter is not passed to any
transform program registered under exit point QIBM_QIMG_TRANSFORMS. The number
of bits per image sample.</p>
<p>The following values are allowed:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">One bit per sample</td>
</tr>
<tr>
<td valign="top"><em>8</em></td>
<td valign="top">Eight bits per sample</td>
</tr>
</table>
<br>
<p><strong>Bottom unprintable border.</strong> The number of pixels of
unprintable area on the bottom border, or the following special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>-1</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
</table>
<br>
<p><strong>Compression quality.</strong> This field is not used and must be set
to 0.</p>
<p><strong>Compression type.</strong> The algorithm used to compress the output
image or print data stream.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">No compression</td>
</tr>
<tr>
<td valign="top"><em>4</em></td>
<td valign="top">CCITT Group 4 Fax</td>
</tr>
<tr>
<td valign="top"><em>7</em></td>
<td valign="top">PackBits</td>
</tr>
<tr>
<td valign="top"><em>8</em></td>
<td valign="top">IBM MMR (modified-modified read)</td>
</tr>
</table>
<br>
<p><strong>Copies.</strong> For format IMGO0200, the number of copies to
produce when the spooled file is printed. The valid values for the number of
copies are 1 through 255, or the special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Use the copies value from the printer file.</td>
</tr>
</table>
<br>
<p><strong>Data stream format.</strong> The format of the output data
stream.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"><em>20</em></td>
<td valign="top">AFPDS (Advanced Function Printing data stream)</td>
</tr>
<tr>
<td valign="top"><em>22</em></td>
<td valign="top">PCL (Printer Control Language)</td>
</tr>
<tr>
<td valign="top"><em>23</em></td>
<td valign="top">PostScript Level 1</td>
</tr>
<tr>
<td valign="top"><em>99</em></td>
<td valign="top">Unknown (Output data stream format unknown)</td>
</tr>
</table>
<br>
<p><strong>Destination image configuration.</strong> The value for the image
configuration object that contains fields describing the output device and data
stream. The string must be filled with blanks. See <a href="#HDRCVICFGR">Values
of Destination Image Configuration</a> for a complete list of available image
configuration objects.</p>
<p>Field values from this image configuration will be substituted for the
values of other fields in this structure, whenever the special value *IMGCFG is
used for a field.</p>
<p>The following special values are also allowed:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*DEV</em></td>
<td valign="top">The image configuration for the output device is used. This
special value is allowed only for format IMGO0200.</td>
</tr>
<tr>
<td valign="top"><em>*NONE</em></td>
<td valign="top">No image configuration is specified. Other fields cannot
specify that the value from the destination image configuration object be
used.</td>
</tr>
<tr>
<td valign="top"></td>
<td valign="top"><strong>Note:</strong> *DEV is the recommended value for this
field. The destination image configuration and any fields in the output image
structure will override the values in the image configuration for the output
printer device. Later, if the spooled file is changed to another output queue
or another printer, these fields will still be in effect and may cause errors.
If this is undesirable, configure the printer with another image
configuration.</td>
</tr>
</table>
<br>
<p><strong>Format.</strong> The format identifier of the output image
structure, determined by the type of output.</p>
<p>The following formats are defined:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>IMGO0100</em></td>
<td valign="top">Output is to a stream file.</td>
</tr>
<tr>
<td valign="top"><em>IMGO0200</em></td>
<td valign="top">Output is to a spooled file.</td>
</tr>
<tr>
<td valign="top"><em>IMGO0300</em></td>
<td valign="top">Output is to main storage.</td>
</tr>
</table>
<br>
<p><strong>Horizontal resolution.</strong> The number of horizontal pixels per
resolution unit, or the following special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
</table>
<br>
<p><strong>Horizontal size.</strong> This parameter is not passed to any
transform program registered under exit point QIBM_QIMG_TRANSFORMS. The size of
the image in the horizontal direction, in size units. This is used to determine
the size of the output image. If the stretch field in the control structure
parameter is no, the aspect ratio is maintained such that the image fits within
the specified size. That is, if the vertical direction determines the scale
factor, the actual horizontal size may be smaller than specified. If the size
units field is -2 (paper size), this field must be zero.</p>
<p>The following special value is allowed:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"></td>
<td valign="top"><strong>Note:</strong> This field has no effect for PostScript
input data streams.</td>
</tr>
<tr>
<td valign="top"></td>
<td valign="top"><strong>Note:</strong> Output image size is determined by
manipulating horizontal and vertical resolutions, not by changing the number of
output pixels. Because resolution often depends on printer device capabilities,
some sizing may not be possible.</td>
</tr>
</table>
<br>
<p><strong>Horizontal user paper size.</strong> The size of the paper in the
horizontal direction, in user paper size units. This field must be set to zero
unless the value of the paper size field is -1 (user paper size).</p>
<p><strong>Left unprintable border.</strong> The number of pixels of
unprintable area on the left border, or the following special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>-1</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
</table>
<p> <strong>Length.</strong> The length of the structure, which varies
depending on the format specified.</p>
<p>When the operation field in the control structure format specifies the end
option, this field must be set to 4.</p>
<p>For format IMGO0100, the length must be 144 plus the length of the output
object name.</p>
<p>For format IMGO0200, the length must be 200.</p>
<p>For format IMGO0300, the length must be 132.</p>
<p><strong>Length of output object name.</strong> For format IMGO0100, the
length of the output object name.</p>
<p><strong>Offset to output object name.</strong> For format IMGO0100, the
offset in bytes from the start of the output image structure to the input
object name. This value must be 144.</p>
<p><strong>Output device.</strong> For format IMGO0200, the name of the output
device. This field is used to get the default device characteristics if a
destination image configuration is not given. If the output queue is configured
with a remote location, any device attributes will be retrieved on the output
queue.</p>
<p>The following special values are allowed:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*NONE</em></td>
<td valign="top">No output device is specified. Either an output queue with a
remote location is specified or the destination image configuration is
specified explicitly.</td>
</tr>
<tr>
<td valign="top"><em>*JOB</em></td>
<td valign="top">The output device is taken from the current job.</td>
</tr>
<tr>
<td valign="top"><em>*USRPRF</em></td>
<td valign="top">The output device is taken from the user profile of the
current job.</td>
</tr>
<tr>
<td valign="top"><em>*SYSVAL</em></td>
<td valign="top">The default output device from the QPRTDEV system value is
used.</td>
</tr>
<tr>
<td valign="top"><em>*WRKSTN</em></td>
<td valign="top">The output device is taken from the work station device
description of the current job. If the current job is not interactive, this
value is ignored and processing continues as if *SYSVAL were specified.</td>
</tr>
</table>
<br>
<p><strong>Output object name.</strong> For format IMGO0100, the output object
name. For stream file object type, this is the full name of the output stream
file, including path.</p>
<p><strong>Output object type.</strong> For format IMGO0100, the type of the
output object name.</p>
<p>The possible value follows:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Stream file</td>
</tr>
</table>
<br>
<p><strong>Output queue.</strong> For format IMGO0200, the name of the output
queue. The first 10 characters contain the output queue and the second 10
characters contain the name of the library in which the output queue resides.
For AFPDS output, only valid device output queues are allowed.</p>
<p>The following special values are allowed:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*DEV</em></td>
<td valign="top">The device output queue in QUSRSYS is used, after defaults for
the device are resolved. Once the device is determined, its output queue will
be used.</td>
</tr>
<tr>
<td valign="top"><em>*JOB</em></td>
<td valign="top">The output queue is retrieved from the current job.</td>
</tr>
<tr>
<td valign="top"><em>*PRTF</em></td>
<td valign="top">The output queue is retrieved from the printer file.</td>
</tr>
<tr>
<td valign="top"><em>*USRPRF</em></td>
<td valign="top">The output queue is retrieved from the user profile of the
current job.</td>
</tr>
<tr>
<td valign="top"><em>*WRKSTN</em></td>
<td valign="top">The output queue is retrieved from the work station device
description of the current job. If the current job is not interactive, this
value is ignored and processing continues as if *DEV were specified.</td>
</tr>
</table>
<br>
<p><strong>Output queue library name.</strong> The name of the library that
contains the output queue.</p>
<p>The following special values are supported for the library name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*LIBL</em></td>
<td valign="top">The library list is used to locate the output queue.</td>
</tr>
<tr>
<td valign="top"><em>*CURLIB</em></td>
<td valign="top">The current library for the job is used to locate the output
queue.</td>
</tr>
</table>
<br>
<p><strong>Paper orientation.</strong> How the output is oriented on paper.</p>
<p>Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>-1</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">Best fit. Portrait will be used unless the input image is
wider than it is tall. This value is the same as portrait for PostScript input
data streams.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Portrait. For image input files, the top of each output page
is placed on the narrowest dimension of the paper. For PostScript input data
streams, the orientation specified in the input data stream is used.</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Landscape. For image input files, the top of each output page
is placed on the widest dimension of the paper. For PostScript input data
streams, the output is rotated 90 degrees from the orientation specified in the
input data stream.</td>
</tr>
<tr>
<td valign="top"><em>3</em></td>
<td valign="top">Portrait, rotated 180 degrees. For PostScript input data
streams, the output is rotated 180 degrees from the orientation specified in
the input data stream.</td>
</tr>
<tr>
<td valign="top"><em>4</em></td>
<td valign="top">Landscape, rotated 180 degrees. For PostScript input data
streams, the output is rotated 270 degrees from the orientation specified in
the input data stream.</td>
</tr>
</table>
<br>
<p><strong>Paper size.</strong> The paper size to be used for the output image
or print data stream. See the table following the values for dimensions of each
size value.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top">-1</td>
<td valign="top">The value is specified in the user paper size field.</td>
</tr>
<tr>
<td valign="top">0</td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top">1</td>
<td valign="top">Executive</td>
</tr>
<tr>
<td valign="top">2</td>
<td valign="top">Letter</td>
</tr>
<tr>
<td valign="top">3</td>
<td valign="top">Legal</td>
</tr>
<tr>
<td valign="top">6</td>
<td valign="top">Ledger</td>
</tr>
<tr>
<td valign="top">13</td>
<td valign="top">A5</td>
</tr>
<tr>
<td valign="top">26</td>
<td valign="top">A4</td>
</tr>
<tr>
<td valign="top">27</td>
<td valign="top">A3</td>
</tr>
<tr>
<td valign="top">45</td>
<td valign="top">B5</td>
</tr>
<tr>
<td valign="top">46</td>
<td valign="top">B4</td>
</tr>
<tr>
<td valign="top">50</td>
<td valign="top">CONT80</td>
</tr>
<tr>
<td valign="top">51</td>
<td valign="top">CONT132</td>
</tr>
<tr>
<td valign="top">80</td>
<td valign="top">Monarch envelope</td>
</tr>
<tr>
<td valign="top">81</td>
<td valign="top">COMM10 envelope</td>
</tr>
<tr>
<td valign="top">89</td>
<td valign="top">COMM9 envelope</td>
</tr>
<tr>
<td valign="top">90</td>
<td valign="top">DL envelope</td>
</tr>
<tr>
<td valign="top">91</td>
<td valign="top">C5 envelope</td>
</tr>
<tr>
<td valign="top">100</td>
<td valign="top">B5 envelope</td>
</tr>
</table>
<br>
<br>
<table border cellpadding="5">
<!-- cols="30 35 35" -->
<tr>
<th align="left" valign="top">Name</th>
<th align="left" valign="top">Millimeters</th>
<th align="left" valign="top">Inches</th>
</tr>
<tr>
<td align="left" valign="top" colspan="3">Paper:</td>
</tr>
<tr>
<td align="left" valign="top">Letter</td>
<td align="left" valign="top">215.9 x 279.4</td>
<td align="left" valign="top">8.5 x 11</td>
</tr>
<tr>
<td align="left" valign="top">Legal</td>
<td align="left" valign="top">215.9 x 355.6</td>
<td align="left" valign="top">8.5 x 14</td>
</tr>
<tr>
<td align="left" valign="top" colspan="3">Ledger</td>
</tr>
<tr>
<td align="left" valign="top">Executive</td>
<td align="left" valign="top">184.2 x 266.7</td>
<td align="left" valign="top">7.25 x 10.5</td>
</tr>
<tr>
<td align="left" valign="top" colspan="3">A3</td>
</tr>
<tr>
<td align="left" valign="top">A4</td>
<td align="left" valign="top">210 x 297</td>
<td align="left" valign="top">8.27 x 11.7</td>
</tr>
<tr>
<td align="left" valign="top">A5</td>
<td align="left" valign="top">148 x 210</td>
<td align="left" valign="top">5.83 x 8.27</td>
</tr>
<tr>
<td align="left" valign="top" colspan="3">B4</td>
</tr>
<tr>
<td align="left" valign="top">B5</td>
<td align="left" valign="top">182 x 257</td>
<td align="left" valign="top">7.17 x 10.1</td>
</tr>
<tr>
<td align="left" valign="top">CONT80</td>
<td align="left" valign="top">203.2 x 279.4</td>
<td align="left" valign="top">8 x 11</td>
</tr>
<tr>
<td align="left" valign="top">CONT132</td>
<td align="left" valign="top">335.3 x 279.4</td>
<td align="left" valign="top">13.2 x 11</td>
</tr>
<tr>
<td align="left" valign="top" colspan="3">Envelope:</td>
</tr>
<tr>
<td align="left" valign="top">Monarch</td>
<td align="left" valign="top">98.4 x 190.5</td>
<td align="left" valign="top">3.875 x 7.5</td>
</tr>
<tr>
<td align="left" valign="top">Commercial 9</td>
<td align="left" valign="top">98.4 x 225.4</td>
<td align="left" valign="top">3.875 x 8.875</td>
</tr>
<tr>
<td align="left" valign="top">Commercial 10</td>
<td align="left" valign="top">104.8 x 241.3</td>
<td align="left" valign="top">4.125 x 9.5</td>
</tr>
<tr>
<td align="left" valign="top">DL</td>
<td align="left" valign="top">110 x 220</td>
<td align="left" valign="top">4.33 x 8.66</td>
</tr>
<tr>
<td align="left" valign="top">B5</td>
<td align="left" valign="top">176 x 250</td>
<td align="left" valign="top">6.93 x 9.84</td>
</tr>
<tr>
<td align="left" valign="top">C5</td>
<td align="left" valign="top">162 x 229</td>
<td align="left" valign="top">6.38 x 9.02</td>
</tr>
</table>
<br>
<p><strong>Photometric interpretation.</strong> This parameter is not passed to
any transform program registered under exit point QIBM_QIMG_TRANSFORMS. The
interpretation of the pixel data that is contained in the output image or print
data stream.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Monochrome where white is zero</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Monochrome where black is zero</td>
</tr>
<tr>
<td valign="top"><em>3</em></td>
<td valign="top">RGB (red, green, blue) color</td>
</tr>
</table>
<br>
<p><strong>Printer file.</strong> For format IMGO0200, the name of a printer
file.</p>
<p>An IBM supplied printer file, such as QSYSPRT in library QSYS, may be used
if desired.</p>
<p><strong>Printer file library name.</strong> The name of the library that
contains the printer file.</p>
<p>The following special values are supported for the library name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*LIBL</em></td>
<td valign="top">The library list is used to locate the output queue.</td>
</tr>
<tr>
<td valign="top"><em>*CURLIB</em></td>
<td valign="top">The current library for the job is used to locate the output
queue.</td>
</tr>
</table>
<br>
<p><strong>Request spooled feedback.</strong> For format IMGO0200, whether
spooled file identification feedback is requested. See <a href="#HDRCVIP6">
Feedback Structure Format</a> for details about the information returned. The
information is returned only when it is requested using this field.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">No</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Yes</td>
</tr>
</table>
<br>
<p><strong>Reserved.</strong> Space reserved for future use. This field must be
set to hexadecimal zero(s).</p>
<p><strong>Resolution units.</strong> This parameter is not passed to any
transform program registered under exit point QIBM_QIMG_TRANSFORMS. The units
of measure of the horizontal and vertical resolution fields.</p>
<p>Possible values follow:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Inch</td>
</tr>
<tr>
<td valign="top"><em>3</em></td>
<td valign="top">Centimeter</td>
</tr>
</table>
<br>
<p><strong>Right unprintable border.</strong> The number of pixels of
unprintable area on the right border, or the following special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>-1</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
</table>
<br>
<p><strong>Save.</strong> For format IMGO0200, whether the spooled file will be
saved on the output queue after printing.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value from the printer file is used.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">No</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Yes</td>
</tr>
</table>
<br>
<p><strong>Size units.</strong> This parameter is not passed to any transform
program registered under exit point QIBM_QIMG_TRANSFORMS. The units of measure
of the horizontal and vertical size fields.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>-2</em></td>
<td valign="top">The value from the paper size fields is used and the
horizontal size and vertical size fields must be zero.</td>
</tr>
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"><em>1</em></td>
<td valign="top">Pixel</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Inch</td>
</tr>
<tr>
<td valign="top"><em>3</em></td>
<td valign="top">Centimeter</td>
</tr>
</table>
<br>
<p><strong>Space provided.</strong> For format IMGO0300, the number of bytes of
main storage provided for the output data stream in the <a href="#SPTCVIP5P">
main storage output image parameter</a>. If the converted data stream will not
fit within the space provided, an error condition is returned.</p>
<p><strong>Top unprintable border.</strong> The number of pixels of unprintable
area on the top border, or the following special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>-1</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
</table>
<br>
<p><strong>User data.</strong> For format IMGO0200, up to 10 characters of
information to be displayed on the WRKSPLF screen.</p>
<p>The following special value is allowed:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><em>*INOBJ</em></td>
<td valign="top">The characters will be determined from the input object.
<p>If the input is from a stream file, the first 10 characters of the filename
(after the last slash in the path, if any) are used.</p>
</td>
</tr>
<tr>
<td valign="top"></td>
<td valign="top">If the input is from a spooled file, the spooled file name is
used.</td>
</tr>
<tr>
<td valign="top"></td>
<td valign="top">If the input is from main storage, the value is blank.</td>
</tr>
</table>
<br>
<p><strong>User paper size units.</strong> This parameter is not passed to any
transform program registered under exit point QIBM_QIMG_TRANSFORMS. The units
of measure of the horizontal and vertical user paper size fields. This field
must be zero unless the value of the paper size field is -1 (user paper
size).</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"><em>2</em></td>
<td valign="top">Inch</td>
</tr>
<tr>
<td valign="top"><em>4</em></td>
<td valign="top">Millimeter</td>
</tr>
</table>
<br>
<p><strong>Vertical resolution.</strong> The number of vertical pixels per
resolution unit, or the following special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
</table>
<br>
<p><strong>Vertical size.</strong> This parameter is not passed to any
transform program registered under exit point QIBM_QIMG_TRANSFORMS. The size of
the image in the vertical direction, in size units. This is used to determine
the size of the output image. If the stretch field in the control structure
parameter is no, the aspect ratio is maintained such that the image fits within
the specified size. That is, if the horizontal direction determines the scale
factor, the actual vertical size may be smaller than specified. If the size
units field is -2 (paper size), this field must be zero.</p>
<p>The following special value is allowed:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The value in the destination image configuration object is
used.</td>
</tr>
<tr>
<td valign="top"></td>
<td valign="top"><strong>Note:</strong> This field has no effect for PostScript
input data streams.</td>
</tr>
<tr>
<td valign="top"></td>
<td valign="top"><strong>Note:</strong> Output image size is determined by
manipulating horizontal and vertical resolutions, not by changing the number of
output pixels. Because resolution often depends on printer device capabilities,
some sizing may not be possible.</td>
</tr>
</table>
<br>
<p><strong>Vertical user paper size.</strong> The size of the paper in the
vertical direction, in user paper size units. This field must be set to zero
unless the value of paper size is -1 (user paper size).</p>
<br>
<h3><a name="HDRCVIP6">Feedback Structure Format</a></h3>
<p>The feedback structure returns additional output information from the API,
such as a spooled file identifier, size of main storage output, or a handle for
future API calls for multipage output.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="30%">CHAR(32)</td>
<td align="left" valign="top" width="50%">Handle for multipage output</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Spooled file name</td>
</tr>
<tr>
<td align="center" valign="top">42</td>
<td align="center" valign="top">2A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job name</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job user name</td>
</tr>
<tr>
<td align="center" valign="top">62</td>
<td align="center" valign="top">3E</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Job number</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Spooled file number</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internal job identifier</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internal spooled file identifier</td>
</tr>
<tr>
<td align="center" valign="top">104</td>
<td align="center" valign="top">68</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Output data stream length</td>
</tr>
<tr>
<td align="center" valign="top">
108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Job system name</td>
</tr>
<tr>
<td align="center" valign="top">116</td>
<td align="center" valign="top">74</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Spooled file create date</td>
</tr>
<tr>
<td align="center" valign="top">123</td>
<td align="center" valign="top">7B</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">124</td>
<td align="center" valign="top">7C</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Spooled file create time</td>
</tr>
</table>
<br>
<p>This structure contains output data that is returned for any of the
following conditions:</p>
<ul>
<li>The operation field in the control structure specifies first.
<p>The handle for multipage output is returned. This returned handle is
required as input in the control structure on subsequent API calls where
append, last, or end is specified for the operation field.</p>
</li>
<li>The request spooled feedback field in the output image structure specifies
yes.
<p>Spooled file information is returned, if requested, when a spooled file is
created by the conversion.</p>
</li>
<li>The output image structure format parameter uses format IMGO0300.
<p>The length of the output data stream is returned. This is the length of the
data stream stored in the main storage output image parameter.</p>
</li>
</ul>
<br>
<h3><a name="HDRIOFD">Field Descriptions</a></h3>
<p><strong>Handle for multipage output.</strong> When first is specified for
the operation field in the control structure format, this field is returned.
For all other values of the operation field, this field is set to hexadecimal
zeros.</p>
<p><strong>Internal job identifier.</strong> When spooled feedback is
requested, the internal identifier of the job that is creating the spooled file
(the job in which this API is called).</p>
<p><strong>Internal spooled file identifier.</strong> When spooled feedback is
requested, the internal identifier of the created spooled file.</p>
<p><strong>Job name.</strong> When spooled feedback is requested, the name of
the job that owns the spooled file (the job in which this API is
called).</p>
<p><strong>Job number.</strong> When spooled feedback is requested, the number
of the job that owns the spooled file (the job in which this API is
called).</p>
<p><strong>Job system
name.</strong> The name of the system where the job that created the spooled
file ran (the job in which this API is called).</p>
<p><strong>Job user name.</strong> When spooled feedback is requested, the user
name of the job that generated the spooled file (the job in which this API is
called).</p>
<p><strong>Output data stream length.</strong> When the format field in the
output image structure is IMGO0300, this field contains the length of the
output data stream in main storage. This is the length of the data stream that
is stored in the main storage output image.</p>
<p><strong>Spooled file create
date.</strong> When spooled feedback is requested, the date the spooled file
was created on the system in the format CYYMMDD. See field Date file opened in
API QUSRSPLA under field descriptions for more information on the date
format.</p>
<p><strong>Spooled file create time.</strong> When spooled feedback is
requested, the time the spooled file was created on the system in the format
HHMMSS. See field Time file opened in API QUSRSPLA under field descriptions for
more information on the time format.</p>
<p><strong>Spooled file name.</strong> When spooled feedback is requested, the
name of the created spooled file.</p>
<p><strong>Spooled file number.</strong> When spooled feedback is requested,
the number of the created spooled file.</p>
<br>
<h3><a name="HDRCVIMPG">Multipage Output</a></h3>
<p>For the operation field in the control structure, the first, append, last,
and end options are related. These are used to iteratively call the API with
multiple input data streams, while producing a single output data stream. The
output data stream format, specified on the first call, must be AFPDS (Advanced
Function Printing data stream), PostScript, or PCL (Printer Control Language).
Calls that use these options must all be done in the same job, and must follow
a prescribed sequence:</p>
<ol>
<li>A single first call</li>
<li>Any number of append calls</li>
<li>A single last or end call</li>
</ol>
<p>After a first call, only append, last, or end calls are allowed until the
sequence is finished by a last or end call. For example, an immediate call
following a first call is not allowed.</p>
<p>The end option is like the last option in that it ends the sequence of
calls. However, no input data stream processing is done when end is specified;
therefore, no new pages are added to the output data stream.</p>
<p>Parameter rules are defined for multipage output, which are summarized in the <a
href="#TBLMULTPG">Parameters for Multipage Output</a> table below. In particular:</p>
<ol>
<li>When the first option is specified, a handle is returned in the feedback
structure. This handle must be specified in the control structure on all
subsequent API calls that specify the append, last, and end options.</li>
<li><a name="LIMPGP4RL"></a>When the append or last options are specified, the
following field values in the output image structure are ignored. These fields
are as follows:
<ul>
<li>Length</li>
<li>Format</li>
<li>Destination image configuration</li>
<li>Data stream format</li>
<li>Paper size</li>
<li>User paper size units</li>
<li>Horizontal user paper size</li>
<li>Vertical user paper size</li>
<li>Output object type (format IMGO0100)</li>
<li>Length of output object name (format IMGO0100)</li>
<li>Output object name (format IMGO0100)</li>
<li>Output device (format IMGO0200)</li>
<li>Output queue (format IMGO0200)</li>
<li>Printer file (format IMGO0200)</li>
<li>User data (format IMGO0200)</li>
<li>Copies (format IMGO0200)</li>
<li>Save (format IMGO0200)</li>
<li>Request spooled feedback (format IMGO0200)</li>
</ul>
<p>If one of these field values changes, the value from the first call is
used.</p>
</li>
<li>When the end option is specified, the length field in both the input image
structure and the output image structure must be set to 4, and the length field
in the control structure must be set to 52. Again, this is because no other
information is accepted in these parameters.</li>
</ol>
<br>
<p><strong><a name="TBLMULTPG">Parameters for Multipage Output</a></strong></p>
<table border cellpadding="5">
<!-- cols="20 20 20 20 20" -->
<tr>
<th align="center" valign="top">Parameter No.</th>
<th align="left" valign="top">First</th>
<th align="left" valign="top">Append</th>
<th align="left" valign="top">Last</th>
<th align="left" valign="top">End</th>
</tr>
<tr>
<td align="center" valign="top">1</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">LEN=52</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">LEN=4</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">N/A</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">LEN=4</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">N/A</td>
<td align="left" valign="top">N/A</td>
<td align="left" valign="top">N/A</td>
<td align="left" valign="top">N/A</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">LEN=0</td>
<td align="left" valign="top">LEN=0</td>
<td align="left" valign="top">LEN=0</td>
</tr>
<tr>
<td align="center" valign="top">7</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
<td align="left" valign="top">REQ</td>
</tr>
</table>
<p><strong>Legend:</strong></p>
<table width="100%" cellpadding="5">
<tr>
<td width="15%" valign="top"><em>REQ</em></td>
<td width="85%" valign="top">Required</td>
</tr>
<tr>
<td valign="top"><em>OPT</em></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><em>LEN=n</em></td>
<td valign="top">Length of structure must be n</td>
</tr>
<tr>
<td valign="top"><em>N/A</em></td>
<td valign="top">Not applicable (ignored)</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRCVICRF">Color Reduction Field</a></h3>
<p>The color reduction field of the control structure determines the
characteristics of the output data stream according to the following table. In
this table, the input image type is the type of the actual input image file.
The output image type is the type of the data that is printed or stored in a
file. The destination image type is the type of output file that is described
in the output image structure, determined by the two fields, photometric
interpretation and bits per sample. A -- (dash) means that the value does not
affect the result for that combination.</p>
<br>
<table border cellpadding="5">
<tr>
<th align="left" valign="bottom" rowspan="2">Input Image Type</th>
<th align="left" valign="bottom" colspan="3">Destination</th>
<th align="left" valign="bottom" rowspan="2">Color Reduction</th>
<th align="left" valign="bottom" rowspan="2">Output Image Type</th>
</tr>
<tr>
<th align="left" valign="bottom">Image Type</th>
<th align="left" valign="bottom">Photometric Interpretation</th>
<th align="left" valign="bottom">Bits per Sample</th>
</tr>
<tr>
<td align="left" valign="bottom" width="20%">Black and White</td>
<td align="left" valign="bottom" width="15%">-</td>
<td align="left" valign="bottom" width="15%">-</td>
<td align="left" valign="bottom" width="15%">-</td>
<td align="left" valign="bottom" width="15%">-</td>
<td align="left" valign="bottom" width="20%">Black and White</td>
</tr>
<tr>
<td align="left" valign="bottom">-</td>
<td align="left" valign="bottom">Black and White</td>
<td align="left" valign="bottom">1 or 2</td>
<td align="left" valign="bottom">1</td>
<td align="left" valign="bottom">-</td>
<td align="left" valign="bottom">Black and White</td>
</tr>
<tr>
<td align="left" valign="bottom">-</td>
<td align="left" valign="bottom">-</td>
<td align="left" valign="bottom">-</td>
<td align="left" valign="bottom">-</td>
<td align="left" valign="bottom">Black and White</td>
<td align="left" valign="bottom">Black and White</td>
</tr>
<tr>
<td align="left" valign="bottom">Color</td>
<td align="left" valign="bottom">Color</td>
<td align="left" valign="bottom">3</td>
<td align="left" valign="bottom">8</td>
<td align="left" valign="bottom">Same</td>
<td align="left" valign="bottom">Color</td>
</tr>
<tr>
<td align="left" valign="bottom">Color</td>
<td align="left" valign="bottom">Color</td>
<td align="left" valign="bottom">3</td>
<td align="left" valign="bottom">8</td>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">Gray Scale</td>
</tr>
<tr>
<td align="left" valign="bottom">Color</td>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">1 or 2</td>
<td align="left" valign="bottom">8</td>
<td align="left" valign="bottom">Same</td>
<td align="left" valign="bottom">Gray Scale</td>
</tr>
<tr>
<td align="left" valign="bottom">Color</td>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">1 or 2</td>
<td align="left" valign="bottom">8</td>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">Gray Scale</td>
</tr>
<tr>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">Color</td>
<td align="left" valign="bottom">3</td>
<td align="left" valign="bottom">8</td>
<td align="left" valign="bottom">Same</td>
<td align="left" valign="bottom">Gray Scale</td>
</tr>
<tr>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">Color</td>
<td align="left" valign="bottom">3</td>
<td align="left" valign="bottom">8</td>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">Gray Scale</td>
</tr>
<tr>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">1 or 2</td>
<td align="left" valign="bottom">8</td>
<td align="left" valign="bottom">Same</td>
<td align="left" valign="bottom">Gray Scale</td>
</tr>
<tr>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">1 or 2</td>
<td align="left" valign="bottom">8</td>
<td align="left" valign="bottom">Gray Scale</td>
<td align="left" valign="bottom">Gray Scale</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRCVICFGR">Values of Destination Image Configuration</a></h3>
<p>The following special values are allowed for the destination image
configuration field of parameter 4. Each special value is described in terms of
the data streams supported, the maximum resolution in dots per inch (dpi), and
whether the printer has color or supports compression.</p>
<p>Printers supporting PCL data streams</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">PCL 300-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">PCL 600-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA03</strong></td>
<td valign="top">PCL 1200-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA04</strong></td>
<td valign="top">PCL 300-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA05</strong></td>
<td valign="top">PCL 600-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA06</strong></td>
<td valign="top">PCL 1200-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA07</strong></td>
<td valign="top">PCL 75-dpi printer (No compression)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA08</strong></td>
<td valign="top">PCL 600-dpi color printer with larger no-print border</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA09</strong></td>
<td valign="top">PCL 300-dpi printer (No compression)</td>
</tr>
</table>
<br>
<br>
<p>Printers supporting PostScript data streams</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><strong>*IMGB01</strong></td>
<td valign="top">PostScript 300-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB02</strong></td>
<td valign="top">PostScript 600-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB03</strong></td>
<td valign="top">PostScript 1200-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB04</strong></td>
<td valign="top">PostScript 300-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB05</strong></td>
<td valign="top">PostScript 600-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB06</strong></td>
<td valign="top">PostScript 1200-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB07</strong></td>
<td valign="top">PostScript 600x300-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB08</strong></td>
<td valign="top">PostScript 1200x300-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB09</strong></td>
<td valign="top">PostScript 360-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB10</strong></td>
<td valign="top">PostScript 720-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB11</strong></td>
<td valign="top">PostScript 1440x720-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB12</strong></td>
<td valign="top">PostScript 400-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB13</strong></td>
<td valign="top">PostScript 800-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB14</strong></td>
<td valign="top">PostScript 600-dpi color printer with larger no-print
border</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB15</strong></td>
<td valign="top">PostScript 300-dpi color printer with larger no-print
border</td>
</tr>
</table>
<br>
<br>
<p>Printers supporting IPDS data streams</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><strong>*IMGC01</strong></td>
<td valign="top">IPDS 240-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC02</strong></td>
<td valign="top">IPDS 300-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC03</strong></td>
<td valign="top">IPDS 600-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC04</strong></td>
<td valign="top">IPDS 1200-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC05</strong></td>
<td valign="top">IPDS 240-dpi printer with no-print border</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC06</strong></td>
<td valign="top">IPDS 300-dpi printer with no-print border</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC07</strong></td>
<td valign="top">IPDS 600-dpi printer with no-print border</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC08</strong></td>
<td valign="top">IPDS 1200-dpi printer with no-print border</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC09</strong></td>
<td valign="top">IPDS 240-dpi printer (IM/1 image)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC10</strong></td>
<td valign="top">IPDS 240-dpi printer (IM/1 image) with no-print border</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC11</strong></td>
<td valign="top">IPDS 240-dpi printer (CCITT G4)</td>
</tr>
</table>
<br>
<br>
<p>Printers supporting PCL and PostScript data streams</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><strong>*IMGD01</strong></td>
<td valign="top">PCL/PostScript 300-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">PCL/PostScript 600-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD03</strong></td>
<td valign="top">PCL/PostScript 1200-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD04</strong></td>
<td valign="top">PCL/PostScript 300-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD05</strong></td>
<td valign="top">PCL/PostScript 600-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD06</strong></td>
<td valign="top">PCL/PostScript 1200-dpi color printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD07</strong></td>
<td valign="top">PCL 300-dpi/PostScript 600-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD08</strong></td>
<td valign="top">PCL 300-dpi/PostScript 1200-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD09</strong></td>
<td valign="top">PCL 600-dpi/PostScript 300-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD10</strong></td>
<td valign="top">PCL 600-dpi/PostScript 1200-dpi printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD11</strong></td>
<td valign="top">PCL/PostScript 600-dpi color printer with larger no-print
border</td>
</tr>
</table>
<br>
<br>
<p>The recommended image configuration objects are listed below for some common
printers.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td valign="top"><strong>*IMGD01</strong></td>
<td valign="top">Compaq Pagemarc 20</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">Epson EPCL-4 Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">Epson EPCL-5 Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB10</strong></td>
<td valign="top">Epson Stylus Photo with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB11</strong></td>
<td valign="top">Epson Stylus Color 600, 800 with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA04</strong></td>
<td valign="top">HP Color LaserJet 5</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD04</strong></td>
<td valign="top">HP Color LaserJet 5M</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA04</strong></td>
<td valign="top">HP DeskJet 560C, 820C, 1200C</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">HP DeskJet 500, 600, 1200</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA04</strong></td>
<td valign="top">HP DeskJet 1600C, 1600CN</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD04</strong></td>
<td valign="top">HP DeskJet 1600CM</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA09</strong></td>
<td valign="top">HP LaserJet II, IID, IIP</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB01</strong></td>
<td valign="top">HP LaserJet II, IID, IIP with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">HP LaserJet III, IIID, IIISi, 4L</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD01</strong></td>
<td valign="top">HP LaserJet III, IIID, IIISi, 4L with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">HP LaserJet 4, 4P, 4V, 4Si, 4 Plus</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">HP LaserJet 4M, 4MP, 4MV, 4Si MX, 4M Plus</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">HP LaserJet 5, 5P, 5Si</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">HP LaserJet 5M, 5MP, 5Si MX</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">HP LaserJet 6, 6P, 6L</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">HP LaserJet 6M, 6MP</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">IBM 3112, 3116 Page Printer with IPDS feature</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">IBM 3112, 3116 Page Printer (ASCII/LAN)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">IBM 3112, 3116 Page Printer with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC01</strong></td>
<td valign="top">IBM 3130, 3160-1 AF Printer (240-pel mode)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC02</strong></td>
<td valign="top">IBM 3130 AF Printer (300-pel mode)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC09</strong></td>
<td valign="top">IBM 3825, 3827, 3828 AF Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC01</strong></td>
<td valign="top">IBM 3825, 3827, 3828 AF Printer (with AFIG)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC01</strong></td>
<td valign="top">IBM 3829 AF Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC10</strong></td>
<td valign="top">IBM 3835-001 AF Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC05</strong></td>
<td valign="top">IBM 3835-001 AF Printer (with AFIG)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC05</strong></td>
<td valign="top">IBM 3835-002, 3900 AF Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">IBM 3912, 3916 Page Printer (ASCII/LAN)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC06</strong></td>
<td valign="top">IBM 3912, 3916 Page Printer with IPDS feature (twinax)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">IBM 3930-03 Page Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD01</strong></td>
<td valign="top">IBM 3930-03 Page Printer with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC02</strong></td>
<td valign="top">IBM 3935 AF Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA09</strong></td>
<td valign="top">IBM 4019 LaserPrinters (HP mode)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB01</strong></td>
<td valign="top">IBM 4019 LaserPrinters with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC06</strong></td>
<td valign="top">IBM 4028 LaserPrinters</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">IBM 4029 LaserPrinters</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB02</strong></td>
<td valign="top">IBM 4029 LaserPrinters with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">IBM 4039 LaserPrinters</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD07</strong></td>
<td valign="top">IBM 4039 LaserPrinters with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">IBM 4049 LaserPrinters</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">IBM 4049 LaserPrinters with PostScript</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB09</strong></td>
<td valign="top">IBM 4079 Color Jetprinter PS</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB05</strong></td>
<td valign="top">IBM 4303 Network Color Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC06</strong></td>
<td valign="top">IBM 4312, 4317, 4324 NP with IPDS feature (twinax)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC06</strong></td>
<td valign="top">IBM 4312, 4317, 4324 NP with IPDS feature (LAN)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">IBM 4312, 4317, 4324 NP (ASCII/LAN)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">IBM 4312, 4317, 4324 NP with PostScript (ASCII/LAN)</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC03</strong></td>
<td valign="top">IBM InfoPrint 60</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC05</strong></td>
<td valign="top">IBM InfoPrint 62 Model 2</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC06</strong></td>
<td valign="top">IBM InfoPrint 62 Model 3</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB05</strong></td>
<td valign="top">IBM InfoColor 70</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC05</strong></td>
<td valign="top">IBM InfoPrint 4000</td>
</tr>
<tr>
<td valign="top"><strong>*IMGC06</strong></td>
<td valign="top">IBM InfoPrint 4000 High Resolution</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB02</strong></td>
<td valign="top">Lexmark 4039Plus</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD11</strong></td>
<td valign="top">Lexmark Optra C Color Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">Lexmark Optra E, E+</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">Lexmark Optra N</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">Lexmark Optra R+, Rx+, Lx+, Lxn+</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD02</strong></td>
<td valign="top">Lexmark Optra S Printers</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD05</strong></td>
<td valign="top">Lexmark Optra SC Color Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">Okidata OL400 LED Page Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">Okidata OL800, OL810 LED Page Printers</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB12</strong></td>
<td valign="top">QMS 2025, 3225</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD04</strong></td>
<td valign="top">QMS Magicolor CX</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB09</strong></td>
<td valign="top">Tektronix Phaser 140</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB04</strong></td>
<td valign="top">Tektronix Phaser 300</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB05</strong></td>
<td valign="top">Tektronix Phaser 400</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB05</strong></td>
<td valign="top">Tektronix Phaser 540, 550</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB06</strong></td>
<td valign="top">Tektronix Phaser 560</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA01</strong></td>
<td valign="top">Xerox 4219/MRP</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">Xerox 4220/MRP</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">Xerox 4230 DocuPrinter</td>
</tr>
<tr>
<td valign="top"><strong>*IMGA02</strong></td>
<td valign="top">Xerox 4512, 4517 Network Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB13</strong></td>
<td valign="top">Xerox 4520mp Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGD04</strong></td>
<td valign="top">Xerox 4700 II Color Document Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB08</strong></td>
<td valign="top">Xerox 4915 Color Laser Printer</td>
</tr>
<tr>
<td valign="top"><strong>*IMGB05</strong></td>
<td valign="top">Xerox 4920, 4925 Color Laser Printer</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRXAPIERR">Error Messages</a></h3>
<table width="100%">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td align="left" valign="top">CPF24B4 E</td>
<td align="left" valign="top">Severe error while addressing parameter list.</td>
</tr>
<tr>
<td valign="top">CPF3330 E</td>
<td valign="top">Necessary resource not available.</td>
</tr>
<tr>
<td valign="top">CPF333B E</td>
<td valign="top">Job system name is not valid.</td>
</tr>
<tr>
<td valign="top">CPF333C E</td>
<td valign="top">Spooled file create date is not valid.</td>
</tr>
<tr>
<td valign="top">CPF333D E</td>
<td valign="top">Spooled file create time is not valid.</td>
</tr>
<tr>
<td valign="top">CPF333E E</td>
<td valign="top">Spooled file create time is not blank.</td>
</tr>
<tr>
<td valign="top">CPF333F E</td>
<td valign="top">Job system name is not blank.</td>
</tr>
<tr>
<td valign="top">CPF3342 E</td>
<td valign="top">Job &amp;5/&amp;4/&amp;3 not found.</td>
</tr>
<tr>
<td valign="top">CPF3343 E</td>
<td valign="top">Duplicate job names found.</td>
</tr>
<tr>
<td valign="top">CPF3344 E</td>
<td valign="top">File &amp;1 number &amp;2 no longer in the system.</td>
</tr>
<tr>
<td valign="top">CPF335B E</td>
<td valign="top">Spooled file create date is not blank.</td>
</tr>
<tr>
<td valign="top">CPF34B1 E</td>
<td valign="top">Output queue &amp;1 in library &amp;2 not found.</td>
</tr>
<tr>
<td valign="top">CPF33DD E</td>
<td valign="top">Maximum number of open spooled files exceeded for this
job.</td>
</tr>
<tr>
<td valign="top">CPF33DE E</td>
<td valign="top">Size of internal data for opened spooled file exceeds
maximum.</td>
</tr>
<tr>
<td valign="top">CPF33DF E</td>
<td valign="top">Internal data area for opened spooled files destroyed.</td>
</tr>
<tr>
<td valign="top">CPF3492 E</td>
<td valign="top">Not authorized to spooled file.</td>
</tr>
<tr>
<td valign="top">CPF3C1D E</td>
<td valign="top">Length specified in parameter &amp;1 not valid.</td>
</tr>
<tr>
<td valign="top">CPF3C1E E</td>
<td valign="top">Required parameter &amp;1 omitted.</td>
</tr>
<tr>
<td valign="top">CPF3C21 E</td>
<td valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td valign="top">CPF3C33 E</td>
<td valign="top">Spooled file number &amp;1 is not valid.</td>
</tr>
<tr>
<td valign="top">CPF3C39 E</td>
<td valign="top">Value for reserved field not valid.</td>
</tr>
<tr>
<td valign="top">CPF3C40 E</td>
<td valign="top">Spooled file &amp;4 not found.</td>
</tr>
<tr>
<td valign="top">CPF3C41 E</td>
<td valign="top">More than one spooled file with same name.</td>
</tr>
<tr>
<td valign="top">CPF3C90 E</td>
<td valign="top">Literal value cannot be changed.</td>
</tr>
<tr>
<td valign="top">CPF3CF1 E</td>
<td valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td valign="top">CPF7AAB E</td>
<td valign="top">Problem &amp;1 not found.</td>
</tr>
<tr>
<td valign="top">CPF9801 E</td>
<td valign="top">Object &amp;2 in library &amp;3 not found.</td>
</tr>
<tr>
<td valign="top">CPF9802 E</td>
<td valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td valign="top">CPF9803 E</td>
<td valign="top">Cannot allocate object &amp;2 in library &amp;3.</td>
</tr>
<tr>
<td valign="top">CPF9804 E</td>
<td valign="top">Object &amp;2 in library &amp;3 damaged.</td>
</tr>
<tr>
<td valign="top">CPF9810 E</td>
<td valign="top">Library &amp;1 not found.</td>
</tr>
<tr>
<td valign="top">CPF9814 E</td>
<td valign="top">Device &amp;1 not found.</td>
</tr>
<tr>
<td valign="top">CPF9818 E</td>
<td valign="top">Object &amp;2 in library &amp;3 not created.</td>
</tr>
<tr>
<td valign="top">CPF9819 E</td>
<td valign="top">Object &amp;2 in library &amp;3 not created.</td>
</tr>
<tr>
<td valign="top">CPF9820 E</td>
<td valign="top">Not authorized to use library &amp;1.</td>
</tr>
<tr>
<td valign="top">CPF9838 E</td>
<td valign="top">User profile storage limit exceeded.</td>
</tr>
<tr>
<td valign="top">CPF9845 E</td>
<td valign="top">Error occurred while opening file &amp;1.</td>
</tr>
<tr>
<td valign="top">CPF9871 E</td>
<td valign="top">Error occurred while processing.</td>
</tr>
<tr>
<td valign="top">CPF9872 E</td>
<td valign="top">Program or service program &amp;1 in library &amp;2 ended.
Reason code &amp;3.</td>
</tr>
<tr>
<td valign="top">CPFA094 E</td>
<td valign="top">Path name not specified.</td>
</tr>
<tr>
<td valign="top">CPFA09C E</td>
<td valign="top">Not authorized to object.</td>
</tr>
<tr>
<td valign="top">CPFA09E E</td>
<td valign="top">Object in use.</td>
</tr>
<tr>
<td valign="top">CPFA09F E</td>
<td valign="top">Object damaged.</td>
</tr>
<tr>
<td valign="top">CPFA0A1 E</td>
<td valign="top">An input/output error occurred.</td>
</tr>
<tr>
<td valign="top">CPFA0A2 E</td>
<td valign="top">Information passed to this operation was not valid.</td>
</tr>
<tr>
<td valign="top">CPFA0A3 E</td>
<td valign="top">Path name resolution causes looping.</td>
</tr>
<tr>
<td valign="top">CPFA0A4 E</td>
<td valign="top">Too many open files for process.</td>
</tr>
<tr>
<td valign="top">CPFA0A5 E</td>
<td valign="top">Too many open files.</td>
</tr>
<tr>
<td valign="top">CPFA0A7 E</td>
<td valign="top">Path name too long.</td>
</tr>
<tr>
<td valign="top">CPFA0AA E</td>
<td valign="top">Error occurred while attempting to obtain space.</td>
</tr>
<tr>
<td valign="top">CPFA0AB E</td>
<td valign="top">Object name not a directory.</td>
</tr>
<tr>
<td valign="top">CPFA0AD E</td>
<td valign="top">Function not supported by file system.</td>
</tr>
<tr>
<td valign="top">CPFA0B1 E</td>
<td valign="top">Requested operation not allowed. Access problem.</td>
</tr>
<tr>
<td valign="top">CPFA0C4 E</td>
<td valign="top">Object name not a file.</td>
</tr>
<tr>
<td valign="top">CPFA0DA E</td>
<td valign="top">Object name is a directory.</td>
</tr>
<tr>
<td valign="top">CPFB530 E</td>
<td valign="top">Input object name field not valid.</td>
</tr>
<tr>
<td valign="top">CPFB531 E</td>
<td valign="top">Main storage input image parameter not valid.</td>
</tr>
<tr>
<td valign="top">CPFB532 E</td>
<td valign="top">Output data stream not allowed for operation option.</td>
</tr>
<tr>
<td valign="top">CPFB533 E</td>
<td valign="top">Main storage output not allowed for operation option.</td>
</tr>
<tr>
<td valign="top">CPFB534 E</td>
<td valign="top">API call sequence not valid.</td>
</tr>
<tr>
<td valign="top">CPFB535 E</td>
<td valign="top">Space provided for feedback structure not valid or
missing.</td>
</tr>
<tr>
<td valign="top">CPFB536 E</td>
<td valign="top">Handle field in parameter &amp;1 not valid or missing.</td>
</tr>
<tr>
<td valign="top">CPFB537 E</td>
<td valign="top">Error found in parameter &amp;1 at offset &amp;2.</td>
</tr>
<tr>
<td valign="top">CPFB538 E</td>
<td valign="top">Error found in parameter &amp;1 at offset &amp;2.</td>
</tr>
<tr>
<td valign="top">CPFB539 E</td>
<td valign="top">Error found in parameter &amp;1 at offset &amp;2.</td>
</tr>
<tr>
<td valign="top">CPFB53A E</td>
<td valign="top">Error found in parameter &amp;1 at offset &amp;2.</td>
</tr>
<tr>
<td valign="top">CPFB53B E</td>
<td valign="top">Output change not allowed for multipage request.</td>
</tr>
<tr>
<td valign="top">CPFB53C E</td>
<td valign="top">Main storage output overlaps main storage input.</td>
</tr>
<tr>
<td valign="top">CPFB540 E</td>
<td valign="top">Device &amp;1 for spooled file output not valid.</td>
</tr>
<tr>
<td valign="top">CPFB54A E</td>
<td valign="top">Image configuration &amp;1 is logically damaged.</td>
</tr>
<tr>
<td valign="top">CPFB555 E</td>
<td valign="top">Compression quality not valid for compression type.</td>
</tr>
<tr>
<td valign="top">CPFB556 E</td>
<td valign="top">Compression type not valid.</td>
</tr>
<tr>
<td valign="top">CPFB557 E</td>
<td valign="top">Error occurred compressing the data stream.</td>
</tr>
<tr>
<td valign="top">CPFB558 E</td>
<td valign="top">Error occurred decompressing the data stream.</td>
</tr>
<tr>
<td valign="top">CPFB565 E</td>
<td valign="top">Input data stream not valid.</td>
</tr>
<tr>
<td valign="top">CPFB566 E</td>
<td valign="top">Data read not complete.</td>
</tr>
<tr>
<td valign="top">CPFB567 E</td>
<td valign="top">Input image too small.</td>
</tr>
<tr>
<td valign="top">CPFB568 E</td>
<td valign="top">Attribute value not supported for data stream format.</td>
</tr>
<tr>
<td valign="top">CPFB569 E</td>
<td valign="top">Main storage allocation failure occurred.</td>
</tr>
<tr>
<td valign="top">CPFB56A E</td>
<td valign="top">LZW minimum-code-length field not valid.</td>
</tr>
<tr>
<td valign="top">CPFB56B E</td>
<td valign="top">Error opening input object.</td>
</tr>
<tr>
<td valign="top">CPFB56C E</td>
<td valign="top">Error opening output object.</td>
</tr>
<tr>
<td valign="top">CPFB56D E</td>
<td valign="top">Color reduction not allowed.</td>
</tr>
<tr>
<td valign="top">CPFB56E E</td>
<td valign="top">Gray-scale reduction not allowed.</td>
</tr>
<tr>
<td valign="top">CPFB56F E</td>
<td valign="top">Resolution quality reduction not allowed.</td>
</tr>
<tr>
<td valign="top">CPFB570 E</td>
<td valign="top">Decimation table error occurred.</td>
</tr>
<tr>
<td valign="top">CPFB571 E</td>
<td valign="top">Error occurred writing AFP output.</td>
</tr>
<tr>
<td valign="top">CPFB572 E</td>
<td valign="top">Output data stream not supported.</td>
</tr>
<tr>
<td valign="top">CPFB573 E</td>
<td valign="top">File type &amp;1 not supported.</td>
</tr>
<tr>
<td valign="top">CPFB574 E</td>
<td valign="top">Error reading GIF block.</td>
</tr>
<tr>
<td valign="top">CPFB575 E</td>
<td valign="top">Image filter error.</td>
</tr>
<tr>
<td valign="top">CPFB576 E</td>
<td valign="top">General data stream I/O error occurred.</td>
</tr>
<tr>
<td valign="top">CPFB577 E</td>
<td valign="top">Spooled file I/O error occurred.</td>
</tr>
<tr>
<td valign="top">CPFB578 E</td>
<td valign="top">Unexpected end of file detected in input data stream.</td>
</tr>
<tr>
<td valign="top">CPFB579 E</td>
<td valign="top">Output buffer too small.</td>
</tr>
<tr>
<td valign="top">CPFB57A E</td>
<td valign="top">Source photometric interpretation not supported.</td>
</tr>
<tr>
<td valign="top">CPFB57E E</td>
<td valign="top">An error occurred while transforming data.</td>
</tr>
<tr>
<td valign="top">CPFB57F E</td>
<td valign="top">Combination of input and output data stream formats not
supported.</td>
</tr>
<tr>
<td valign="top">CPFB5C9 E</td>
<td valign="top">Operation would suspend the process.</td>
</tr>
<tr>
<td valign="top">CPFB5CA E</td>
<td valign="top">Input/Output error in file &amp;1.</td>
</tr>
<tr>
<td valign="top">CPFB5CB E</td>
<td valign="top">System resource not available.</td>
</tr>
<tr>
<td valign="top">CPFB5CC E</td>
<td valign="top">File is read only.</td>
</tr>
<tr>
<td valign="top">CPFB5CD E</td>
<td valign="top">Function ended due to unexpected error.</td>
</tr>
<tr>
<td valign="top">CPFB5CE E</td>
<td valign="top">Function ended due to unexpected error.</td>
</tr>
<tr>
<td valign="top">CPFB5CF E</td>
<td valign="top">Function ended due to unexpected error.</td>
</tr>
<tr>
<td valign="top">CPIB530 I</td>
<td valign="top">Unable to delete temporary file &amp;2 in library &amp;1.</td>
</tr>
<tr>
<td valign="top">CPIB531 I</td>
<td valign="top">Different input data stream attribute recognized.</td>
</tr>
<tr>
<td valign="top">CPIB532 I</td>
<td valign="top">Input resolution not supported.</td>
</tr>
<tr>
<td valign="top">CPIB533 I</td>
<td valign="top">Output resolution not supported.</td>
</tr>
<tr>
<td valign="top">CPIB534 I</td>
<td valign="top">Color palette not found in image data stream header.</td>
</tr>
<tr>
<td valign="top">CPIB535 I</td>
<td valign="top">Unexpected end of file.</td>
</tr>
<tr>
<td valign="top">CPIB536 I</td>
<td valign="top">Unrecognized tag in TIFF file header.</td>
</tr>
<tr>
<td valign="top">CPIB537 I</td>
<td valign="top">Unknown GIF extension detected.</td>
</tr>
<tr>
<td valign="top">CPIB538 I</td>
<td valign="top">GIF end of file not found.</td>
</tr>
<tr>
<td valign="top">CPIB539 I</td>
<td valign="top">Output resolution changed.</td>
</tr>
</table>
<br>
<hr>
API Introduced: V4R2
<hr>
<table align="center" cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center">
<a href="#Top_Of_Page">Top</a> |
<a href="print1.htm">Print APIs</a> |
<a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</body>
</html>