5216 lines
132 KiB
HTML
5216 lines
132 KiB
HTML
<!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>
|
|
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>
|
|
Service Program Name: QIMGCIMG<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
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">>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 &5/&4/&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 &1 number &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 &1 in library &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 &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C1E E</td>
|
|
<td valign="top">Required parameter &1 omitted.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C21 E</td>
|
|
<td valign="top">Format name &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C33 E</td>
|
|
<td valign="top">Spooled file number &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 &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 &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9801 E</td>
|
|
<td valign="top">Object &2 in library &3 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9802 E</td>
|
|
<td valign="top">Not authorized to object &2 in &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9803 E</td>
|
|
<td valign="top">Cannot allocate object &2 in library &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9804 E</td>
|
|
<td valign="top">Object &2 in library &3 damaged.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9810 E</td>
|
|
<td valign="top">Library &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9814 E</td>
|
|
<td valign="top">Device &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9818 E</td>
|
|
<td valign="top">Object &2 in library &3 not created.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9819 E</td>
|
|
<td valign="top">Object &2 in library &3 not created.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9820 E</td>
|
|
<td valign="top">Not authorized to use library &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 &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 &1 in library &2 ended.
|
|
Reason code &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 &1 not valid or missing.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPFB537 E</td>
|
|
<td valign="top">Error found in parameter &1 at offset &2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPFB538 E</td>
|
|
<td valign="top">Error found in parameter &1 at offset &2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPFB539 E</td>
|
|
<td valign="top">Error found in parameter &1 at offset &2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPFB53A E</td>
|
|
<td valign="top">Error found in parameter &1 at offset &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 &1 for spooled file output not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPFB54A E</td>
|
|
<td valign="top">Image configuration &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 &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 &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 &2 in library &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>
|