2586 lines
74 KiB
HTML
2586 lines
74 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>List Spooled Files (QUSLSPL) API</title>
|
||
|
<!-- Begin Header Records -->
|
||
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
<!-- US Government Users Restricted Rights -->
|
||
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
<!-- Print SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
|
||
|
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
|
||
|
<!--Edited by Kersten Oct 2001 -->
|
||
|
<!--End Header Records -->
|
||
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
</head>
|
||
|
<body>
|
||
|
<a name="Top_Of_Page"></a>
|
||
|
<!-- Java sync-link -->
|
||
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
</script>
|
||
|
|
||
|
<h2>List Spooled Files (QUSLSPL) API</h2>
|
||
|
|
||
|
<div class="box" style="width: 80%;">
|
||
|
<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%">Qualified user space name</td>
|
||
|
<td align="left" valign="top" width="20%">Input</td>
|
||
|
<td align="left" valign="top" width="20%">Char(20)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">2</td>
|
||
|
<td align="left" valign="top">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">3</td>
|
||
|
<td align="left" valign="top">User name</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(10)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">4</td>
|
||
|
<td align="left" valign="top">Qualified output queue name</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(20)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">5</td>
|
||
|
<td align="left" valign="top">Form type</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(10)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">6</td>
|
||
|
<td align="left" valign="top">User-specified data</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(10)</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
Optional Parameter Group 1:<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
<table width="100%">
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">7</td>
|
||
|
<td align="left" valign="top" width="50%">Error Code</td>
|
||
|
<td align="left" valign="top" width="20%">I/O</td>
|
||
|
<td align="left" valign="top" width="20%">Char(*)</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
Optional Parameter Group 2:<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
<table width="100%">
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">8</td>
|
||
|
<td align="left" valign="top" width="50%">Qualified job name</td>
|
||
|
<td align="left" valign="top" width="20%">Input</td>
|
||
|
<td align="left" valign="top" width="20%">Char(26)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">9</td>
|
||
|
<td align="left" valign="top">Key for the fields to return</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Array(*) of Binary(4)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">10</td>
|
||
|
<td align="left" valign="top">Number of fields to return</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Binary(4)</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
Optional Parameter Group 3:<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
<table width="100%">
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">11</td>
|
||
|
<td align="left" valign="top" width="50%">Auxiliary storage pool</td>
|
||
|
<td align="left" valign="top" width="20%">Input</td>
|
||
|
<td align="left" valign="top" width="20%">Binary(4)</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
Optional Parameter Group 4:<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
<table width="100%">
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">12</td>
|
||
|
<td align="left" valign="top" width="50%">Job system name</td>
|
||
|
<td align="left" valign="top" width="20%">Input</td>
|
||
|
<td align="left" valign="top" width="20%">Char(8)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">13</td>
|
||
|
<td align="left" valign="top">Starting spooled file create date</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(7)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">14</td>
|
||
|
<td align="left" valign="top">Starting spooled file create time</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(6)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">15</td>
|
||
|
<td align="left" valign="top">Ending spooled file create date</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(7)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">16</td>
|
||
|
<td align="left" valign="top">Ending spooled file create time</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(6)</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
<br>
|
||
|
|
||
|
Optional Parameter Group 5:<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
<table width="100%">
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">17</td>
|
||
|
<td align="left" valign="top" width="50%">Auxiliary storage pool device name</td>
|
||
|
<td align="left" valign="top" width="20%">Input</td>
|
||
|
<td align="left" valign="top" width="20%">Char(10)</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
Default Public Authority: *USE <br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
Threadsafe: No<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
</div>
|
||
|
|
||
|
<p>The List Spooled Files (QUSLSPL) API is similar to the Work with Spooled
|
||
|
Files (WRKSPLF) command or the Work with Job (WRKJOB OPTION(*SPLF)) command.
|
||
|
The API generates a list of spooled files on the system and places the list in
|
||
|
a user space. The list can include some of the following:</p>
|
||
|
|
||
|
<ul>
|
||
|
<li>All spooled files</li>
|
||
|
|
||
|
<li>Spooled files of specific users or all users</li>
|
||
|
|
||
|
<li>Spooled files in a specified output queue or in all output queues</li>
|
||
|
|
||
|
<li>Spooled files for all form types or the standard form type</li>
|
||
|
|
||
|
<li>Spooled files that have any user-specified data values</li>
|
||
|
|
||
|
<li>Spooled files generated by a specific job</li>
|
||
|
|
||
|
<li>Spooled files stored in an auxiliary storage pool.</li>
|
||
|
</ul>
|
||
|
|
||
|
<p>The generated list replaces any existing information in the user space.</p>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3>Authorities and Locks</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><em>User Space Authority</em></dt>
|
||
|
|
||
|
<dd>*CHANGE</dd>
|
||
|
|
||
|
<dt><em>Library Authority</em></dt>
|
||
|
|
||
|
<dd>*EXECUTE</dd>
|
||
|
|
||
|
<dt><em>User Space Lock</em></dt>
|
||
|
|
||
|
<dd>*EXCLRD</dd>
|
||
|
</dl>
|
||
|
|
||
|
<br>
|
||
|
<strong>Output Queue Authority</strong>
|
||
|
|
||
|
<p>The requester is authorized to the output queue if one or more of the
|
||
|
following conditions are met:</p>
|
||
|
|
||
|
<ul>
|
||
|
<li>The requester has *SPLCTL authority.</li>
|
||
|
|
||
|
<li>The requester has *JOBCTL authority, and the output queue is specified as
|
||
|
OPRCTL(*YES).</li>
|
||
|
|
||
|
<li>The requester has *READ authority to the output queue.</li>
|
||
|
</ul>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3>Required Parameter Group</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong>Qualified user space name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(20)
|
||
|
|
||
|
<p>The user space that receives the generated list, and the library in which it
|
||
|
is located. The first 10 characters contain the user space name, and the second
|
||
|
10 characters contain the library name.</p>
|
||
|
|
||
|
<p>You can use these special values for the library name:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
||
|
<td align="left" valign="top">The job's current library</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
||
|
<td align="left" valign="top">The library list</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Format name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(8)
|
||
|
|
||
|
<p>The format of the spooled file information being returned. You must specify
|
||
|
the following:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="25 75" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em><a href="#HDRRCDL1A">SPLF0100</a></em></td>
|
||
|
<td align="left" valign="top">Contains the internal identifiers for the spooled
|
||
|
file and the job that owns the spooled file.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em><a href="#HDRRCDL2A">SPLF0200</a></em></td>
|
||
|
<td align="left" valign="top">Information that is shown when the list of the
|
||
|
spooled files selected is displayed with the Work with Spooled Files (WRKSPLF)
|
||
|
command.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em><a href="#HDRRCDL3A">SPLF0300</a></em></td>
|
||
|
<td align="left" valign="top">Contains the basic information for the spooled
|
||
|
file. Entries returned are taken directly from internal indexes and are not
|
||
|
validated against existing spooled file and job structures. Retrieving a list
|
||
|
of spooled files using this format is faster than using format SPLF0100 or
|
||
|
SPLF0200.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>User name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(10)
|
||
|
|
||
|
<p>The name of the user whose spooled files are included in the list. This
|
||
|
parameter can be used in conjunction with the output queue and library name,
|
||
|
form type, user-specified data,
|
||
|
auxiliary storage pool, job system name, starting spooled file create date,
|
||
|
starting spooled file create time, ending spooled file create date, and ending
|
||
|
spooled file create timeparameters to return a partial list of all the spooled files.
|
||
|
The list of spooled files returned is sorted by status, output priority, date,
|
||
|
and time. It must be blank if the qualified job name parameter is
|
||
|
specified.</p>
|
||
|
|
||
|
<p>A value must be specified if the qualified job name parameter is blank or
|
||
|
not specified. Otherwise, message CPF34C6 or CPD34C6 is issued.</p>
|
||
|
|
||
|
<p>The possible special values are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALL</em></td>
|
||
|
<td align="left" valign="top">Files owned by all users</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
||
|
<td align="left" valign="top">Files owned by the current user</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Qualified output queue name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(20)
|
||
|
|
||
|
<p>The name of the output queue whose files are to be included in the list, and
|
||
|
the library in which it is located. The first 10 characters contain the output
|
||
|
queue name, and the second 10 characters contain the library name. This
|
||
|
parameter can be used in conjunction with the user name, form type,
|
||
|
user-specified data, auxiliary
|
||
|
storage pool, job system name, starting spooled file create date, starting
|
||
|
spooled file create time, ending spooled file create date, and ending spooled
|
||
|
file create time parameters to
|
||
|
return a partial list of all the spooled files. The list of spooled files
|
||
|
returned is sorted by status, output priority, date, and time. It must be blank
|
||
|
if the qualified job name parameter is specified.</p>
|
||
|
|
||
|
<p><strong>Note:</strong> A value must be specified if the qualified job name
|
||
|
parameter is blank or not specified. Otherwise, message CPF34C6 or CPD34C6 is
|
||
|
issued.</p>
|
||
|
|
||
|
<p>You can use this special value for the output queue name:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALL</em></td>
|
||
|
<td align="left" valign="top">Files on all output queues. When you use this
|
||
|
value, the library name must be blanks.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>Output queue name</em></td>
|
||
|
<td align="left" valign="top">The name of the output queue.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<p>You can use these special values for the library name:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
||
|
<td align="left" valign="top">The job's current library</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
||
|
<td align="left" valign="top">The library list</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Form type</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(10)
|
||
|
|
||
|
<p>The form type whose files are included in the list. The form type is the
|
||
|
value specified on the form type parameter of the printer file. This parameter
|
||
|
can be used in conjunction with the user name, qualified output queue name,
|
||
|
user-specified data, auxiliary
|
||
|
storage pool, job system name, starting spooled file create date, starting
|
||
|
spooled file create time, ending spooled file create date, and ending spooled
|
||
|
file create time parameters to
|
||
|
return a partial list of all the spooled files. The list of spooled files
|
||
|
returned is sorted by status, output priority, date, and time. It must be blank
|
||
|
if the qualified job name parameter is specified.</p>
|
||
|
|
||
|
<p>The special values supported are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALL</em></td>
|
||
|
<td align="left" valign="top">Files for all form types</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*STD</em></td>
|
||
|
<td align="left" valign="top">Only files that specify the standard form
|
||
|
type</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>User-specified data</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(10)
|
||
|
|
||
|
<p>The user-specified data value whose files are to be included in the list.
|
||
|
This parameter can be used in conjunction with the user name, qualified output
|
||
|
queue name, form type, auxiliary
|
||
|
storage pool, job system name, starting spooled file create date, starting
|
||
|
spooled file create time, ending spooled file create date, and ending spooled
|
||
|
file create time parameters to
|
||
|
return a partial list of all the spooled files. The list of spooled files
|
||
|
returned is sorted by status, output priority, date, and time. It must be blank
|
||
|
if the qualified job name parameter is specified.</p>
|
||
|
|
||
|
<p>The special value supported is:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALL</em></td>
|
||
|
<td align="left" valign="top">Files with any user-specified data values</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
|
||
|
<h3>Optional Parameter Group 1</h3>
|
||
|
|
||
|
<dl>
|
||
|
<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>. If this
|
||
|
parameter is omitted, diagnostic and escape messages are issued to the
|
||
|
application.</p>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3>Optional Parameter Group 2</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong>Qualified job name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(26)
|
||
|
|
||
|
<p>The qualified job name of the job whose spooled files are to be included in
|
||
|
the list. If the user name, the qualified output queue name, the form type,
|
||
|
user-specified data, or auxiliary storage pool is specified, this parameter
|
||
|
must be blank. Otherwise, message CPF34C2 is issued. The list of spooled files
|
||
|
returned is sorted by spooled file number.</p>
|
||
|
|
||
|
<p>The qualified job name has three parts:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>job name</em></td>
|
||
|
<td align="left" valign="top">CHAR(10). A specific job name, or the following
|
||
|
special value:<br>
|
||
|
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em><strong>*</strong></em></td>
|
||
|
<td align="left" valign="top">Current running job.
|
||
|
|
||
|
<p>The rest of the qualified job name parameter must be blank.</p>
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>user name</em></td>
|
||
|
<td align="left" valign="top">CHAR(10). A specific user profile name, or blank
|
||
|
when the job name is asterisk (*).</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>job number</em></td>
|
||
|
<td align="left" valign="top">CHAR(6). A specific job number, or blank when the
|
||
|
job name is asterisk (*).</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>If this parameter is omitted, the API assumes all blanks.</p>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Keys for the fields to return</strong></dt>
|
||
|
|
||
|
<dd>INPUT; ARRAY(*) of BINARY(4)
|
||
|
|
||
|
<p>The list of the fields to be returned in the SPLF0200 format. By specifying
|
||
|
a set of keys, only the fields whose keys are specified are in the returned
|
||
|
format. See <a href="#HDRVALKEYS">Valid Keys</a> for a list of valid keys. This
|
||
|
field is only used for the SPLF0200 format. This field is ignored if the number
|
||
|
of keys for fields to return parameter is 0.</p>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Number of fields to return</strong></dt>
|
||
|
|
||
|
<dd>INPUT; BINARY(4)
|
||
|
|
||
|
<p>The number of fields to return in the SPLF0200 format. This indicates how
|
||
|
many keys are in the array of the keys for the fields to return parameter. This
|
||
|
field is used for the SPLF0200 format only, and it must be 0 when the SPLF0100
|
||
|
or SPLF0300 format is specified.</p>
|
||
|
|
||
|
<p>If this parameter is omitted, the API assumes 0.</p>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
|
||
|
<h3>Optional Parameter Group 3</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong>Auxiliary storage pool (ASP)</strong></dt>
|
||
|
|
||
|
<dd>INPUT; BINARY(4)
|
||
|
|
||
|
<p>The auxiliary storage pool whose spooled files are to be included in the
|
||
|
list. This parameter can be used in conjunction with the user name, qualified
|
||
|
output queue name, form type,
|
||
|
user-specified data, job system name, starting spooled file create date,
|
||
|
starting spooled file create time, ending spooled file create date, and ending
|
||
|
spooled file create time
|
||
|
parameters to return a partial list of all the spooled files. The list of
|
||
|
spooled files returned is sorted by status, output priority, date, and time. It
|
||
|
must be blank if the qualified job name parameter is specified.</p>
|
||
|
|
||
|
<p>The valid values are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>-1</em></td>
|
||
|
<td align="left" valign="top">*BLANK. No auxiliary storage pool is
|
||
|
specified.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>0</em></td>
|
||
|
<td align="left" valign="top">*ALL. Spooled files in all auxiliary
|
||
|
storage pools as specified in the Auxiliary storage pool device name parameter.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
<td align="left" valign="top">*SYSTEM. Spooled files in the system
|
||
|
auxiliary storage pool.</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>-2</em></td>
|
||
|
<td align="left" valign="top">*ASPDEV. Spooled files in the auxiliary
|
||
|
storage pool device specified on the Auxiliary storage pool device name
|
||
|
parameter.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" nowrap><em>2-255</em></td>
|
||
|
<td align="left" valign="top">User auxiliary storage pool (2-32), or a primary or a secondary auxiliary storage pool (33-255).
|
||
|
|
||
|
<p>If this parameter is omitted, the API assumes 0 when the qualified job name
|
||
|
parameter is blank or not specified. The API assumes -1 if the qualified job
|
||
|
name parameter is not blank.</p>
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
|
||
|
<h3>Optional Parameter Group 4</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong>Job system name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; Char(8)
|
||
|
|
||
|
<p>The name of the system where the job, specified in the qualified job name
|
||
|
parameter, was run. This parameter can be used in conjunction with the user
|
||
|
name, qualified output queue name, form type, user-specified data, auxiliary
|
||
|
storage pool, starting spooled file create date, starting spooled file create
|
||
|
time, ending spooled file create date, ending spooled file create time, or
|
||
|
qualified job name parameters to return a partial list of all the spooled
|
||
|
files. The list of spooled files returned is sorted by status, output priority,
|
||
|
date, and time.</p>
|
||
|
|
||
|
<p>The following special values are supported for this parameter:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALL</em></td>
|
||
|
<td align="left" valign="top">The returned list is not to be filtered based on
|
||
|
job system name.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
||
|
<td align="left" valign="top">Only spooled files created on the current system
|
||
|
are to be returned.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>job-system-name</em></td>
|
||
|
<td align="left" valign="top">Only spooled files created on the system
|
||
|
specified are to be returned.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>If this parameter is omitted, the API assumes *ALL.</p>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Starting spooled file create date</strong></dt>
|
||
|
|
||
|
<dd>INPUT; Char(7)
|
||
|
|
||
|
<p>The date the spooled file was created on the system. This parameter can be
|
||
|
used in conjunction with the user name, qualified output queue name, form type,
|
||
|
user-specified data, auxiliary storage pool, job system name, starting spooled
|
||
|
file create time, ending spooled file create date, ending spooled file create
|
||
|
time, or qualified job name parameters to return a partial list of all the
|
||
|
spooled files. The list of spooled files returned is sorted by status, output
|
||
|
priority, date, and time. 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>*ALL</em></td>
|
||
|
<td align="left" valign="top">The returned list is not to be filtered based on
|
||
|
spooled file create date and spooled file create time.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*FIRST</em></td>
|
||
|
<td align="left" valign="top">All spooled files starting with the earliest
|
||
|
create date and time and less than or equal to the ending spooled file create
|
||
|
date and time are to be returned.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>date</em></td>
|
||
|
<td align="left" valign="top">All spooled files with a create date and time
|
||
|
equal to or later than the starting spooled file create date and time and less
|
||
|
than or equal to the ending spooled file create date and time are to be
|
||
|
returned.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<p>The date format CYYMMDD is defined as follows:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>C</em></td>
|
||
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
||
|
and 1 indicates years 20<em>xx</em>.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>YY</em></td>
|
||
|
<td align="left" valign="top">Year</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>MM</em></td>
|
||
|
<td align="left" valign="top">Month</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>DD</em></td>
|
||
|
<td align="left" valign="top">Day</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Starting spooled file create time</strong></dt>
|
||
|
|
||
|
<dd>INPUT; Char(6)
|
||
|
|
||
|
<p>The time the spooled file was created on the system. This parameter can be
|
||
|
used in conjunction with the user name, qualified output queue name, form type,
|
||
|
user-specified data, auxiliary storage pool, job system name, starting spooled
|
||
|
file create date, ending spooled file create date, ending spooled file create
|
||
|
time, or qualified job name parameters to return a partial list of all the
|
||
|
spooled files. The list of spooled files returned is sorted by status, output
|
||
|
priority, date, and time. This parameter must be set to blanks when special
|
||
|
value *ALL or *FIRST is used for parameter Starting spooled file create date.
|
||
|
This parameter must have a value set if a date is specified for parameter
|
||
|
Starting spooled file create date. The time must be in the HHMMSS format.</p>
|
||
|
|
||
|
<p>The time format HHMMSS is defined as follows:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>HH</em></td>
|
||
|
<td align="left" valign="top">Hour</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>MM</em></td>
|
||
|
<td align="left" valign="top">Minutes</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>SS</em></td>
|
||
|
<td align="left" valign="top">Seconds</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Ending spooled file create date</strong></dt>
|
||
|
|
||
|
<dd>INPUT; Char(7)
|
||
|
|
||
|
<p>The date the spooled file was created on the system. This parameter can be
|
||
|
used in conjunction with the user name, qualified output queue name, form type,
|
||
|
user-specified data, auxiliary storage pool, job system name, starting spooled
|
||
|
file create date, starting spooled file create time, ending spooled file create
|
||
|
time, or qualified job name parameters to return a partial list of all the
|
||
|
spooled files. The list of spooled files returned is sorted by status, output
|
||
|
priority, date, and time. If the Starting spooled file create date parameter is
|
||
|
set to *ALL, then this parameter must be set to blanks. If a date has been
|
||
|
specified for the Starting spooled file create date parameter, then this
|
||
|
parameter must be set to a valid date. 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>*LAST</em></td>
|
||
|
<td align="left" valign="top">All spooled files with a create date and time
|
||
|
equal to or later than the starting spooled file create date and time and equal
|
||
|
to the last spooled file create date and time are to be returned.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>date</em></td>
|
||
|
<td align="left" valign="top">All spooled files with a create date and time
|
||
|
equal to or later than the starting spooled file create date and time and less
|
||
|
than or equal to the ending spooled file create date and time are to be
|
||
|
returned.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<p>The date format CYYMMDD is defined as follows:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>C</em></td>
|
||
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
||
|
and 1 indicates years 20<em>xx</em>.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>YY</em></td>
|
||
|
<td align="left" valign="top">Year</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>MM</em></td>
|
||
|
<td align="left" valign="top">Month</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>DD</em></td>
|
||
|
<td align="left" valign="top">Day</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Ending spooled file create time</strong></dt>
|
||
|
|
||
|
<dd>INPUT; Char(6)
|
||
|
|
||
|
<p>The time the spooled file was created on the system. This parameter can be
|
||
|
used in conjunction with the user name, qualified output queue name, form type,
|
||
|
user-specified data, auxiliary storage pool, job system name, starting spooled
|
||
|
file create date, starting spooled file create time, ending spooled file create
|
||
|
date, or qualified job name parameters to return a partial list of all the
|
||
|
spooled files. The list of spooled files returned is sorted by status, output
|
||
|
priority, date, and time. This parameter must be set to blanks when special
|
||
|
value *ALL is used for parameter Starting spooled file create date or when
|
||
|
special value *LAST is used for parameter Ending spooled file create date. This
|
||
|
parameter must have a value set if a date is specified for parameter Ending
|
||
|
spooled file create date. The time must be in the HHMMSS format.</p>
|
||
|
|
||
|
<p>The time format HHMMSS is defined as follows:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>HH</em></td>
|
||
|
<td align="left" valign="top">Hour</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>MM</em></td>
|
||
|
<td align="left" valign="top">Minutes</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>SS</em></td>
|
||
|
<td align="left" valign="top">Seconds</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
|
||
|
|
||
|
<h3>Optional Parameter Group 5</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong>Auxiliary storage pool (ASP) device name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; Char(10)
|
||
|
|
||
|
<p>The auxiliary storage pool device name from which spooled files
|
||
|
are to be included in the list. When 0 or -2 is specified on the Auxiliary
|
||
|
storage pool parameter, this parameter can be used in conjunction
|
||
|
with the user name, qualified output queue name, form type,
|
||
|
user-specified data, job system name, starting spooled file create date,
|
||
|
starting spooled file create time, ending spooled file create date, and
|
||
|
ending spooled file create time parameters to return a partial list of
|
||
|
all the spooled files. The list of spooled files returned is sorted by
|
||
|
status, output priority, date, and time. </p>
|
||
|
|
||
|
<p>The valid values are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*</em></td>
|
||
|
<td align="left" valign="top">Files which are found in the ASPs that are
|
||
|
currently part of the thread's library name space are returned. This
|
||
|
includes the system ASP (ASP 1), all defined basic user ASPs (ASPs 2-32),
|
||
|
and if the thread has an ASP group, the primary and secondary ASPs in
|
||
|
the thread's ASP group.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURASPGRP</em></td>
|
||
|
<td align="left" valign="top">Files which are found in the primary and
|
||
|
secondary ASPs in the thread's ASP group are selected. If no ASP
|
||
|
group is associated with the thread, an error will be issued.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
||
|
<td align="left" valign="top">Files which are found in the system ASP
|
||
|
(ASP 1) and all defined basic user ASPs (ASPs 2-32) are selected.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" nowrap><em>auxiliary storage pool device name</em></td>
|
||
|
<td align="left" valign="top">Files which are found in the specified
|
||
|
primary or secondary ASP are selected. Only primary or secondary
|
||
|
ASPs which are in the thread's ASP group may be specified. If no ASP
|
||
|
group is associated with the thread, an error will be issued.
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
<p>If this parameter is omitted, the API assumes *. When the Qualified job name parameter is specified, all spooled files for the job that are found in the ASPs that are currently part of the caller's library name space are returned.</p>
|
||
|
<br>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3><a name="HDRSPLLIST">Format of the Generated List</a></h3>
|
||
|
|
||
|
<p>The spooled file list consists of:</p>
|
||
|
|
||
|
<ul>
|
||
|
<li>A user area</li>
|
||
|
|
||
|
<li>A generic header</li>
|
||
|
|
||
|
<li>An input parameter section</li>
|
||
|
|
||
|
<li>A header section</li>
|
||
|
|
||
|
<li>A list data section</li>
|
||
|
</ul>
|
||
|
|
||
|
<p>For details about the user area and generic header fields, see <a href=
|
||
|
"../apiref/usf.htm">User Space Format for List APIs</a>. For details about the remaining
|
||
|
items, see the following subtopics. For descriptions of the fields in the list,
|
||
|
see <a href="#HDRSPLFDE">Field Descriptions</a>.</p>
|
||
|
|
||
|
<p>When you retrieve list entry information from a user space, you must use the
|
||
|
entry size returned in the generic header as a displacement to the next list
|
||
|
entry. The size of each entry may be padded at the end. If you do not use the
|
||
|
entry size, the result may not be valid. <!-- For examples of how to process lists,
|
||
|
see <a href="../apiref/apiexmp.htm">API Examples</a>. --><br>
|
||
|
<br>
|
||
|
</p>
|
||
|
|
||
|
<h4><a name="HDRSPLFIP1">Input Parameter Section (Optional Parameter Groups 1
|
||
|
and 2)</a></h4>
|
||
|
|
||
|
<p><strong>Note:</strong> This input parameter section format is used only when
|
||
|
Optional Parameter Group 1 or Optional Parameter Group 2 is specified on the
|
||
|
call to the QUSLSPL API. The order of the fields in the input parameter section
|
||
|
does not match the order of the parameters on the call to the API.</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%">User space name specified</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">User space library name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">20</td>
|
||
|
<td align="center" valign="top">14</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Format name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">28</td>
|
||
|
<td align="center" valign="top">1C</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">38</td>
|
||
|
<td align="center" valign="top">26</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">48</td>
|
||
|
<td align="center" valign="top">30</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue library name specified</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">Form type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">68</td>
|
||
|
<td align="center" valign="top">44</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User-specified data</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">78</td>
|
||
|
<td align="center" valign="top">4E</td>
|
||
|
<td align="left" valign="top">CHAR(26)</td>
|
||
|
<td align="left" valign="top">Qualified job name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">104</td>
|
||
|
<td align="center" valign="top">68</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Number of key fields specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">108</td>
|
||
|
<td align="center" valign="top">6C</td>
|
||
|
<td align="left" valign="top">ARRAY(*) of BINARY(4)</td>
|
||
|
<td align="left" valign="top">Key fields specified</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h4> <a name="HDRSPLFIP2">Input
|
||
|
Parameter Section 2 (Optional Parameter Group 3, 4, and 5)</a></h4>
|
||
|
|
||
|
<p><strong>Note:</strong> This input parameter section format is used only
|
||
|
when Optional Parameter Group 3, 4, or 5 is specified on the call to the
|
||
|
QUSLSPL API. This input parameter section is used if optional parameter
|
||
|
group 3, 4, or 5 is specified on the call to the API. The order of the
|
||
|
fields in the input parameter section does not match the order of the
|
||
|
parameters on the call to the API.</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%">User space name specified</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">User space library name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">20</td>
|
||
|
<td align="center" valign="top">14</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Format name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">28</td>
|
||
|
<td align="center" valign="top">1C</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">38</td>
|
||
|
<td align="center" valign="top">26</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">48</td>
|
||
|
<td align="center" valign="top">30</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue library name specified</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">Form type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">68</td>
|
||
|
<td align="center" valign="top">44</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User-specified data</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">78</td>
|
||
|
<td align="center" valign="top">4E</td>
|
||
|
<td align="left" valign="top">CHAR(26)</td>
|
||
|
<td align="left" valign="top">Qualified job name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">104</td>
|
||
|
<td align="center" valign="top">68</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Offset to key fields specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">108</td>
|
||
|
<td align="center" valign="top">6C</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Number of key fields specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">112</td>
|
||
|
<td align="center" valign="top">70</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Auxiliary storage pool specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">
|
||
|
116</td>
|
||
|
<td align="center" valign="top">74</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Job system name specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">124</td>
|
||
|
<td align="center" valign="top">7C</td>
|
||
|
<td align="left" valign="top">CHAR(7)</td>
|
||
|
<td align="left" valign="top">Starting spooled file create date specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">131</td>
|
||
|
<td align="center" valign="top">83</td>
|
||
|
<td align="left" valign="top">CHAR(6)</td>
|
||
|
<td align="left" valign="top">Starting spooled file create time specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">137</td>
|
||
|
<td align="center" valign="top">89</td>
|
||
|
<td align="left" valign="top">CHAR(7)</td>
|
||
|
<td align="left" valign="top">Ending spooled file create date specified</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">144</td>
|
||
|
<td align="center" valign="top">90</td>
|
||
|
<td align="left" valign="top">CHAR(6)</td>
|
||
|
<td align="left" valign="top">Ending spooled file create time specified </td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">
|
||
|
150</td>
|
||
|
<td align="center" valign="top">96</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Auxiliary storage pool device name specified </td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">ARRAY(*) of BINARY(4)</td>
|
||
|
<td align="left" valign="top">Key fields specified</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h4><a name="HDRSPLFHD1">Header Section</a></h4>
|
||
|
|
||
|
<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%">User 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">Output queue name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">20</td>
|
||
|
<td align="center" valign="top">14</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue library name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">30</td>
|
||
|
<td align="center" valign="top">1E</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User space name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">40</td>
|
||
|
<td align="center" valign="top">28</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User space library name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">50</td>
|
||
|
<td align="center" valign="top">32</td>
|
||
|
<td align="left" valign="top">CHAR(26)</td>
|
||
|
<td align="left" valign="top">Qualified job name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">
|
||
|
76</td>
|
||
|
<td align="center" valign="top">4C</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Qualified job system name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">84</td>
|
||
|
<td align="center" valign="top">54</td>
|
||
|
<td align="left" valign="top">CHAR(7)</td>
|
||
|
<td align="left" valign="top">Starting spooled file create date used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">91</td>
|
||
|
<td align="center" valign="top">5B</td>
|
||
|
<td align="left" valign="top">CHAR(6)</td>
|
||
|
<td align="left" valign="top">Starting spooled file create time used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">97</td>
|
||
|
<td align="center" valign="top">61</td>
|
||
|
<td align="left" valign="top">CHAR(7)</td>
|
||
|
<td align="left" valign="top">Ending spooled file create date used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">104</td>
|
||
|
<td align="center" valign="top">68</td>
|
||
|
<td align="left" valign="top">CHAR(6)</td>
|
||
|
<td align="left" valign="top">Ending spooled file create time used </td>
|
||
|
</tr>
|
||
|
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3><a name="HDRRCDL1A">Format SPLF0100</a></h3>
|
||
|
|
||
|
<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%">User 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">Output queue name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">20</td>
|
||
|
<td align="center" valign="top">14</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue library name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">30</td>
|
||
|
<td align="center" valign="top">1E</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Form type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">40</td>
|
||
|
<td align="center" valign="top">28</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User-specified data</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">50</td>
|
||
|
<td align="center" valign="top">32</td>
|
||
|
<td align="left" valign="top">CHAR(16)</td>
|
||
|
<td align="left" valign="top">Internal job identifier</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">66</td>
|
||
|
<td align="center" valign="top">42</td>
|
||
|
<td align="left" valign="top">CHAR(16)</td>
|
||
|
<td align="left" valign="top">Internal spooled file identifier</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">82</td>
|
||
|
<td align="center" valign="top">52</td>
|
||
|
<td align="left" valign="top">CHAR(2)</td>
|
||
|
<td align="left" valign="top">Reserved</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">84</td>
|
||
|
<td align="center" valign="top">54</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Auxiliary storage pool</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3><a name="HDRRCDL2A">Format SPLF0200</a></h3>
|
||
|
|
||
|
<table border width="80%">
|
||
|
<tr>
|
||
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
||
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
||
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<th align="center" valign="bottom">Dec</th>
|
||
|
<th align="center" valign="bottom">Hex</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">0</td>
|
||
|
<td align="center" valign="top" width="10%">0</td>
|
||
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
||
|
<td align="left" valign="top" width="60%">Number of fields returned</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" colspan="2" rowspan="7">Offsets vary. These
|
||
|
fields repeat, in the order listed, for each key field selected.</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Length of field information returned</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Key field for field returned</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Type of data</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CHAR(3)</td>
|
||
|
<td align="left" valign="top">Reserved</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Length of data returned</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Data</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Reserved</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h4><a name="HDRVALKEYS">Valid Keys</a></h4>
|
||
|
|
||
|
<table border width="80%">
|
||
|
<tr>
|
||
|
<th align="center" valign="bottom">Key</th>
|
||
|
<th align="left" valign="bottom">Type</th>
|
||
|
<th align="left" valign="bottom">Field</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="20%">201</td>
|
||
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">Spooled file name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">202</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Job name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">203</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">204</td>
|
||
|
<td align="left" valign="top">CHAR(6)</td>
|
||
|
<td align="left" valign="top">Job number</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">205</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Spooled file number</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">206</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">207</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue library name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">208</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Device</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">209</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User-specified data</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">210</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Status</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">211</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Total pages</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">212</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Current page</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">213</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Copies left to produce</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">214</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Form type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">215</td>
|
||
|
<td align="left" valign="top">CHAR(2)</td>
|
||
|
<td align="left" valign="top">Priority</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">216</td>
|
||
|
<td align="left" valign="top">CHAR(7)</td>
|
||
|
<td align="left" valign="top">Date file was opened (created)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">217</td>
|
||
|
<td align="left" valign="top">CHAR(6)</td>
|
||
|
<td align="left" valign="top">Time file was opened (created)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">218</td>
|
||
|
<td align="left" valign="top">CHAR(16)</td>
|
||
|
<td align="left" valign="top">Internal job identifier</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">219</td>
|
||
|
<td align="left" valign="top">CHAR(16)</td>
|
||
|
<td align="left" valign="top">Internal spooled file identifier</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">220</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Device type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">221</td>
|
||
|
<td align="left" valign="top">CHAR(7)</td>
|
||
|
<td align="left" valign="top">Date file last used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">222</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Spooled file size multiplier</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">223</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Size of spooled file</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">224</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Auxiliary storage pool</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">
|
||
|
225</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Job system name </td>
|
||
|
</tr>
|
||
|
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">
|
||
|
226</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Auxiliary storage pool device name </td>
|
||
|
</tr>
|
||
|
|
||
|
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3><a name="HDRRCDL3A">Format SPLF0300</a></h3>
|
||
|
|
||
|
<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%">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">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">Job number</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">26</td>
|
||
|
<td align="center" valign="top">1A</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Spooled file name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">36</td>
|
||
|
<td align="center" valign="top">24</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Spooled file number</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">40</td>
|
||
|
<td align="center" valign="top">28</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Spooled file status</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">44</td>
|
||
|
<td align="center" valign="top">2C</td>
|
||
|
<td align="left" valign="top">CHAR(7)</td>
|
||
|
<td align="left" valign="top">Date file was opened (created)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">51</td>
|
||
|
<td align="center" valign="top">33</td>
|
||
|
<td align="left" valign="top">CHAR(6)</td>
|
||
|
<td align="left" valign="top">Time file was opened (created)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">57</td>
|
||
|
<td align="center" valign="top">39</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Spooled file schedule</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">58</td>
|
||
|
<td align="center" valign="top">3A</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Spooled file system name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">68</td>
|
||
|
<td align="center" valign="top">44</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">User-specified data</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">78</td>
|
||
|
<td align="center" valign="top">4E</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Form type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">88</td>
|
||
|
<td align="center" valign="top">58</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">98</td>
|
||
|
<td align="center" valign="top">62</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Output queue library name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">108</td>
|
||
|
<td align="center" valign="top">6C</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Auxiliary storage pool</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">112</td>
|
||
|
<td align="center" valign="top">70</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Size of spooled file</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">116</td>
|
||
|
<td align="center" valign="top">74</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Spooled file size multiplier</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">120</td>
|
||
|
<td align="center" valign="top">78</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Total pages</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">124</td>
|
||
|
<td align="center" valign="top">7C</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Copies left to produce</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">128</td>
|
||
|
<td align="center" valign="top">80</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Priority</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">129</td>
|
||
|
<td align="center" valign="top">81</td>
|
||
|
<td align="left" valign="top">CHAR(3)</td>
|
||
|
<td align="left" valign="top">Reserved</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">132</td>
|
||
|
<td align="center" valign="top">84</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Internet print protocol job identifier
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3><a name="HDRSPLFDE">Field Descriptions</a></h3>
|
||
|
|
||
|
<p><strong>Auxiliary storage pool.</strong> The auxiliary storage pool in which
|
||
|
the spooled file resides.</p>
|
||
|
|
||
|
<p>Valid values are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
<td align="left" valign="top">*SYSTEM. System auxiliary storage pool</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" nowrap><em>2-255</em></td>
|
||
|
<td align="left" valign="top">The number of the auxiliary storage
|
||
|
pool.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
<p><strong>Auxiliary storage pool device name.</strong> The name of the auxiliary storage pool device in which
|
||
|
the spooled file resides.</p>
|
||
|
|
||
|
<p>Valid values are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
||
|
<td align="left" valign="top">The spooled file resides in the system ASP
|
||
|
(ASP 1) or one of the defined basic user ASPs (ASPs 2-32). </td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" nowrap><em>auxiliary storage pool device name</em></td>
|
||
|
<td align="left" valign="top">The name of the auxiliary storage
|
||
|
pool device in which the spooled file resides.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<p><strong>Auxiliary storage pool device name specified.</strong> The
|
||
|
auxiliary storage pool device name specified in the call to the API.</p>
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<p><strong>Auxiliary storage pool specified.</strong> The auxiliary storage
|
||
|
pool specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Copies left to produce.</strong> The remaining number of copies to
|
||
|
be produced on the writer. This attribute applies to printer device type
|
||
|
spooled files only.</p>
|
||
|
|
||
|
<p><strong>Current page.</strong> The page number or record number currently
|
||
|
being written. The page number may be lower or higher than the page number
|
||
|
actually being printed because of buffering done by the system. For example, if
|
||
|
the spooled file is routed to a diskette unit or the writer is currently
|
||
|
printing job separators or file separators for the spooled file, the page
|
||
|
number shown may be zero.</p>
|
||
|
|
||
|
<p><strong>Data.</strong> The data returned for the key field.</p>
|
||
|
|
||
|
<p><strong>Date file last used.</strong> The date that the file was last used
|
||
|
in the CYYMMDD format.</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top">C</td>
|
||
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
||
|
and 1 indicates years 20<em>xx</em>.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">YY</td>
|
||
|
<td align="left" valign="top">Year</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">MM</td>
|
||
|
<td align="left" valign="top">Month</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">DD</td>
|
||
|
<td align="left" valign="top">Day</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Date file was opened (created).</strong> The date that the file was
|
||
|
opened in the CYYMMDD format.</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top">C</td>
|
||
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
||
|
and 1 indicates years 20<em>xx</em>.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">YY</td>
|
||
|
<td align="left" valign="top">Year</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">MM</td>
|
||
|
<td align="left" valign="top">Month</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">DD</td>
|
||
|
<td align="left" valign="top">Day</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Device.</strong> The name of the device on which the spooled file is
|
||
|
located. If the spooled file is on an output queue that is the default output
|
||
|
queue of a printer, this field contains the name of the output queue.
|
||
|
Otherwise, this field is blank.</p>
|
||
|
|
||
|
<p><strong>Device type.</strong> The type of device for which the spooled file
|
||
|
is intended. The possible values are PRINTER or DISKETTE.</p>
|
||
|
|
||
|
<p><strong>Ending spooled file
|
||
|
create date specified.</strong> The spooled file create date specified in the
|
||
|
call to the API.</p>
|
||
|
|
||
|
<p><strong>Ending spooled file create date used.</strong> The spooled file
|
||
|
create date used by the API to generate the list of spooled files.</p>
|
||
|
|
||
|
<p><strong>Ending spooled file create time specified.</strong> The spooled file
|
||
|
create time specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Ending spooled file create time used.</strong> The spooled file
|
||
|
create time used by the API to generate the list of spooled files. </p>
|
||
|
|
||
|
<p><strong>Form type.</strong> The type of form to load in the printer to print
|
||
|
this file. This attribute applies to printer device type spooled files
|
||
|
only.</p>
|
||
|
|
||
|
<p><strong>Format name.</strong> The format of the retrieved output.</p>
|
||
|
|
||
|
<p><strong>Job name.</strong> The name of the job that owns the spooled
|
||
|
file.</p>
|
||
|
|
||
|
<p><strong>Job number.</strong> The number of the job that owns the spooled
|
||
|
file.</p>
|
||
|
|
||
|
<p><strong>Job system
|
||
|
name.</strong> The name of the system where the job that created the spooled
|
||
|
file ran.</p>
|
||
|
|
||
|
<p><strong>Job system name specified.</strong> The name of the system where the
|
||
|
qualified job, specified in the call to the API, was run. </p>
|
||
|
|
||
|
<p><strong>Key field for field returned.</strong> The identifier of the field
|
||
|
returned. See <a href="#HDRVALKEYS">Valid Keys</a> for a list of valid keys.
|
||
|
The fields in the list data section are returned in the order specified by the
|
||
|
key fields specified parameter for each spooled file in the list.</p>
|
||
|
|
||
|
<p><strong>Key fields specified.</strong> The list of fields to return in the
|
||
|
SPLF0200 format specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Internal job identifier.</strong> The internal identifier for the
|
||
|
job. Only the i5/OS APIs use this identifier, not any other interface on the
|
||
|
system. The identifier is not valid following an initial program load (IPL). If
|
||
|
you attempt to use it after an IPL, an exception occurs. This identifier is always valid when used with the internal spooled file identifier as input to i5/OS APIs. For spooled files which have been detached from their jobs or which are on independent disk pools, this value is invalid as input to some i5/OS APIs such as <a href="qusrjobi.htm">Retrieve Job Information</a> (QUSRJOBI) that take this value without the internal spooled file identifier.</p>
|
||
|
|
||
|
<p><strong>Internal spooled file identifier.</strong> The input value that
|
||
|
other programs use to improve the performance of locating the spooled file on
|
||
|
the system. Only the spooled file APIs use this identifier, not any other
|
||
|
interface on the system. The identifier is not valid following an initial
|
||
|
program load (IPL). If you attempt to use it after an IPL, an exception
|
||
|
occurs.</p>
|
||
|
|
||
|
<p><strong>Internet print protocol job identifier.</strong> The IPP job
|
||
|
identifier assigned by the system based on the output queue to which the
|
||
|
file was added or moved. This value ranges from 1 to 2147483647 and is not
|
||
|
guaranteed to be unique for a given output queue.</p>
|
||
|
|
||
|
<p><strong>Length of data returned.</strong> The length of the data returned
|
||
|
for the field.</p>
|
||
|
|
||
|
<p><strong>Length of field information returned.</strong> The total length of
|
||
|
information returned for this field.</p>
|
||
|
|
||
|
<p><strong>Number of fields returned.</strong> This is the number of fields
|
||
|
returned to the application.</p>
|
||
|
|
||
|
<p><strong>Number of key fields specified.</strong> The number of fields to
|
||
|
return in format SPLF0200 specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Offset to key fields specified.</strong> The offset to the keys of
|
||
|
the fields to be returned that is specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Output queue library name specified.</strong> The name of the output
|
||
|
queue library specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Output queue library name.</strong> The library where the output
|
||
|
queue is located.</p>
|
||
|
|
||
|
<p><strong>Output queue name specified.</strong> The name of the output queue
|
||
|
specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Output queue name.</strong> The name of the output queue in which
|
||
|
the file is located.</p>
|
||
|
|
||
|
<p><strong>Priority.</strong> The priority of the spooled file. The priority
|
||
|
ranges from 1 (highest) to 9 (lowest).</p>
|
||
|
|
||
|
<p><strong>Qualified job name specified.</strong> The qualified name of the job
|
||
|
specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Qualified job name.</strong> The qualified name of the job that
|
||
|
owns the spooled files.</p>
|
||
|
|
||
|
<p><strong>Qualified job system
|
||
|
name.</strong> The name of the system the qualified job was run on. </p>
|
||
|
|
||
|
<p><strong>Reserved.</strong> The field is reserved.</p>
|
||
|
|
||
|
<p><strong>Size of spooled file.</strong> The spooled file size. Multiply this
|
||
|
field by the spooled file size multiplier field to get the size of the spooled
|
||
|
file in number of bytes. The spooled file size is the data stream size plus the
|
||
|
"overhead" storage used to store the spooled file's data stream, which includes
|
||
|
the spooled file's attributes.</p>
|
||
|
|
||
|
<p><strong>Spooled file name.</strong> The name of the spooled file in the list
|
||
|
entry.</p>
|
||
|
|
||
|
<p><strong>Spooled file number.</strong> The number of the spooled file in the
|
||
|
list entry.</p>
|
||
|
|
||
|
<p><strong>Spooled file schedule.</strong> The schedule of the spooled
|
||
|
file.</p>
|
||
|
|
||
|
<p>Valid values are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
<td align="left" valign="top">The spooled file is schedule immediate. A
|
||
|
spooling writer can process the spooled file immediately.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>2</em></td>
|
||
|
<td align="left" valign="top">The spooled file is schedule file end. A spooling
|
||
|
writer cannot process the spooled file until it has been closed.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>3</em></td>
|
||
|
<td align="left" valign="top">The spooled file is schedule job end. A spooling
|
||
|
writer cannot process the spooled file until the job of the spooled file has
|
||
|
ended.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Spooled file size multiplier.</strong> This value must be multiplied
|
||
|
by the size of spooled file field to get the size of the spooled file in number
|
||
|
of bytes.</p>
|
||
|
|
||
|
<p><strong>Spooled file status.</strong> The status of the file. The following
|
||
|
list of values is used to describe the status of the file:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
<td align="left" valign="top">RDY The file is available to be written to an
|
||
|
output device by a writer.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>2</em></td>
|
||
|
<td align="left" valign="top">OPN The file has not been processed completely and
|
||
|
is not ready to be selected by a writer.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>3</em></td>
|
||
|
<td align="left" valign="top">CLO The file has been processed completely by a
|
||
|
program, but SCHEDULE(*JOBEND) was specified. The job that produced the spooled
|
||
|
file has not finished.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>4</em></td>
|
||
|
<td align="left" valign="top">SAV The file has been written and then saved. This
|
||
|
file remains saved until it is released.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>5</em></td>
|
||
|
<td align="left" valign="top">WTR This file currently is being produced by the
|
||
|
writer on an output device.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>6</em></td>
|
||
|
<td align="left" valign="top">HLD The file has been held.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>7</em></td>
|
||
|
<td align="left" valign="top">MSGW This file has a message that needs a reply or
|
||
|
needs an action to be taken.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>8</em></td>
|
||
|
<td align="left" valign="top">PND This file is pending (waiting) to be
|
||
|
printed.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>9</em></td>
|
||
|
<td align="left" valign="top">PRT The file has been sent to the printer
|
||
|
completely, but the print complete status has not been sent back.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>10</em></td>
|
||
|
<td align="left" valign="top">FIN This spooled file is no longer in the system.
|
||
|
These spooled files are included in the list of spooled files only if the
|
||
|
qualified job name is specified.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>11</em></td>
|
||
|
<td align="left" valign="top">SND This spooled file is being sent or has been
|
||
|
sent to a remote system.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>12</em></td>
|
||
|
<td align="left" valign="top">DFR This spooled file has been deferred from
|
||
|
printing.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<p><strong>Spooled file system name.</strong> The name of the system where the job that created the spooled file
|
||
|
ran.</p>
|
||
|
|
||
|
<p><strong>Starting spooled file create date specified.</strong> The
|
||
|
spooled file create date specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Starting spooled file create date used.</strong> The spooled
|
||
|
file create date used by the API to generate the list of spooled files.</p>
|
||
|
|
||
|
<p><strong>Starting spooled file create time specified.</strong> The spooled
|
||
|
file create time specified in the call to the API.</p>
|
||
|
|
||
|
<p><strong>Starting spooled file create time used.</strong> The spooled file
|
||
|
create time used by the API to generate the list of spooled files. </p>
|
||
|
|
||
|
<p><strong>Status.</strong> The status of the file. The following list of
|
||
|
values is used to describe the status of the file:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*CLOSED</td>
|
||
|
<td align="left" valign="top">The file has been completely processed by a
|
||
|
program, but SCHEDULE(*JOBEND) was specified. The job that produced the spooled
|
||
|
file has not finished.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*DEFERRED</td>
|
||
|
<td align="left" valign="top">This spooled file has been deferred from
|
||
|
printing.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*SENDING</td>
|
||
|
<td align="left" valign="top">This spooled file is being sent or has been sent
|
||
|
to a remote system.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*FINISHED</td>
|
||
|
<td align="left" valign="top">This spooled file is no longer in the system.
|
||
|
These spooled files are included in the list of spooled files only if the
|
||
|
qualified job name is specified.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*HELD</td>
|
||
|
<td align="left" valign="top">The file has been held.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*MESSAGE</td>
|
||
|
<td align="left" valign="top">This file has a message that needs a reply or
|
||
|
needs an action to be taken.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*OPEN</td>
|
||
|
<td align="left" valign="top">The file has not been completely processed and is
|
||
|
not ready to be selected by a writer.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*PENDING</td>
|
||
|
<td align="left" valign="top">This file is pending (waiting) to be
|
||
|
printed.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*PRINTER</td>
|
||
|
<td align="left" valign="top">The file has been completely sent to the printer,
|
||
|
but the print complete status has not been sent back.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*READY</td>
|
||
|
<td align="left" valign="top">The file is available to be written to an output
|
||
|
device by a writer.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*SAVED</td>
|
||
|
<td align="left" valign="top">The file has been written and then saved. This
|
||
|
file remains saved until it is released.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">*WRITING</td>
|
||
|
<td align="left" valign="top">This file is currently being produced by the
|
||
|
writer on an output device.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Time file was opened (created).</strong> The time that the file was
|
||
|
opened in the HHMMSS format.</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="10 90" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>HH</em></td>
|
||
|
<td align="left" valign="top">Hour</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>MM</em></td>
|
||
|
<td align="left" valign="top">Minute</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>SS</em></td>
|
||
|
<td align="left" valign="top">Second</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<p><strong>Total pages.</strong> The number of pages this printer file contains
|
||
|
or the number of records this diskette file contains.</p>
|
||
|
|
||
|
<p><strong>Type of data.</strong> The type of data returned.</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>C</em></td>
|
||
|
<td align="left" valign="top">The data is returned in character format.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>B</em></td>
|
||
|
<td align="left" valign="top">The data is returned in binary format</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<p><strong>User name.</strong> The name of the user that owns the spooled
|
||
|
file.</p>
|
||
|
|
||
|
<p><strong>User name specified.</strong> The name of the user specified in the
|
||
|
call to the API.</p>
|
||
|
|
||
|
<p><strong>User space library name.</strong> The library containing the user
|
||
|
space.</p>
|
||
|
|
||
|
<p><strong>User space library name specified.</strong> The library name of the
|
||
|
user space specified.</p>
|
||
|
|
||
|
<p><strong>User space name.</strong> The name of the user space that contains
|
||
|
the format returned.</p>
|
||
|
|
||
|
<p><strong>User space name specified.</strong> The name of the user space
|
||
|
specified.</p>
|
||
|
|
||
|
<p><strong>User-specified data.</strong></p>
|
||
|
|
||
|
<p>The 10 characters of user-specified data that describe the file.</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">CPF24B4 E</td>
|
||
|
<td width="85%" 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">CPF3C20 E</td>
|
||
|
<td align="left" valign="top">Error found by program &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPD3C21 D</td>
|
||
|
<td align="left" valign="top">Format name &1 is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPD3C30 D</td>
|
||
|
<td align="left" valign="top">Library name &1 is not valid for output queue
|
||
|
*ALL.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPD34C6 D</td>
|
||
|
<td align="left" valign="top">Too few selection criteria specified.</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">CPF3C30 E</td>
|
||
|
<td align="left" valign="top">Library name &1 is not valid for output queue
|
||
|
*ALL.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3C36 E</td>
|
||
|
<td align="left" valign="top">Number of parameters, &1, entered for this
|
||
|
API was 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">CPF33FA E</td>
|
||
|
<td align="left" valign="top">Auxiliary storage pool specified is not
|
||
|
valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3330 E</td>
|
||
|
<td align="left" valign="top">Necessary resource not available.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3336 E</td>
|
||
|
<td align="left" valign="top">Job &5/&4/&3 no longer in the
|
||
|
system.</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">CPF3350 E</td>
|
||
|
<td align="left" valign="top">Job &5/&4/&3 no longer in the
|
||
|
system.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF335D E</td>
|
||
|
<td valign="top">Job system name is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF335E E</td>
|
||
|
<td valign="top">Starting spooled file create date is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF335F E</td>
|
||
|
<td valign="top">Starting spooled file create time is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF336C E</td>
|
||
|
<td valign="top">Starting spooled file create time is not blank.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF336D E</td>
|
||
|
<td valign="top">Ending spooled file create date is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF336E E</td>
|
||
|
<td valign="top">Ending spooled file create date is not blank.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF336F E</td>
|
||
|
<td valign="top">Ending spooled file create time is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF337A E</td>
|
||
|
<td valign="top">Ending spooled file create time is not blank.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF337E E</td>
|
||
|
<td align="left" valign="top">ASP device &1 not in current ASP group for thread.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF338B E</td>
|
||
|
<td align="left" valign="top">ASP device &1 not allowed with ASP
|
||
|
number &2.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF34C1 E</td>
|
||
|
<td align="left" valign="top">Value &1 in keys for fields to return
|
||
|
parameter not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF34C2 E</td>
|
||
|
<td align="left" valign="top">Too many selection criteria specified.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF34C4 E</td>
|
||
|
<td align="left" valign="top">List is too large for user space &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF34C6 E</td>
|
||
|
<td align="left" valign="top">Too few selection criteria specified.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF811A E</td>
|
||
|
<td align="left" valign="top">User space &4 in &9 damaged.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9801 E</td>
|
||
|
<td align="left" valign="top">Object &2 in library &3 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9802 E</td>
|
||
|
<td align="left" valign="top">Not authorized to object &2 in &3.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9803 E</td>
|
||
|
<td align="left" valign="top">Cannot allocate object &2 in library
|
||
|
&3.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9807 E</td>
|
||
|
<td align="left" valign="top">One or more libraries in library list
|
||
|
deleted.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9808 E</td>
|
||
|
<td align="left" valign="top">Cannot allocate one or more libraries on library
|
||
|
list.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9810 E</td>
|
||
|
<td align="left" valign="top">Library &1 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9820 E</td>
|
||
|
<td align="left" valign="top">Not authorized to use library &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9830 E</td>
|
||
|
<td align="left" valign="top">Cannot assign library &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9833 E</td>
|
||
|
<td align="left" valign="top">*CURASPGRP or *ASPGRPPRI specified and
|
||
|
thread has no ASP group.
|
||
|
</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9838 E</td>
|
||
|
<td align="left" valign="top">User profile storage limit exceeded.</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>
|
||
|
</table>
|
||
|
|
||
|
<hr>
|
||
|
API Introduced: V1R3
|
||
|
|
||
|
<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>
|
||
|
|