1721 lines
53 KiB
HTML
1721 lines
53 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>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>
|
|
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>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
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 ------->
|
|
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 ------->
|
|
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 ------->
|
|
B 5
|
|
D 5
|
|
</pre>
|
|
|
|
<br>
|
|
<pre>
|
|
Requester's priority limit = 4
|
|
|
|
file priority
|
|
|
|
E 3
|
|
new priority = 4 when moved here ------->
|
|
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 &1 in library
|
|
&3 type *&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 &1 not
|
|
valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C21 E</td>
|
|
<td align="left" valign="top">Format name &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C33 E</td>
|
|
<td align="left" valign="top">Spooled file number &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C40 E</td>
|
|
<td align="left" valign="top">Spooled file &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 &1 number &2 in job
|
|
&5/&4/&3 in open status.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF33AB E</td>
|
|
<td align="left" valign="top">Target spooled file &1 number &2 in job
|
|
&5/&4/&3 in closed status.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF33AC E</td>
|
|
<td align="left" valign="top">Spooled file &1 number &2 in job
|
|
&5/&4/&3 in deferred status.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF33AD E</td>
|
|
<td align="left" valign="top">Target spooled file &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 &1 number &2 in job
|
|
&5/&4/&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 &1 number &2 in job &3/&4/&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 &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 &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 &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 &1 in library &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 &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 &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 &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 &5/&4/&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 &1 number &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 &1 in &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">&8 damage on library &4.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF8128 E</td>
|
|
<td align="left" valign="top">&8 damage on output queue &4 in library
|
|
&9.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9872 E</td>
|
|
<td align="left" valign="top">Program or service program &1 in library
|
|
&2 ended. Reason code &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPI33C2 I</td>
|
|
<td align="left" valign="top">Spooled file &1 number &2 in job
|
|
&5/&4/&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>
|
|
|