friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
8826eae394
ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/XSPBLSEP.htm

903 lines
26 KiB
HTML
Raw Blame History

<!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>Exit Program for a Customized Separator Page</title>
<!-- 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. -->
<!-- Begin Header Records ========================================== -->
<!-- Print SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!--End Header Records -->
<!--Edited by Kersten Nov 2001 -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!-- Java sync-link -->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>Exit Program for a Customized Separator Page</h2>
<div class="box" style="width: 70%;">
<br>
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="TOP" width="10%">1</td>
<td align="LEFT" valign="TOP" width="50%">Separator data</td>
<td align="LEFT" valign="TOP" width="20%">Output</td>
<td align="LEFT" valign="TOP" width="20%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="TOP">2</td>
<td align="LEFT" valign="TOP">Separator data length</td>
<td align="LEFT" valign="TOP">Input</td>
<td align="LEFT" valign="TOP">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="TOP">3</td>
<td align="LEFT" valign="TOP">Separator information</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">Separator information length</td>
<td align="LEFT" valign="TOP">Input</td>
<td align="LEFT" valign="TOP">Binary(4)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;QSYSINC Member Name: ESPBLSEP<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>An exit program can be specified on the separator program parameter of the
printer device description. If a separator exit program is specified on the
printer device description, the system printer writer calls this program to
create the separator page. This separator page is used instead of the system
separator page.</p>
<br>
<!-- Please NOTE: DO NOT DELETE THIS SECTION if this API has no authorities and locks. -->
<!-- Instead, use the commented out coding below to indicate NONE. -->
<h3>Authorities and Locks</h3>
<!-- Use this if there are no authorities and locks. -->
<p>None.</p>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Separator data</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The separator data consists of two parts:</p>
<ul>
<li>Options that control how the separator data is to be printed</li>
<li>User-generated separator data</li>
</ul>
<p>See the <a href="#HDRDATASEP">Separator Data Format</a> for more
information.</p>
</dd>
<dt><strong>Separator data length</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the space used to pass separator data from the exit
program.</p>
</dd>
<dt><strong>Separator information</strong></dt>
<dd>INPUT; CHAR(*)
<p>Information that may be used to generate the separator data.</p>
<p>See the <a href="#HDRMBRLIPX">Separator Information Format</a> for more
information.</p>
</dd>
<dt><strong>Separator information length</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the space used to pass separator information to the exit
program.</p>
</dd>
</dl>
<h3><a name="HDRDATASEP">Separator Data Format</a></h3>
<p>The following table shows the information passed from the exit program to
create the customized separator page for the printer writer. The printer writer
takes the information and data, and prints the separator page.</p>
<p>See <a href="#HDRDTAFLD">Field Descriptions</a> for more information.</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%">CHAR(10)</td>
<td align="LEFT" valign="TOP" width="60%">Transform option</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">10</td>
<td align="CENTER" valign="TOP">A</td>
<td align="LEFT" valign="TOP">CHAR(2)</td>
<td align="LEFT" valign="TOP">Reserved</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">Page rotation</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">16</td>
<td align="CENTER" valign="TOP">10</td>
<td align="LEFT" valign="TOP">BINARY(4)</td>
<td align="LEFT" valign="TOP">Page length</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">20</td>
<td align="CENTER" valign="TOP">14</td>
<td align="LEFT" valign="TOP">BINARY(4)</td>
<td align="LEFT" valign="TOP">Page width</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">24</td>
<td align="CENTER" valign="TOP">18</td>
<td align="LEFT" valign="TOP">BINARY(4)</td>
<td align="LEFT" valign="TOP">Lines per inch</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">28</td>
<td align="CENTER" valign="TOP">1C</td>
<td align="LEFT" valign="TOP">BINARY(4)</td>
<td align="LEFT" valign="TOP">Characters per inch</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">DBCS Characters per inch</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">36</td>
<td align="CENTER" valign="TOP">24</td>
<td align="LEFT" valign="TOP">CHAR(10)</td>
<td align="LEFT" valign="TOP">DBCS characters rotation</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">46</td>
<td align="CENTER" valign="TOP">2E</td>
<td align="LEFT" valign="TOP">CHAR(10)</td>
<td align="LEFT" valign="TOP">Page size measurement method</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">56</td>
<td align="CENTER" valign="TOP">38</td>
<td align="LEFT" valign="TOP">CHAR(10)</td>
<td align="LEFT" valign="TOP">Print quality</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">66</td>
<td align="CENTER" valign="TOP">42</td>
<td align="LEFT" valign="TOP">CHAR(10)</td>
<td align="LEFT" valign="TOP">Overlay name</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">76</td>
<td align="CENTER" valign="TOP">4C</td>
<td align="LEFT" valign="TOP">CHAR(10)</td>
<td align="LEFT" valign="TOP">Overlay library name</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">86</td>
<td align="CENTER" valign="TOP">56</td>
<td align="LEFT" valign="TOP">CHAR(98)</td>
<td align="LEFT" valign="TOP">Reserved</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">184</td>
<td align="CENTER" valign="TOP">B8</td>
<td align="LEFT" valign="TOP">BINARY(4)</td>
<td align="LEFT" valign="TOP">Length of user-generated 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">Record length of user data</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">192</td>
<td align="CENTER" valign="TOP">C0</td>
<td align="LEFT" valign="TOP">CHAR(*)</td>
<td align="LEFT" valign="TOP">User-generated separator data</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRDTAFLD">Field Descriptions</a></h3>
<p>Each field is only valid when the transform option field is specified as
*FCFC. Otherwise, the field is ignored.</p>
<p><strong>Characters per inch.</strong> The number of characters (in tenths)
to be printed per inch.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>50</em></td>
<td align="left" valign="top">5 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>100</em></td>
<td align="left" valign="top">10 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>120</em></td>
<td align="left" valign="top">12 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>133</em></td>
<td align="left" valign="top">13.3 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>150</em></td>
<td align="left" valign="top">15 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>167</em></td>
<td align="left" valign="top">16.7 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>180</em></td>
<td align="left" valign="top">18 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>200</em></td>
<td align="left" valign="top">20 characters per inch</td>
</tr>
</table>
<p>Any other value, or a value not supported by the particular printer, will
result in 10 characters per inch.</p>
<p><strong>DBCS character rotation.</strong> Whether double-byte character set
(DBCS) characters are to be rotated 90 degrees counterclockwise before
printing. The possible values are *YES and *NO. The default value is *NO.</p>
<p><strong>DBCS characters per inch.</strong> The number of double-byte
characters to be printed per inch.</p>
<p> The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">One-half of the characters-per-inch value</td>
</tr>
<tr>
<td align="left" valign="top"><em>-2</em></td>
<td align="left" valign="top">20 double-byte characters per 3 inches</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">5 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>6</em></td>
<td align="left" valign="top">6 characters per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>10</em></td>
<td align="left" valign="top">10 characters per inch</td>
</tr>
</table>
<p>If any other value is used, the characters are printed at one-half of the
characters-per-inch (*CPI) value.</p>
<p><strong>Length of user-generated data.</strong> The number of bytes of data
(contained in the user-generated separator data field) passed from the user
exit program.</p>
<p>The length of the user-generated separator data cannot exceed 8096 bytes for
printers configured AFP(*NO). A value greater than 8096 causes the system
separator page to be printed.</p>
<p><strong>Lines per inch.</strong> The number of lines (in tenths) to print
per vertical inch.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>30</em></td>
<td align="left" valign="top">3 lines per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>40</em></td>
<td align="left" valign="top">4 lines per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>60</em></td>
<td align="left" valign="top">6 lines per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>75</em></td>
<td align="left" valign="top">7.5 lines per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>80</em></td>
<td align="left" valign="top">8 lines per inch</td>
</tr>
<tr>
<td align="left" valign="top"><em>90</em></td>
<td align="left" valign="top">9 lines per inch</td>
</tr>
</table>
<p>Any other value, or a value not supported by the particular printer, will
result in 6 lines per inch.</p>
<p>This parameter is output from the exit program and is only valid when the
Transform Option is specified as *FCFC. Otherwise this parameter is
ignored.</p>
<p><strong>Page length.</strong> The length of the separator page. The page
length can be specified in inches, centimeters, or rows depending on the page
size measurement method field.</p>
<p>A zero indicates the page length of the spooled file should be used. A
nonzero page length value is valid only when the page width field is also set
to a nonzero value. Otherwise, the page length is ignored.</p>
<p>Inches and centimeters are specified in 1/100ths. The value 1100 indicates a
page length of 11 inches when the page size measurement method field is
*INCH.</p>
<p><strong>Page size measurement method.</strong> The measurement method used
for the page length and page width fields.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*INCH</em></td>
<td align="left" valign="top">The page size is specified in 1/100ths of an
inch.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CM</em></td>
<td align="left" valign="top">The page size is specified in 1/100ths of a
centimeter.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ROWCOL</em></td>
<td align="left" valign="top">The page size is specified in row and column
format.</td>
</tr>
</table>
<p><strong>Page width.</strong> The width of the separator page. The page width
can be specified in inches, centimeters, or rows depending on the page size
measurement method field.</p>
<p>A 0 indicates the page width of the spooled file should be used. A nonzero
page width value is valid only when the page length field is also set to a
nonzero value. Otherwise, the page width is ignored.</p>
<p>Inches and centimeters are specified in 1/100ths. The value 850 indicates a
page width of 8.5 inches when the page size measurement method field is
*INCH.</p>
<p><strong>Overlay library name.</strong> The name of the library containing
the separator overlay.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*LIBL</em></td>
<td align="left" valign="top">The library list of the job that created the file
locates the overlay.</td>
</tr>
<tr>
<td align="left" valign="top"><em>library name</em></td>
<td align="left" valign="top">This library is searched for the overlay.</td>
</tr>
</table>
<p>If no value is returned from the exit program, *LIBL is assumed.</p>
<p><strong>Overlay name.</strong> The name of the separator overlay (the
material that prints on the front side of each separator page).</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">The separator does not use an overlay.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Overlay Name</em></td>
<td align="left" valign="top">The name of the overlay to print with the
separator.</td>
</tr>
</table>
<p>If no value is returned from the exit program, *NONE is assumed. Otherwise
this parameter is ignored.</p>
<p><strong>Page rotation.</strong> The degree of rotation of the text on the
page, with respect to the way the form is loaded into the printer.</p>
<p> The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">No rotation is done. Printing starts at the edge
loaded into the printer first, and is parallel to that edge.</td>
</tr>
<tr>
<td align="left" valign="top"><em>90</em></td>
<td align="left" valign="top">Text is rotated 90-degrees clockwise from the
0-degree writing position.</td>
</tr>
<tr>
<td align="left" valign="top"><em>180</em></td>
<td align="left" valign="top">Text is rotated 180-degrees clockwise from the
0-degree writing position.</td>
</tr>
<tr>
<td align="left" valign="top"><em>270</em></td>
<td align="left" valign="top">Text is rotated 270-degrees clockwise from the
0-degree writing position.</td>
</tr>
</table>
<p>If no valid value is returned from the exit program, 0 is assumed.</p>
<p><strong>Print quality.</strong> The print quality that is used when printing
the separator.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*STD</em></td>
<td align="left" valign="top">Standard</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DRAFT</em></td>
<td align="left" valign="top">Draft</td>
</tr>
<tr>
<td align="left" valign="top"><em>*DEVD</em></td>
<td align="left" valign="top">Print quality determined by printer hardware
setting</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FASTDRAFT</em></td>
<td align="left" valign="top">Fast draft</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NLQ</em></td>
<td align="left" valign="top">Near-letter quality</td>
</tr>
</table>
<p>If no valid value is returned from the exit program, *DEVD is assumed.
Otherwise this parameter is ignored.</p>
<p><strong>Record length of user data.</strong> The length of the *FCFC format
records in the user-generated separator data field.</p>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>Transform option.</strong> Whether the user-generated data is to be
transformed into commands recognized by the printer.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*FCFC</em></td>
<td align="left" valign="top">The first character of every record is an
American National Standards printer control character.
<p>The supported control characters and their functions follow:</p>
<table cellpadding="5">
<tr>
<td align="left" valign="top"><em>+</em></td>
<td align="left" valign="top">Prints record on current line.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">Moves down 1 line and prints record.</td>
</tr>
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Moves down 2 lines and prints record.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-</em></td>
<td align="left" valign="top">Moves down 3 lines and prints record.</td>
</tr>
</table>
<p>All other control character values are treated as blanks and result in the
record printing on the next line. Channel values are not supported.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">User-supplied data is in its final form. No
transform operation is done, and the data must contain the appropriate commands
corresponding to the printer data stream type.</td>
</tr>
</table>
<p>For the printer data stream type field of *SCS and *IPDS, data stream
commands controlling the drawer, rotations, and fonts may be sent to the
printer before the user-generated data. This puts the printer in the same state
as it is when system default separators are printed. The commands controlling
the drawer are based on the SEPDRAWER parameter of the Start Printer Writer
(STRPRTWTR) command. The remaining controls are set to defaults or have values
set from the spooled file attributes of the spooled file that prints next.</p>
<p>For a printer data stream type of *AFPDS, the initial commands are not sent
to the printer and the user must include all commands needed to define an AFPDS
document.</p>
<p><strong>User-generated separator data.</strong> The data that prints on the
separator page. The format of this text is dependent on the transform option
and the printer data stream type fields. When *FCFC has been specified for the
transform option, the data must be in the *FCFC format. When *NONE is specified
for the transform option, the data (text and controls) must be in the format
specified by the printer data stream type field.</p>
<h3><a name="HDRMBRLIPX">Separator Information Format</a></h3>
<p>The following table shows the information passed from the printer writer to
the exit program. This information is used to create a customized separator
page. For more details about the fields in the following table, see <a href=
"#HDRFDEXIT">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%">CHAR(16)</td>
<td align="LEFT" valign="TOP" width="60%">Internal job identifier</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">16</td>
<td align="CENTER" valign="TOP">10</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">32</td>
<td align="CENTER" valign="TOP">20</td>
<td align="LEFT" valign="TOP">CHAR(10)</td>
<td align="LEFT" valign="TOP">Job 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">User name</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">52</td>
<td align="CENTER" valign="TOP">34</td>
<td align="LEFT" valign="TOP">CHAR(6)</td>
<td align="LEFT" valign="TOP">Job number</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">58</td>
<td align="CENTER" valign="TOP">3A</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">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(10)</td>
<td align="LEFT" valign="TOP">Printer device name</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">82</td>
<td align="CENTER" valign="TOP">52</td>
<td align="LEFT" valign="TOP">CHAR(10)</td>
<td align="LEFT" valign="TOP">Printer data stream type</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">92</td>
<td align="CENTER" valign="TOP">5C</td>
<td align="LEFT" valign="TOP">CHAR(10)</td>
<td align="LEFT" valign="TOP">Type of separator</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">
102</td>
<td align="CENTER" valign="TOP">66</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">110</td>
<td align="CENTER" valign="TOP">6E</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">117</td>
<td align="CENTER" valign="TOP">75</td>
<td align="LEFT" valign="TOP">CHAR(1)</td>
<td align="LEFT" valign="TOP">Reserved</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">118</td>
<td align="CENTER" valign="TOP">76</td>
<td align="LEFT" valign="TOP">CHAR(6)</td>
<td align="LEFT" valign="TOP">Spooled file create time</td>
</tr>
<tr>
<td align="CENTER" valign="TOP">124</td>
<td align="CENTER" valign="TOP">7C</td>
<td align="LEFT" valign="TOP">CHAR(50)</td>
<td align="LEFT" valign="TOP">Reserved</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRFDEXIT">Field Descriptions</a></h3>
<p><strong>Internal job identifier.</strong> The internal identifier of the job
that owns the spooled file that prints next. Only the i5/OS APIs use this
identifier. The identifier is not valid following an initial program load
(IPL). If you attempt to use it after an IPL, an exception occurs.</p>
<p><strong>Internal spooled file identifier.</strong> The internal identifier
of the spooled file that prints next. This value is used as input to other
programs to improve the performance of locating the spooled file on the system.
Only the i5/OS APIs use this identifier. The identifier is not valid following
an IPL. If you attempt to use it after an IPL, an exception occurs.</p>
<p><strong>Job name.</strong> The name of the job that created the spooled file
that prints next.</p>
<p><strong>Job number.</strong> The number of the job that created the spooled
file that prints next.</p>
<p><strong>Job system
name.</strong> The name of the system where the job that created the spooled
file ran.</p>
<p>If the separator data length is less than 124 bytes, the exit program should
assume *ONLY. </p>
<p><strong>Printer device name.</strong> The name of the printer device
description for the writer that was started.</p>
<p><strong>Printer data stream type.</strong> The type of data stream
recognized by the printer writer. When the transform option is specified as
*NONE, this field must be used to determine the format of the user-generated
separator data field.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*AFPDS</em></td>
<td align="left" valign="top">Advanced Function Printing data stream</td>
</tr>
<tr>
<td align="left" valign="top"><em>*IPDS</em></td>
<td align="left" valign="top">Intelligent Printer Data Stream</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SCS</em></td>
<td align="left" valign="top">Systems Network Architecture (SNA) character
stream</td>
</tr>
</table>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>Spooled file create
date.</strong> The date the spooled file was create 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>If the separator data length is less than 124 bytes, the exit program should
assume *ONLY.</p>
<p><strong>Spooled file create time.</strong> 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>If the separator data length is less than 124 bytes, the exit program should
assume *ONLY. </p>
<p><strong>Spooled file name.</strong> The name of the spooled file that prints
next.</p>
<p><strong>Spooled file number.</strong> The spooled file number of the spooled
file that prints next.</p>
<p><strong>Type of separator.</strong> The type of separator you want
printed.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*FILE</em></td>
<td align="left" valign="top">Separator printed before each copy of a spooled
file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*JOB</em></td>
<td align="left" valign="top">Separator printed between spooled files created
by different jobs.</td>
</tr>
</table>
<p><strong>User name.</strong> The name of the user that created the spooled
file that prints next.</p>
<br>
<hr>
Exit program introduced: V2R3
<hr>
<table cellpadding="2" cellspacing="2" align="center">
<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>
Reference in New Issue View Git Blame Copy Permalink