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

1721 lines
53 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Move Spooled File (QSPMOVSP) 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. -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- Print SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!--File Edited by Kersten Nov 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 type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>Move Spooled File (QSPMOVSP) API</h2>
<div class="box" style="width: 70%;">
<br>
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="50%">Function information</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">Length of function information</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">Function information format name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Error code</td>
<td align="left" valign="top">I/O</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Move Spooled File (QSPMOVSP) API can:</p>
<ul>
<li>Move a spooled file to the top of an output queue</li>
<li>Move a spooled file after another spooled file</li>
</ul>
<p>The spooled files can be identified by:</p>
<ul>
<li>The internal job and spooled file identifiers</li>
<li>The specific job name, spooled file name, and spooled file number</li>
</ul>
<p>See <a href="#TBLAA">Spooled File Identifying Fields</a> for these
combinations for spooled file identifiers.</p>
<p>Using this API, a spooled file can:</p>
<ul>
<li>Change output queues
<p>The output queue of the spooled file is changed when it is moved to the top
of another output queue.</p>
<p>The source spooled file moves to the output queue of the target spooled
file.</p>
</li>
<li>Change priority
<p>The priority of the spooled file is changed to the requester's highest
scheduled priority if the spooled file is moved to the top of an output queue.
For example:</p>
<pre>
Requester's priority limit = 2
file priority
New priority = 2 when moved here -------&gt;
A 3
B 3
</pre>
<p>The priority of the spooled file is changed to the priority of the target
spooled file if the requester's highest schedule priority is equal to or less
than that of the spooled file it is moving after. For example:</p>
<pre>
Requester's priority limit = 2
file priority
A 3
new priority = 3 when moved here -------&gt;
B 5
C 5
</pre>
<p>The priority of the spooled file is changed to the requester's highest
schedule priority if:</p>
<ul>
<li>The requester's priority is greater (lower) than the target spooled file
and</li>
<li>The requester's limit is less (higher) than or equal to the spooled files
it is moving ahead of. For example:</li>
</ul>
<pre>
Requester's priority limit = 4
file priority
C 3
new priority = 4 when moved here -------&gt;
B 5
D 5
</pre>
<br>
<pre>
Requester's priority limit = 4
file priority
E 3
new priority = 4 when moved here -------&gt;
F 4
In this case, the requester must own spooled
file F or have special authorities.
</pre>
</li>
<li>Be held
<p>A spooled file in ready, open, closed, or deferred status is held when it is
moved after a spooled file that is held or saved.</p>
</li>
<li>Be released and made ready
<p>A spooled file in held, open, closed, or saved status is made ready when it
is moved to the top of an output queue.</p>
<p>A spooled file in held, open, closed, or saved status is made ready when it
is moved after a spooled file that is in ready status.</p>
</li>
</ul>
<br>
<h3>Restrictions for Movement of Spooled Files</h3>
<p>Situations exist in which the QSPMOVSP API does not allow a spooled file to
be moved.</p>
<p>These situations are:</p>
<ul>
<li>A spooled file with deferred (DFR) status can move after a spooled file
with ready (RDY) status on the same output queue. This can occur when the
target spooled file is the last spooled file in RDY status on that output
queue.</li>
<li>The spooled file being moved cannot be held as a result of a Hold Job
(HLDJOB SPLFILE(*YES)) command.</li>
<li>A spooled file selected by a writer cannot be moved.</li>
<li>A spooled file cannot be moved after a spooled file that is in open
status.</li>
<li>A spooled file cannot be moved after a spooled file that is in closed
status, unless both spooled files are part of the same job.</li>
<li>The destination output queue must have the order of spooled files on the
queue defined as *FIFO.
<p>Spooled files cannot be moved to the top of an output queue with the order
of spooled files on the output queue defined as *JOBNBR. When a spooled file is
requested to be moved after a spooled file and the target spooled file resides
on a job number sequenced output queue, the move will occur. However, the
spooled file is positioned by the job number sequence. In this situation,
CPI33E2 is written to the job log to indicate the action taken.</p>
</li>
<li>A spooled file cannot be moved after a spooled file that has been selected
by a writer (PND, WTR, PRT, SND, or MSGW status) unless the target spooled file
is the last spooled file selected by the writer.</li>
<li>A spooled file cannot be moved after a spooled file in deferred status
unless both spooled files have the same status.</li>
<li><img src="delta.gif" alt="Start of change">A spooled file cannot be moved from an output queue in an independent disk pool to an
output queue in *SYSBAS if that same spooled file resides in an output queue of another
independent disk pool.<img src="deltaend.gif" alt="End of change"></li>
</ul>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>Output Queue of Spooled File Being Moved</em></dt>
<dd>*EXCLRD</dd>
<dt><em>New Output Queue of File Being Moved</em></dt>
<dd>*EXCLRD</dd>
<dt><em>Output Queue Library Authority</em></dt>
<dd>*EXECUTE</dd>
</dl>
<br>
<h3>Output Queue Authorities</h3>
<p>When the source spooled file moves to a different output queue and the
source output queue is defined with DSPDATA(*OWNER), the requester must be the
owner of the source spooled file or have *SPLCTL authority.</p>
<p>One or more of the following conditions must be met to move a spooled file
on the destination output queue. The destination queue can be either the source
output queue or a different output queue.</p>
<ul>
<li>The requester has *SPLCTL authority.</li>
<li>The requester has *JOBCTL authority, and the destination output queue is
specified as OPRCTL(*YES).</li>
<li><img src="delta.gif" alt="Start of change">The requester has *READ authority to the output queue.<img src="deltaend.gif" alt="End of change"></li>
</ul>
<br>
<h3>Spooled File Authorities</h3>
<p>The requester is authorized to the source 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 *SPLCTL authority.</li>
<li>The requester has *JOBCTL authority, and the source output queue is
specified as OPRCTL(*YES).</li>
<li>The source output queue is defined as AUTCHK(*OWNER) and the requester has
ownership rights to the output queue.</li>
<li>The source output queue is defined as AUTCHK(*DTAAUT) and the requester has
data rights (read, add, and delete) to the output queue.</li>
</ul>
<br>
<h3>User Profile Highest Schedule Priority</h3>
<p>When the requester has no other special authorities, the following are also
in effect:</p>
<ul>
<li>When moving a spooled file to the top of an output queue and one of the
following is true, the priority is set to 1:
<ul>
<li>The requester has *SPLCTL authority.</li>
<li>The requester has *JOBCTL authority, and the destination output queue is
specified as OPRCTL(*YES).</li>
<li>The destination output queue is defined as AUTCHK(*OWNER) and the requester
has ownership rights to the output queue.</li>
<li>The destination output queue is defined as AUTCHK(*DTAAUT) and the
requester has data rights (read, add, and delete) to the output queue.</li>
</ul>
</li>
<li>If a spooled file is moved ahead of a spooled file owned by someone else
and both spooled files have the same priority, the requester must have a
priority limit of one less than the priority of the spooled file.</li>
<li>If the requester's priority limit is the same as the spooled files it is to
be moved ahead of, all spooled files at that priority level must be owned by
the requester.</li>
</ul>
<p>Special authorities of *JOBCTL (job control) and *SPLCTL (spool control)
allow the requester to move a spooled file anywhere on an output queue.</p>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Function information</strong></dt>
<dd>INPUT; CHAR(*)
<p>The information that is associated with the spooled file to be moved and the
output queue to which it is to be moved. See <a href="#HDRFUNLIST">Format of
the Function Information</a> for the format of this parameter.</p>
</dd>
<dt><strong>Length of function information</strong></dt>
<dd>INPUT; INARY(4)
<p>The length of the function
information in the function information parameter. The length depends on the
function format. Each format has a different (but fixed) length as shown in the
specific format tables. The valid length for format MSPF0100 is 92 bytes or 114
bytes; the valid length for format MSPF0200 is 144 bytes or 188 bytes. If a
valid length is not specified, message CPF3C1D will be issued.</p>
</dd>
<dt><strong>Function information format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the function information that is being provided. The
information is provided in the function information parameter.</p>
<p>The formats are:</p>
<table cellpadding="5">
<!-- cols="25 75" -->
<tr>
<td align="left" valign="top"><em><a href="#HDRMSPF100">MSPF0100</a></em></td>
<td align="left" valign="top">Format for the function of *NEXT, which is a move
of the source spooled file ahead of all other ready spooled files on the target
output queue.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#HDRMSPF200">MSPF0200</a></em></td>
<td align="left" valign="top">Format for the function of *AFTER, which is a
move of the source spooled file after the target spooled file.</td>
</tr>
</table>
<br>
</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="HDRFUNLIST">Format of the Function Information</a></h3>
<h3><a name="HDRMSPF100">MSPF0100 Format</a></h3>
<p>The following table shows the information provided for the MSPF0100 format.
For more details about the fields in the following table, see <a href=
"#HDRMSPFDE">Field Descriptions</a>.</p>
<table border width="80%" cellpadding="5">
<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%">Source job name</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Source job user name</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Source job number</td>
</tr>
<tr>
<td align="center" valign="top">26</td>
<td align="center" valign="top">18</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Source internal job identifier</td>
</tr>
<tr>
<td align="center" valign="top">42</td>
<td align="center" valign="top">2A</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Source internal spooled file identifier</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">Source 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">Source 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">Target output queue 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">Target output queue library name</td>
</tr>
<tr>
<td align="center" valign="top">
92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Source job system name</td>
</tr>
<tr>
<td align="center" valign="top">100</td>
<td align="center" valign="top">64</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Source spooled file create date</td>
</tr>
<tr>
<td align="center" valign="top">107</td>
<td align="center" valign="top">6B</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">108</td>
<td align="center" valign="top">6C</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Source spooled file create time</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRMSPF200">MSPF0200 Format</a></h3>
<p>The following table shows the information provided for the MSPF0200 format.
For more details about the fields in the following table, see <a href=
"#HDRMSPFDE">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(10)</td>
<td align="left" valign="top" width="60%">Source job name</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Source job user name</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Source job number</td>
</tr>
<tr>
<td align="center" valign="top">26</td>
<td align="center" valign="top">18</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Source internal job identifier</td>
</tr>
<tr>
<td align="center" valign="top">42</td>
<td align="center" valign="top">2A</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Source internal spooled file identifier</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">Source 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">Source 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">Target job 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">Target job user name</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Target job number</td>
</tr>
<tr>
<td align="center" valign="top">98</td>
<td align="center" valign="top">62</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Target internal job identifier</td>
</tr>
<tr>
<td align="center" valign="top">114</td>
<td align="center" valign="top">72</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Target internal spooled file identifier</td>
</tr>
<tr>
<td align="center" valign="top">130</td>
<td align="center" valign="top">82</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Target spooled file 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">Target spooled file number</td>
</tr>
<tr>
<td align="center" valign="top">
144</td>
<td align="center" valign="top">90</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Source job system name</td>
</tr>
<tr>
<td align="center" valign="top">152</td>
<td align="center" valign="top">98</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Source spooled file create date</td>
</tr>
<tr>
<td align="center" valign="top">159</td>
<td align="center" valign="top">9F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">160</td>
<td align="center" valign="top">A0</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Source spooled file create time</td>
</tr>
<tr>
<td align="center" valign="top">166</td>
<td align="center" valign="top">A6</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Target job system name</td>
</tr>
<tr>
<td align="center" valign="top">174</td>
<td align="center" valign="top">AE</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Target spooled file create date</td>
</tr>
<tr>
<td align="center" valign="top">181</td>
<td align="center" valign="top">B5</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">182</td>
<td align="center" valign="top">B6</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Target spooled file create time</td>
</tr>
</table>
<br>
<h3><a name="HDRMSPFDE">Field Descriptions</a></h3>
<p><strong>Source internal job identifier.</strong> The internal identifier for
the job that owns the spooled file to be moved. Only i5/OS APIs use this
identifier; no other interface on the system does.</p>
<p><strong>Note:</strong> 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>This field must be blank when the source job name is given.</p>
<p>Use one of the following APIs to make the identifier available:</p>
<ul>
<li><a href="QUSLSPL.htm">List Spooled Files (QUSLSPL) API</a></li>
<li><a href="QUSRSPLA.htm">Retrieve Spooled File Attributes (QUSRSPLA)
API</a></li>
</ul>
<p>There may be a performance advantage when identifying the source job by its
internal identifier.</p>
<p><strong>Source internal spooled file identifier.</strong> The internal
identifier for the spooled file to be moved. Only the i5/OS APIs use this
identifier; no other interface on the system does.</p>
<p><strong>Note:</strong> 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>This field must be blank when a source spooled file name is given.</p>
<p>Use one of the following APIs to make the identifier available:</p>
<ul>
<li><a href="QUSLSPL.htm">List Spooled Files (QUSLSPL) API</a></li>
<li><a href="QUSRSPLA.htm">Retrieve Spooled File Attributes (QUSRSPLA)
API</a></li>
</ul>
<p>There may be a performance advantage when identifying the source spooled
file by its internal identifier.</p>
<p><strong>Source job name.</strong> The name of the job that owns the
spooled file to be moved.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em><strong>*</strong></em></td>
<td align="left" valign="top">Only the job that this program is running. The
job user name, job number, and internal identifier for the source job must be
blank.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*INT</em></td>
<td align="left" valign="top">The job to be moved is identified by the internal
job identifier.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Name</em></td>
<td align="left" valign="top">The name of the job that owns the spooled file
to be moved.</td>
</tr>
</table>
<br>
<p><strong>Source job number.</strong> The number of the job that owns the
spooled file to be moved. It can optionally be blank when a job name or a job
user name is specified. This field must be blank when the source job name is
specified as *INT or *.</p>
<p><strong>Source job system
name.</strong> The name of the system where the job that created the source
spooled file ran or blank when the source spooled file name is *INT. This field
is considered after the source job name, source user name, source job number,
source spooled file name, and source spooled file number field requirements
have been met.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td width="15%" valign="top"><em>*ONLY</em></td>
<td width="85%" valign="top">There is one job with the specified source job
name, source job user name, source job number, source spooled file name, source
spooled file number, source spooled file creation date, and source spooled file
creation time.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CURRENT</em></td>
<td align="left" valign="top">The job on the current system with the specified
source job name, source job user name, source job number, source spooled file
name, source spooled file number, source spooled file create date, and source
spooled file create time is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ANY</em></td>
<td align="left" valign="top">The source job system name is not considered when
selecting a spooled file. Use this value when you want the source spooled file
create date and source spooled file create time fields to take precedence over
the source job system name when selecting a spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>system-name</em></td>
<td align="left" valign="top">The name of the system where the job that created
the source spooled file ran.</td>
</tr>
</table>
<br>
<p>When the Length of function information parameter is less than 114 with
format MSPF0100 or less than 188 with format MSPF0200, the API assumes blanks
when the source spooled file name is *INT. When source spooled file name is not
*INT, the API assumes *ONLY.</p>
<p><strong>Source job user name.</strong> The user name of the job that owns the spooled file to be moved. It can optionally be blank when a job name is
specified. This field must be blank when the source job name is specified as
*INT or *.</p>
<p><strong>Source spooled file
create date.</strong> The date the source spooled file was created on the
system or blank when the spooled file name is *INT. This field is considered
after the source job name, source job user name, source job number, source
spooled file name, source spooled file number, and source job system name field
requirements have been met. The date must be in the CYYMMDD format or one of
the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td width="15%" valign="top"><em>*ONLY</em></td>
<td width="85%" valign="top">There is only one spooled file with the specified
source job name, source user name, source job number, source spooled file name,
source spooled file number, and source job system name.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LAST</em></td>
<td align="left" valign="top">The spooled file with the latest date and time
which also has the specified source job name, source job user name, source job
number, source spooled file name, source spooled file number, and source job
system name is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>date</em></td>
<td align="left" valign="top">The date the source 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 of function information parameter is less than 114 with
format MSPF0100 or less than 188 with format MSPF0200, 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>Source spooled file create time.</strong> The time the source
spooled file was created on the system or blank when the source spooled file
name is *INT. This field must be set to blanks when special values *LAST or
*ONLY are used for field source spooled file create date. This field must have
a value set if a date is specified for field source spooled file create date.
This field is considered after the source job name, source job user name,
source job number, source spooled file name, source spooled file number, source
job system name, and source 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 align="left" valign="top"><em>*ONLY</em></td>
<td align="left" valign="top">There is only one spooled file with the specified
source job name, source job user name, source job number, source spooled file
name, source spooled file number, source job system name, and source spooled
file create date.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LAST</em></td>
<td align="left" valign="top">The spooled file with the latest time which also
has the specified source job name, source user name, source job number, source
spooled file name, source spooled file number, source job system name, and
source spooled file create date is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>time</em></td>
<td align="left" valign="top">The time the source 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 align="left" valign="top"><em>blanks</em></td>
<td align="left" valign="top">This field must be set to blanks if the Source
spooled file create date field is set to *LAST or *ONLY.</td>
</tr>
</table>
<br>
<p>When the Length of function information parameter is less than 114 with
format MSPF0100 or less than 188 with format MSPF0200, the API assumes blanks
for this field. </p>
<p><strong>Source spooled file name.</strong> The name of the spooled file to
be moved.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*INT</em></td>
<td align="left" valign="top">The source spooled file is identified by the
internal spooled file identifier.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Name</em></td>
<td align="left" valign="top">The name of the spooled file to be moved.</td>
</tr>
</table>
<br>
<p><strong>Source spooled file number.</strong> The unique number of the
spooled file to be moved. The valid range is -1 through 999999 and must be
specified as such even if the value for the spooled file name field is
*INT.</p>
<p>The following special values are supported for this field:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Only one spooled file from the job has the
specified file name; therefore, the number of the spooled file is not
necessary.</td>
</tr>
<tr>
<td align="left" valign="top" nowrap><em>-1</em></td>
<td align="left" valign="top">The highest-numbered spooled file with the
specified file name.</td>
</tr>
<tr>
<td align="left" valign="top" nowrap><em>-2</em></td>
<td align="left" valign="top">The source spooled file number is not used to
determine which spooled file to process. Use this value when you want the
source job system name field or the source spooled file create date and source
spooled file create time fields to take precedence over the source spooled file
number when selecting a spooled file.</td>
</tr>
</table>
<br>
<p><strong>Target internal job identifier.</strong> The internal identifier for
the job of the spooled file after which the source spooled file is to be moved.
Only the i5/OS APIs use this identifier; no other interface on the system
does.</p>
<p><strong>Note:</strong> 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>This field must be blank when a job name is given.</p>
<p>Use one of the following APIs to make the identifier available:</p>
<ul>
<li><a href="QUSLSPL.htm">List Spooled Files (QUSLSPL) API</a></li>
<li><a href="QUSRSPLA.htm">Retrieve Spooled File Attributes (QUSRSPLA)
API</a></li>
</ul>
<p>There may be a performance advantage when identifying the target job by its
internal identifier.</p>
<p><strong>Target internal spooled file identifier.</strong> The internal
identifier for the spooled file after which the source spooled file is to be
moved. Only the i5/OS APIs use this identifier; no other interface on the
system does.</p>
<p><strong>Note:</strong> 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>This field must be blank when a target spooled file name is given.</p>
<p>Use one of the following APIs to make the identifier available:</p>
<ul>
<li><a href="QUSLSPL.htm">List Spooled Files (QUSLSPL) API</a></li>
<li><a href="QUSRSPLA.htm">Retrieve Spooled File Attributes (QUSRSPLA)
API</a></li>
</ul>
<p>There may be a performance advantage when identifying the target spooled
file by its internal identifier.</p>
<p><strong>Target job name.</strong> The name of the job of the spooled file
after which the source spooled file is to be moved.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em><strong>*</strong></em></td>
<td align="left" valign="top">Only the job that this program is running. The
target job user name, target job number, and target internal identifier job
must be blank.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*INT</em></td>
<td align="left" valign="top">The target job is identified by the target
internal job identifier.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Name</em></td>
<td align="left" valign="top">The name of the job that owns the spooled file
after which the source spooled file is to be moved.</td>
</tr>
</table>
<br>
<p><strong>Target job number.</strong> The number of the target job. This is
the number of the job that owns the spooled file after which the source
spooled file is to be moved. It can optionally be blank when a target job name
or target job user name is specified. This field must be blank when the target
job name is specified as *INT or *.</p>
<p><strong>Target job system
name.</strong> The name of the system where the job that created the target
spooled file ran or blank when the target spooled file name is *INT. This field
is considered after the target job name, target job user name, target job
number, target spooled file name, and target spooled file number field
requirements have been met.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ONLY</em></td>
<td align="left" valign="top">There is one job with the specified target job
name, target job user name, target job number, target spooled file name, target
spooled file number, target spooled file creation date, and target spooled file
creation time.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CURRENT</em></td>
<td align="left" valign="top">The job on the current system with the specified
target job name, target job user name, and target job number is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ANY</em></td>
<td align="left" valign="top">The target job system name is not considered when
selecting a spooled file. Use this value when you want the target spooled file
create date and target spooled file create time fields to take precedence over
the target job system name when selecting a spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>system-name</em></td>
<td align="left" valign="top">The name of the system where the job that created
the target spooled file ran.</td>
</tr>
</table>
<br>
<p>When the Length of function information parameter is less than 188, 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>Target job user name.</strong> The user name of the target job. It
can optionally be blank when a target job name is specified. This field must be
blank when the target job name is specified as *INT or *.</p>
<p><strong>Target output queue library name.</strong> The name of the library
that contains the output queue.</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 is used to locate the output
queue.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CURLIB</em></td>
<td align="left" valign="top">The current library is used to locate the output
queue. If no library is specified as the current library for the job, QGPL is
used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Name</em></td>
<td align="left" valign="top">The library name.</td>
</tr>
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">No output queue library is specified when the
output queue name is specified as *SAME.</td>
</tr>
</table>
<br>
<p><strong>Target output queue name.</strong> The name of the output queue to
which the source spooled file is to move to the top of.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SAME</em></td>
<td align="left" valign="top">The spooled file will move to the top of the
output queue on which it currently resides.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Name</em></td>
<td align="left" valign="top">The name of the specific output queue the spooled
file is to move to the top of.</td>
</tr>
</table>
<p><strong>Target spooled file
create date.</strong> The date the target spooled file was created on the
system or blank when the target spooled file name is *INT. This field is
considered after the target job name, target job user name, target job number,
target spooled file name, target spooled file number, and target job system
name field requirements have been met. The date must be in the CYYMMDD format
or one of the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ONLY</em></td>
<td align="left" valign="top">There is only one spooled file with the specified
target job name, target job user name, target job number, target spooled file
name, target spooled file number, and target job system name.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LAST</em></td>
<td align="left" valign="top">The spooled file with the latest date and time
which also has the specified target job name, target job user name, target job
number, target spooled file name, target spooled file number, and target job
system name is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>date</em></td>
<td align="left" valign="top">The date the target 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>
<p>When the Length of function information parameter is less than 188, the API
assumes blanks when the target spooled file name is *INT. When target spooled
file name is not *INT, the API assumes *ONLY.</p>
<p><strong>Target spooled file create time.</strong> The time the target
spooled file was created on the system or blank when the target spooled file
name is *INT. This field must be set to blanks when special values *LAST or
*ONLY are used for field target spooled file create date. This field must have
a value set if a date is specified for field target spooled file create date.
This field is considered after the target job name, target job user name,
target job number, target spooled file name, target spooled file number, target
job system name, and target 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 align="left" valign="top"><em>*ONLY</em></td>
<td align="left" valign="top">There is only one spooled file with the specified
target job name, target job user name, target job number, target spooled file
name, target spooled file number, target job system name, and target spooled
file create date.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LAST</em></td>
<td align="left" valign="top">The spooled file with the latest time which also
has the specified target job name, target job user name, target job number,
target spooled file name, target spooled file number, target job system name,
and target spooled file create date is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>time</em></td>
<td align="left" valign="top">The time the target 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 align="left" valign="top"><em>blanks</em></td>
<td align="left" valign="top">This field must be set to blanks if the Target
spooled file create date field is set to *LAST or *ONLY.</td>
</tr>
</table>
<br>
<p>When the Length of function information parameter is less than 188, the API
assumes blanks for this field.</p>
<p><strong>Target spooled file name.</strong> The name of the spooled file
after which the source spooled file is to be moved.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*INT</em></td>
<td align="left" valign="top">The target spooled file is identified by the
target internal spooled file identifier.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Name</em></td>
<td align="left" valign="top">The name of the spooled file after which the
source spooled file is to be moved.</td>
</tr>
</table>
<br>
<p><strong>Target spooled file number.</strong> The unique number of the
spooled file after which the source spooled file is to be moved. The valid
range is -1 through 999999 and must be specified as such even if the value for
the spooled file name field is *INT. The following special values are supported
for this field:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Only one spooled file from the job has the
specified file name; therefor, the number of the spooled file is not
necessary.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">The highest-numbered spooled file with the
specified file name.</td>
</tr>
<tr>
<td align="left" valign="top" nowrap><em>-2</em></td>
<td align="left" valign="top">The target spooled file number is not used to
determine which spooled file to process. Use this value when you want the
target job system name field or the target spooled file create date and target
spooled file create time fields to take precedence over the target spooled file
number when selecting a spooled file.</td>
</tr>
</table>
<br>
<h3><a name="HDRPTBL">How to Specify Spooled File Identifying Fields</a></h3>
<p>This table illustrates the
valid field combinations of qualified job name, internal job identifier,
internal spooled file identifier, spooled file name, spooled file number, job
system name, spooled file create date, and spooled file create time. The
combinations of these fields identify the spooled file to be moved and the
spooled file it is to be moved after. For example, when the qualified job name
field value is *, the internal job identifier must be blank, the internal
spooled file identifier must be blank, the actual name of the spooled file must
be given, and a valid spooled file number must be given.</p>
<p><a name="TBLAA">Spooled File Identifying Fields</a></p>
<table border cellpadding="3">
<!-- cols="7 7 9 10 10 9 12 12 12 12" -->
<tr>
<th align="left" valign="bottom" colspan="3">Qualified Job Name</th>
<th align="left" valign="bottom" rowspan="2">Internal Job Identifier</th>
<th align="left" valign="bottom" rowspan="2">Internal Spooled File
Identifier</th>
<th align="left" valign="bottom" rowspan="2">Spooled File Name</th>
<th align="left" valign="bottom" rowspan="2">Spooled File Number</th>
<th align="left" valign="bottom" rowspan="2">Job System Name</th>
<th align="left" valign="bottom" rowspan="2">Spooled File Create Date</th>
<th align="left" valign="bottom" rowspan="2">Spooled File Create Time</th>
</tr>
<tr>
<th align="left" valign="bottom">Job Name</th>
<th align="left" valign="bottom">User Name</th>
<th align="left" valign="bottom">Job Number</th>
</tr>
<tr>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">Number</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">-2 through 999999</td>
<td align="left" valign="top">Name, *ONLY, *CURRENT, or *ANY</td>
<td align="left" valign="top">Date, *ONLY, or *LAST</td>
<td align="left" valign="top">Time, blanks, *ONLY, or *LAST</td>
</tr>
<tr>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">-2 through 999999</td>
<td align="left" valign="top">Name, *ONLY, *CURRENT, or *ANY</td>
<td align="left" valign="top">Date, *ONLY, or *LAST</td>
<td align="left" valign="top">Time, blanks, *ONLY, or *LAST</td>
</tr>
<tr>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">-2 through 999999</td>
<td align="left" valign="top">Name, *ONLY, *CURRENT, or *ANY</td>
<td align="left" valign="top">Date, *ONLY, or *LAST</td>
<td align="left" valign="top">Time, blanks, *ONLY, or *LAST</td>
</tr>
<tr>
<td align="left" valign="top">*</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">-2 through 999999</td>
<td align="left" valign="top">Name, *ONLY, *CURRENT, *ANY</td>
<td align="left" valign="top">Date, *ONLY, or *LAST</td>
<td align="left" valign="top">Time, blanks, *ONLY, or *LAST</td>
</tr>
<tr>
<td align="left" valign="top">*INT</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Internal job identifier</td>
<td align="left" valign="top">Internal spooled file identifier</td>
<td align="left" valign="top">*INT</td>
<td align="left" valign="top">-1 through 999999</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
</tr>
<tr>
<td align="left" valign="top">*INT</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Internal job identifier</td>
<td align="left" valign="top">Blanks</td>
<td align="left" valign="top">Name</td>
<td align="left" valign="top">-2 through 999999</td>
<td align="left" valign="top">Name, *ONLY, *CURRENT, or *ANY</td>
<td align="left" valign="top">Date, *ONLY, or *LAST</td>
<td align="left" valign="top">Time, blanks, *ONLY, or *LAST
<p>See Notes for additional information.</p></td>
</tr>
</table>
<p><strong>Notes:</strong> This parameter combination is not valid when a job has been detached from its spooled files or for a spooled file on an independent disk pool. Use of this combination will result in message
CPF3C43.</p>
<br>
<h3>Error Messages</h3>
<table cellpadding="5">
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td width="15%" valign="top">CPF2207 E</td>
<td width="85%" valign="top">Not authorized to use object &amp;1 in library
&amp;3 type *&amp;2.</td>
</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 align="left" valign="top">CPF3CF1 E</td>
<td align="left" valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C1D E</td>
<td align="left" valign="top">Length specified in parameter &amp;1 not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C21 E</td>
<td align="left" valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C33 E</td>
<td align="left" valign="top">Spooled file number &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C40 E</td>
<td align="left" valign="top">Spooled file &amp;4 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C41 E</td>
<td align="left" valign="top">More than one spooled file with same name.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C42 E</td>
<td align="left" valign="top">User name or job number is not blank.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C43 E</td>
<td align="left" valign="top">Internal job identifier is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C44 E</td>
<td align="left" valign="top">Internal spooled file identifier is not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C58 E</td>
<td align="left" valign="top">Job name specified is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C90 E</td>
<td align="left" valign="top">Literal value cannot be changed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33AA E</td>
<td align="left" valign="top">Target spooled file &amp;1 number &amp;2 in job
&amp;5/&amp;4/&amp;3 in open status.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33AB E</td>
<td align="left" valign="top">Target spooled file &amp;1 number &amp;2 in job
&amp;5/&amp;4/&amp;3 in closed status.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33AC E</td>
<td align="left" valign="top">Spooled file &amp;1 number &amp;2 in job
&amp;5/&amp;4/&amp;3 in deferred status.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33AD E</td>
<td align="left" valign="top">Target spooled file &amp;1 not last spooled file
in ready status. Source spooled file not moved.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33AE E</td>
<td align="left" valign="top">Spooled file &amp;1 number &amp;2 in job
&amp;5/&amp;4/&amp;3 not moved.</td>
</tr>
<tr>
<td align="left" valign="top"><img src="delta.gif" alt="Start of change">CPF33AF E</td>
<td align="left" valign="top">Duplicate spooled file &amp;1 number &amp;2 in job &amp;3/&amp;4/&amp;5 found.<img src="deltaend.gif" alt="End of change"></td>
</tr>
<tr>
<td align="left" valign="top">CPF33A6 E</td>
<td align="left" valign="top">Spooled file &amp;1 selected by writer. Spooled
file not moved.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33A8 E</td>
<td align="left" valign="top">Spooled file &amp;1 specified more than once.
Spooled file not moved.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33A9 E</td>
<td align="left" valign="top">Target spooled file &amp;1 changed output queue.
Source spooled file not moved.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33CA E</td>
<td align="left" valign="top">Output queue &amp;1 in library &amp;2 is not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33CB E</td>
<td align="left" valign="top">Priority required to move spooled file exceeds
user's limit.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33C2 E</td>
<td align="left" valign="top">Moving spooled files to the top allowed only for
output queues with SEQ(*FIFO).</td>
</tr>
<tr>
<td align="left" valign="top">CPF33C3 E</td>
<td align="left" valign="top">Priority required to move spooled file exceeds
user's limit.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33C4 E</td>
<td align="left" valign="top">Spooled file &amp;1 held by HLDJOB command.
Spooled file not moved.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33C5 E</td>
<td align="left" valign="top">Target spooled file &amp;1 selected by writer.
Source spooled file not moved.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33C6 E</td>
<td align="left" valign="top">Priority required to move file exceeds user's
limit.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33C7 E</td>
<td align="left" valign="top">Cannot move file ahead of other users'
files.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33C9 E</td>
<td align="left" valign="top">Spooled file name parameter cannot be blank.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3309 E</td>
<td align="left" valign="top">No files named &amp;1 are active.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3330 E</td>
<td align="left" 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 align="left" valign="top">CPF3342 E</td>
<td align="left" valign="top">Job &amp;5/&amp;4/&amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3343 E</td>
<td align="left" valign="top">Duplicate job names found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3344 E</td>
<td align="left" valign="top">File &amp;1 number &amp;2 no longer in the
system.</td>
</tr>
<tr>
<td align="left" valign="top">
CPF335B E</td>
<td align="left" valign="top">Spooled file create date is not blank.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3410 E</td>
<td align="left" valign="top">New output queue &amp;1 in &amp;2 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3492 E</td>
<td align="left" valign="top">Not authorized to spooled file.</td>
</tr>
<tr>
<td align="left" valign="top">CPF8122 E</td>
<td align="left" valign="top">&amp;8 damage on library &amp;4.</td>
</tr>
<tr>
<td align="left" valign="top">CPF8128 E</td>
<td align="left" valign="top">&amp;8 damage on output queue &amp;4 in library
&amp;9.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9872 E</td>
<td align="left" valign="top">Program or service program &amp;1 in library
&amp;2 ended. Reason code &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPI33C2 I</td>
<td align="left" valign="top">Spooled file &amp;1 number &amp;2 in job
&amp;5/&amp;4/&amp;3 not moved to position requested.</td>
</tr>
</table>
<br>
<hr>
API introduced: V3R1
<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>