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

1939 lines
51 KiB
HTML
Raw Permalink Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>List Job (QUSLJOB) 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. -->
<!-- QUSLJOB SCRIPT A converted by B2H R4.1 (346) (CMS) by PMHALL at -->
<!-- RCHVMW2 on 6 Oct 1998 at 22:48:34 -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- File cleanup completed on 10 July 2001 -->
<!-- File cleanup completed Feb 2002 by v2cdijab -->
<!-- 040315 WDTARARA Add LOGOUTPUT -->
<!-- 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 Job (QUSLJOB) API</h2>
<div class="box" style="width: 80%;">
<br>
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="30%">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">Qualified job name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(26)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Status</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Optional Parameter Group 1:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">5</td>
<td align="left" valign="top" width="30%">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>
&nbsp;&nbsp;Optional Parameter Group 2:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">6</td>
<td align="left" valign="top" width="30%">Job type</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(1)</td>
</tr>
<tr>
<td align="center" valign="top">7</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>
<tr>
<td align="center" valign="top">8</td>
<td align="left" valign="top">Key of fields to return</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Array(*) of Binary(4)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Optional Parameter Group 3:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">9</td>
<td align="left" valign="top" width="30%">Continuation handle</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(48)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Conditional; see <a href="#Header_13">Usage Notes.</a><br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The List Job (QUSLJOB) API generates a list of all or some jobs on the
system. The generated list replaces any existing list in the user space.</p>
<p>The QUSLJOB API produces a list similar to the list produced by the Work
with User Job (WRKUSRJOB) command.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>User Space Authority</em></dt>
<dd>*CHANGE<br><br></dd>
<dt><em>Library Authority</em></dt>
<dd>*EXECUTE<br><br></dd>
<dt><em>User Space Lock</em></dt>
<dd>*EXCLRD<br><br></dd>
<dt><em>Job Authority</em></dt>
<dd>If format JOBL0200 is specified, then for each job for which information is
retrieved, the caller of the API must be running under a user profile that is
the same as the job user identity of the job for which the information is being
retrieved. Otherwise, the caller of the API must be running under a user
profile that has job control (*JOBCTL) special authority.
<p>The <strong>job user identity</strong> is the name of the user profile by
which a job is known to other jobs. It is described in more detail in the
<a href="../rzaks/rzaks1.htm">Work Management</a> topic.</p>
</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Qualified user space name</strong></dt>
<dd>INPUT; CHAR(20)
<p>The user space that is to receive 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. 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 job list to be returned. If format JOBL0200 is specified,
the fields that were selected by the caller will be returned for each job in
the list. This format is slower than the JOBL0100 format. The performance will
vary depending on the number of fields selected.</p>
<p>You must use one of the following format names:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>JOBL0100</em></td>
<td align="left" valign="top">Basic job list.</td>
</tr>
<tr>
<td align="left" valign="top"><em>JOBL0200</em></td>
<td align="left" valign="top">Basic job list with keyed return fields.</td>
</tr>
</table>
<p>For more information, see <a href="#HDRSPLISTA">Format of the Generated
List</a>.</p>
</dd>
<dt><strong>Qualified job name</strong></dt>
<dd>INPUT; CHAR(26)
<p>The name of the job to be included in the list. 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, a generic name, or
one of the following special values:<br>
<br>
<table cellpadding="5">
<tr>
<td align="left" valign="top"><em>*</em></td>
<td align="left" valign="top">Only the job that this program is running in. The
rest of the qualified job name parameter must be blank.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CURRENT</em></td>
<td align="left" valign="top">All jobs with the current job's name.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">All jobs. The rest of the job name parameter must
be specified.</td>
</tr>
</table>
<br>
</td>
</tr>
<tr>
<td align="left" valign="top" nowrap><em>User name</em></td>
<td align="left" valign="top">CHAR(10). A specific user profile name, a generic
name, or one of the following special values:<br>
<br>
<table cellpadding="5">
<tr>
<td align="left" valign="top"><em>*CURRENT</em></td>
<td align="left" valign="top">Jobs with the current job's user profile.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">Jobs with the specified job name, regardless of
the user name. The rest of the job name parameter must be specified.</td>
</tr>
</table>
<br>
</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 the following
special value:<br>
<br>
<table cellpadding="5">
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">Jobs with the specified job name and user name,
regardless of the job number. The rest of the job name parameter must be
specified.</td>
</tr>
</table>
</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Status</strong></dt>
<dd>INPUT; CHAR(10)
<p>The status of the jobs to be included in the list. The special values
supported are:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*ACTIVE</em></td>
<td align="left" valign="top">Active jobs. This includes group jobs, system
request jobs, and disconnected jobs.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*JOBQ</em></td>
<td align="left" valign="top">Jobs currently on job queues.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OUTQ</em></td>
<td align="left" valign="top">Jobs that have completed running but still have
output on an output queue or the job's job log has not yet been written.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">All jobs, regardless of status.</td>
</tr>
</table>
</dd>
</dl>
<br>
<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>Job type</strong></dt>
<dd>INPUT; CHAR(1)
<p>The type of job to be listed. Refer to <a href="qusrjobi.htm#HDRWRKJOB">
Comparing Job Type and Subtype with the Work with Active Job Command</a> in the
Retrieve Job Information (QUSRJOBI) API for information about how the job type
field and the job subtype field equate to the type field in the Work with
Active Job (WRKACTJOB) command.</p>
<p>The possible values for this parameter are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>*</em></td>
<td align="left" valign="top">This value lists all job types.</td>
</tr>
<tr>
<td align="left" valign="top"><em>A</em></td>
<td align="left" valign="top">The job is an autostart job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>B</em></td>
<td align="left" valign="top">The job is a batch job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>I</em></td>
<td align="left" valign="top">The job is an interactive job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>M</em></td>
<td align="left" valign="top">The job is a subsystem monitor job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>R</em></td>
<td align="left" valign="top">The job is a spooled reader job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>S</em></td>
<td align="left" valign="top">The job is a system job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>W</em></td>
<td align="left" valign="top">The job is a spooled writer job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>X</em></td>
<td align="left" valign="top">The job is the start-control-program-function
(SCPF) system job.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Number of fields to return</strong></dt>
<dd>INPUT; BINARY(4)
<p>The number of fields to return in the JOBL0200 format. This parameter is
only used for the JOBL0200 format. If JOBL0100 is specified for the format
name, the value must be zero.</p>
</dd>
<dt><strong>Key of fields to be returned</strong></dt>
<dd>INPUT; ARRAY(*) of BINARY(4)
<p>The list of the fields to be returned in the JOBL0200 format. For a list of
the valid fields, see <a href="#HDRLKEYS">Valid Keys</a>. This parameter is
used for the JOBL0200 format only. If JOBL0100 is specified for the format
name, the value must be zero.</p>
</dd>
</dl>
<br>
<h3>Optional Parameter Group 3</h3>
<dl>
<dt><strong>Continuation handle</strong></dt>
<dd>INPUT; CHAR(48)
<p>The value returned to the user in the header section when a partial list is
returned. The possible values are:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">This starts at the beginning of the list. This
value is used if this parameter is omitted.</td>
</tr>
<tr>
<td align="left" valign="top"><em>value</em></td>
<td align="left" valign="top">The entries after this value matching the job
name specified are returned in the list. For more information on using this
value to process a partial list, see <a href="../apiref/usf.htm#HDRPARTLST">Partial List
Considerations</a>.</td>
</tr>
</table>
</dd>
</dl>
<br>
<h3><a name="HDRSPLISTA">Format of the Generated List</a></h3>
<p>The job 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, see <a href="../apiref/usf.htm">
User Space Format for List APIs</a>. For details about the remaining items, see
the following sections. For detailed descriptions of the fields in the list
returned, see <a href="#HDRJOBLD1">Field Descriptions</a>.</p>
<p>When you retrieve list entry information from a user space, you should use
the entry size returned in the generic header. 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 API <a href="../apiref/apiexmp.htm">
Examples</a>.</p>
<br>
<h3><a name="HDRSPFIP1A">Input Parameter Section</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 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 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(6)</td>
<td align="left" valign="top">Job number specified</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">Status</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User space specified</td>
</tr>
<tr>
<td align="center" valign="top">46</td>
<td align="center" valign="top">2E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User space library specified</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format name specified</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Job type specified</td>
</tr>
<tr>
<td align="center" valign="top">65</td>
<td align="center" valign="top">41</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of fields to return specified</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">ARRAY(*) of BINARY(4)</td>
<td align="left" valign="top">Key of fields to return specified</td>
</tr>
<tr>
<td align="center" valign="top">*</td>
<td align="center" valign="top">*</td>
<td align="left" valign="top">CHAR(48)</td>
<td align="left" valign="top">Continuation handle</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRLJOBHD1">Header Section</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 used</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 used</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 used</td>
</tr>
<tr>
<td align="center" valign="top">26</td>
<td align="center" valign="top">1A</td>
<td align="left" valign="top">CHAR(48)</td>
<td align="left" valign="top">Continuation handle</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRLJOBLS1">JOBL0100 Format</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 used</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 used</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 used</td>
</tr>
<tr>
<td align="center" valign="top">26</td>
<td align="center" valign="top">1A</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">42</td>
<td align="center" valign="top">2A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Status</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Job type</td>
</tr>
<tr>
<td align="center" valign="top">53</td>
<td align="center" valign="top">35</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Job subtype</td>
</tr>
<tr>
<td align="center" valign="top">54</td>
<td align="center" valign="top">36</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRLJOBLS2">JOBL0200 Format</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(56)</td>
<td align="left" valign="top" width="60%">Everything in JOBL0100 format</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Job information status</td>
</tr>
<tr>
<td align="center" valign="top">57</td>
<td align="center" valign="top">39</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of fields returned</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="7" colspan="2">These fields repeat, in
the order listed, for each key 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</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</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>
<h3><a name="HDRJOBLD1">Field Descriptions</a></h3>
<p><strong>Data.</strong> The data returned for the key field.</p>
<p><strong>Format name specified.</strong> The format name as specified in the
call to the API.</p>
<p><strong>Internal job identifier.</strong> A value sent to other APIs to
speed the process of locating the job on the system. Only APIs described in
this topic use this identifier. The identifier is not valid following an
initial program load (IPL). If you attempt to use it after an IPL, an exception
occurs.</p>
<p><strong>Job information status.</strong> Whether the information was
available for the job. The possible values are:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">The information was available.</td>
</tr>
<tr>
<td align="left" valign="top"><em>A</em></td>
<td align="left" valign="top">The user was not authorized to the job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>L</em></td>
<td align="left" valign="top">The information was not available because the job
was not accessible.</td>
</tr>
</table>
<p><strong>Job name specified.</strong> The name of the job as specified in the
call to the API.</p>
<p><strong>Job name used.</strong> The name of the job as identified to the
system. For an interactive job, the system assigns the job the name of the work
station where the job started; for a batch job, you specify the name in the
command when you submit the job.</p>
<p><strong>Job number specified.</strong> The job number as specified in the
call to the API.</p>
<p><strong>Job number used.</strong> The system-assigned job number.</p>
<p><strong>Job subtype.</strong> Additional information about the job type (if
any exists). Refer to <a href="qusrjobi.htm#HDRWRKJOB">Comparing Job Type and
Subtype with the Work with Active Job Command</a> in the Retrieve Job
Information (QUSRJOBI) API for information about how the job type field and the
job subtype field equate to the type field in the Work with Active Job
(WRKACTJOB) command. The possible values are:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>blank</em></td>
<td align="left" valign="top">The job has no special subtype.</td>
</tr>
<tr>
<td align="left" valign="top"><em>D</em></td>
<td align="left" valign="top">The job is a batch immediate job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>E</em></td>
<td align="left" valign="top">The job started with a procedure start
request.</td>
</tr>
<tr>
<td align="left" valign="top"><em>F</em></td>
<td align="left" valign="top">The job is an AS/400 Advanced 36 machine server
job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>J</em></td>
<td align="left" valign="top">The job is a prestart job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>P</em></td>
<td align="left" valign="top">The job is a print driver job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>T</em></td>
<td align="left" valign="top">The job is a System/36 multiple requester
terminal (MRT) job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>U</em></td>
<td align="left" valign="top">The job is an alternate spool user.</td>
</tr>
</table>
<p><strong>Job type.</strong> The type of job. Refer to <a href=
"qusrjobi.htm#HDRWRKJOB">Comparing Job Type and Subtype with the Work with
Active Job Command</a> in the Retrieve Job Information (QUSRJOBI) API for
information about how the job type field and the job subtype field equate to
the type field in the Work with Active Job (WRKACTJOB) command. The possible
values for this field are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>A</em></td>
<td align="left" valign="top">The job is an autostart job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>B</em></td>
<td align="left" valign="top">The job is a batch job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>I</em></td>
<td align="left" valign="top">The job is an interactive job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>M</em></td>
<td align="left" valign="top">The job is a subsystem monitor job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>R</em></td>
<td align="left" valign="top">The job is a spooled reader job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>S</em></td>
<td align="left" valign="top">The job is a system job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>W</em></td>
<td align="left" valign="top">The job is a spooled writer job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>X</em></td>
<td align="left" valign="top">The job is the SCPF system job.</td>
</tr>
</table>
<p><strong>Job type specified.</strong> The job type as specified in the call
to the API.</p>
<p><strong>Key field.</strong> The field returned. See <a href="#HDRLKEYS">
Valid Keys</a> for the list of valid keys.</p>
<p><strong>Key of fields to return specified.</strong> The key of fields to
return as specified in the call to the API.</p>
<p><strong>Length of data.</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. This value is used to increment to the
next field in the list.</p>
<p><strong>Number of fields returned.</strong> The number of fields returned to
the application.</p>
<p><strong>Number of fields to return specified.</strong> The number of fields
to return as specified in the call to the API.</p>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>Status.</strong> The status of the job. The valid values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ACTIVE</em></td>
<td align="left" valign="top">The job has started, and it can use system
resources (processing unit, main storage, and so on). This does not guarantee
that the job is currently running, however. For example, an active job may be
in one of the following states where it is not in a position to use system
resources:<br>
<ul>
<li>The Hold Job (HLDJOB) command holds the job; the Release the (RLSJOB)
command allows the job to run again.</li>
<li>The Transfer Group Job (TFRGRPJOB) or Transfer Secondary Job (TFRSECJOB)
command suspends the job. When control returns to the job, the job can run
again.</li>
<li>The job is disconnected using the Disconnect Job (DSCJOB) command. When the
interactive user signs back on, thereby connecting back into the job, the job
can run again.</li>
<li>The job is waiting for any reason. For example, when the job receives the
reply for an inquiry message, the job can start running again.</li>
</ul>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*JOBQ</em></td>
<td align="left" valign="top">The job is currently on a job queue. The job
possibly was previously active and was placed back on the job queue because of
the Transfer Job (TFRJOB) or Transfer Batch Job (TFRBCHJOB) command, or the job
was never active because it was just submitted.<br>
<br>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OUTQ</em></td>
<td align="left" valign="top">The job has completed running and has spooled
output that has not yet printed
or the job's job log has not yet been written.</td>
</tr>
</table>
<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>
<p><strong>User name specified.</strong> The user name as specified in the call
to the API.</p>
<p><strong>User name used.</strong> The user profile under which the job is
run. The user name is the same as the user profile name and can come from
several different sources depending on the type of job.</p>
<p><strong>User space library specified.</strong> The name of the library
containing the user space as specified in the call to the API.</p>
<p><strong>User space specified.</strong> The name of the user space as
specified in the call to the API.</p>
<br>
<h3><a name="HDRLKEYS">Valid Keys</a></h3>
<p>The following table contains a list of the valid keys. The descriptions of
all the valid key attributes are described in <a href="../apis/WMAttrDesc.htm">
Work Management API Attribute Descriptions (WMAttrDesc)</a>.</p>
<table border>
<tr>
<th align="center" valign="top">Key</th>
<th align="left" valign="top">Type</th>
<th align="left" valign="top">Description</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0101</td>
<td align="left" valign="top" width="30%">CHAR(4)</td>
<td align="left" valign="top" width="60%">Active job status</td>
</tr>
<tr>
<td align="center" valign="top">0102</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Allow multiple threads</td>
</tr>
<tr>
<td align="center" valign="top">0103</td>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Active job status for jobs ending</td>
</tr>
<tr>
<td align="center" valign="top">0201</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Break message handling</td>
</tr>
<tr>
<td align="center" valign="top">0301</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Cancel key</td>
</tr>
<tr>
<td align="center" valign="top">0302</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Coded character set ID</td>
</tr>
<tr>
<td align="center" valign="top">0303</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Country or region ID</td>
</tr>
<tr>
<td align="center" valign="top">0304</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Processing unit time used, if less than
2,147,483,647 milliseconds</td>
</tr>
<tr>
<td align="center" valign="top">0305</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Current user profile</td>
</tr>
<tr>
<td align="center" valign="top">0306</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Completion status</td>
</tr>
<tr>
<td align="center" valign="top">0307</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Current system pool identifier</td>
</tr>
<tr>
<td align="center" valign="top">0311</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Character identifier control</td>
</tr>
<tr>
<td align="center" valign="top">0312</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Processing unit time used - total for the
job</td>
</tr>
<tr>
<td align="center" valign="top">0313</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Processing unit time used for database - total
for the job</td>
</tr>
<tr>
<td align="center" valign="top">0401</td>
<td align="left" valign="top">CHAR(13)</td>
<td align="left" valign="top">Date and time job became active</td>
</tr>
<tr>
<td align="center" valign="top">0402</td>
<td align="left" valign="top">CHAR(13)</td>
<td align="left" valign="top">Date and time job entered system</td>
</tr>
<tr>
<td align="center" valign="top">0403</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Date and time job is scheduled to run</td>
</tr>
<tr>
<td align="center" valign="top">0404</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Date and time job was put on this job queue</td>
</tr>
<tr>
<td align="center" valign="top">0405</td>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Date format</td>
</tr>
<tr>
<td align="center" valign="top">0406</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Date separator</td>
</tr>
<tr>
<td align="center" valign="top">0407</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">DBCS-capable</td>
</tr>
<tr>
<td align="center" valign="top">0408</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">DDM conversation handling</td>
</tr>
<tr>
<td align="center" valign="top">0409</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Default wait</td>
</tr>
<tr>
<td align="center" valign="top">0410</td>
<td align="left" valign="top">CHAR(13)</td>
<td align="left" valign="top">Device recovery action</td>
</tr>
<tr>
<td align="center" valign="top">0411</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Device name</td>
</tr>
<tr>
<td align="center" valign="top">0412</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Default coded character set identifier</td>
</tr>
<tr>
<td align="center" valign="top">0413</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Decimal format</td>
</tr>
<tr>
<td align="center" valign="top">0418</td>
<td align="left" valign="top">CHAR(13)</td>
<td align="left" valign="top">Date and time job ended</td>
</tr>
<tr>
<td align="center" valign="top">0501</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">End severity</td>
</tr>
<tr>
<td align="center" valign="top">0502</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">End status</td>
</tr>
<tr>
<td align="center" valign="top">0503</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Exit key</td>
</tr>
<tr>
<td align="center" valign="top">0601</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Function name</td>
</tr>
<tr>
<td align="center" valign="top">0602</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Function type</td>
</tr>
<tr>
<td align="center" valign="top">0701</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Signed-on job</td>
</tr>
<tr>
<td align="center" valign="top">0702</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Group profile name</td>
</tr>
<tr>
<td align="center" valign="top">0703</td>
<td align="left" valign="top">CHAR(150)</td>
<td align="left" valign="top">Group profile name - supplemental</td>
</tr>
<tr>
<td align="center" valign="top">0901</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Inquiry message reply</td>
</tr>
<tr>
<td align="center" valign="top">1001</td>
<td align="left" valign="top">CHAR(15)</td>
<td align="left" valign="top">Job accounting code</td>
</tr>
<tr>
<td align="center" valign="top">1002</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Job date</td>
</tr>
<tr>
<td align="center" valign="top">1003</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Job description name - qualified</td>
</tr>
<tr>
<td align="center" valign="top">1004</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Job queue name - qualified</td>
</tr>
<tr>
<td align="center" valign="top">1005</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Job queue priority</td>
</tr>
<tr>
<td align="center" valign="top">1006</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Job switches</td>
</tr>
<tr>
<td align="center" valign="top">1007</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job message queue full action</td>
</tr>
<tr>
<td align="center" valign="top">1008</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Job message queue maximum size</td>
</tr>
<tr>
<td align="center" valign="top">1012</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job user identity</td>
</tr>
<tr>
<td align="center" valign="top">1013</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Job user identity setting</td>
</tr>
<tr>
<td align="center" valign="top">1014</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Job end reason</td>
</tr>
<tr>
<td align="center" valign="top">1015</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Job log pending</td>
</tr>
<tr>
<td align="center" valign="top">1016</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Job type - enhanced</td>
</tr>
<tr>
<td align="center" valign="top">1017</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Job local time</td>
</tr>
<tr>
<td align="center" valign="top">
<img src="delta.gif" alt="Start of change">1018</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job log output
<img src="deltaend.gif" alt="End of change"></td>
</tr>
<tr>
<td align="center" valign="top">1201</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Language ID</td>
</tr>
<tr>
<td align="center" valign="top">1202</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Logging level</td>
</tr>
<tr>
<td align="center" valign="top">1203</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Logging of CL programs</td>
</tr>
<tr>
<td align="center" valign="top">1204</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Logging severity</td>
</tr>
<tr>
<td align="center" valign="top">1205</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Logging text</td>
</tr>
<tr>
<td align="center" valign="top">1301</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Mode name</td>
</tr>
<tr>
<td align="center" valign="top">1302</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum processing unit time</td>
</tr>
<tr>
<td align="center" valign="top">1303</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum temporary storage in kilobytes</td>
</tr>
<tr>
<td align="center" valign="top">1304</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum threads</td>
</tr>
<tr>
<td align="center" valign="top">1305</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Maximum temporary storage in megabytes</td>
</tr>
<tr>
<td align="center" valign="top">1306</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Memory pool name</td>
</tr>
<tr>
<td align="center" valign="top">1307</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Message reply</td>
</tr>
<tr>
<td align="center" valign="top">1401</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of auxiliary I/O requests, if less than
2,147,483,647</td>
</tr>
<tr>
<td align="center" valign="top">1402</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of interactive transactions</td>
</tr>
<tr>
<td align="center" valign="top">1403</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of database lock waits</td>
</tr>
<tr>
<td align="center" valign="top">1404</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of internal machine lock waits</td>
</tr>
<tr>
<td align="center" valign="top">1405</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of nondatabase lock waits</td>
</tr>
<tr>
<td align="center" valign="top">1406</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Number of auxiliary I/O requests</td>
</tr>
<tr>
<td align="center" valign="top">1501</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Output queue name - qualified</td>
</tr>
<tr>
<td align="center" valign="top">1502</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Output queue priority</td>
</tr>
<tr>
<td align="center" valign="top">1601</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Print key format</td>
</tr>
<tr>
<td align="center" valign="top">1602</td>
<td align="left" valign="top">CHAR(30)</td>
<td align="left" valign="top">Print text</td>
</tr>
<tr>
<td align="center" valign="top">1603</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Printer device name</td>
</tr>
<tr>
<td align="center" valign="top">1604</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Purge</td>
</tr>
<tr>
<td align="center" valign="top">1605</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Product return code</td>
</tr>
<tr>
<td align="center" valign="top">1606</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Program return code</td>
</tr>
<tr>
<td align="center" valign="top">1607</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Pending signal set</td>
</tr>
<tr>
<td align="center" valign="top">1608</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Process ID number</td>
</tr>
<tr>
<td align="center" valign="top">1801</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Response time total</td>
</tr>
<tr>
<td align="center" valign="top">1802</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Run priority (job)</td>
</tr>
<tr>
<td align="center" valign="top">1803</td>
<td align="left" valign="top">CHAR(80)</td>
<td align="left" valign="top">Routing data</td>
</tr>
<tr>
<td align="center" valign="top">1901</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Sort sequence table - qualified</td>
</tr>
<tr>
<td align="center" valign="top">1902</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Status message handling</td>
</tr>
<tr>
<td align="center" valign="top">1903</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Status of job on the job queue</td>
</tr>
<tr>
<td align="center" valign="top">1904</td>
<td align="left" valign="top">CHAR(26)</td>
<td align="left" valign="top">Submitter's job name - qualified</td>
</tr>
<tr>
<td align="center" valign="top">1905</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Submitter's message queue name - qualified</td>
</tr>
<tr>
<td align="center" valign="top">1906</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Subsystem description name - qualified</td>
</tr>
<tr>
<td align="center" valign="top">1907</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">System pool identifier</td>
</tr>
<tr>
<td align="center" valign="top">1908</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Special environment</td>
</tr>
<tr>
<td align="center" valign="top">1909</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Signal blocking mask</td>
</tr>
<tr>
<td align="center" valign="top">1910</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Signal status</td>
</tr>
<tr>
<td align="center" valign="top">1911</td>
<td align="left" valign="top">CHAR(30)</td>
<td align="left" valign="top">Server type</td>
</tr>
<tr>
<td align="center" valign="top">1982</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Spooled file action</td>
</tr>
<tr>
<td align="center" valign="top">2001</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Time separator</td>
</tr>
<tr>
<td align="center" valign="top">2002</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Time slice</td>
</tr>
<tr>
<td align="center" valign="top">2003</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Time-slice end pool</td>
</tr>
<tr>
<td align="center" valign="top">2004</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Temporary storage used in kilobytes</td>
</tr>
<tr>
<td align="center" valign="top">2005</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Time spent on database lock waits</td>
</tr>
<tr>
<td align="center" valign="top">2006</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Time spent on internal machine lock waits</td>
</tr>
<tr>
<td align="center" valign="top">2007</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Time spent on nondatabase lock waits</td>
</tr>
<tr>
<td align="center" valign="top">2008</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Thread count</td>
</tr>
<tr>
<td align="center" valign="top">2009</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Temporary storage used in megabytes</td>
</tr>
<tr>
<td align="center" valign="top">2020</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Time zone current abbreviated name</td>
</tr>
<tr>
<td align="center" valign="top">2021</td>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Time zone current full name</td>
</tr>
<tr>
<td align="center" valign="top">2022</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Time zone current message identifier</td>
</tr>
<tr>
<td align="center" valign="top">2023</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Time zone current offset</td>
</tr>
<tr>
<td align="center" valign="top">2024</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Time zone description name</td>
</tr>
<tr>
<td align="center" valign="top">2025</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Time zone message file name - qualified</td>
</tr>
<tr>
<td align="center" valign="top">2026</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Time zone Daylight Saving Time indicator</td>
</tr>
<tr>
<td align="center" valign="top">2101</td>
<td align="left" valign="top">CHAR(24)</td>
<td align="left" valign="top">Unit of work ID</td>
</tr>
<tr>
<td align="center" valign="top">2102</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">User return code</td>
</tr>
</table>
<br>
<br>
<h3><a name="Header_13">Usage Notes</a></h3>
<p>The conditions under which this API is threadsafe are the same as those
described in the <a href="qusrjobi.htm#HDRRTVJBUN">Usage Notes</a> for the
Retrieve Job Information (QUSRJOBI) API.</p>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td align="left" valign="top">CPF1865 E</td>
<td align="left" valign="top">Value &amp;1 for job type not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF1866 E</td>
<td align="left" valign="top">Value &amp;1 for number of fields to return not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF1867 E</td>
<td align="left" valign="top">Value &amp;1 in list not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF24B4 E</td>
<td align="left" valign="top">Severe error while addressing parameter
list.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CB1 E</td>
<td align="left" valign="top">Value &amp;1 for job status is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CB2 E</td>
<td align="left" valign="top">Value specified for job parameter is not
valid.</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 &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C21 E</td>
<td align="left" valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C36 E</td>
<td align="left" valign="top">Number of parameters, &amp;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">CPF8100 E</td>
<td align="left" valign="top">All CPF81xx messages could be returned. xx is
from 01 to FF.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9800 E</td>
<td align="left" valign="top">All CPF98xx messages could be signaled. xx is
from 01 to FF.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9801 E</td>
<td align="left" valign="top">Object &amp;2 in library &amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9802 E</td>
<td align="left" valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9803 E</td>
<td align="left" valign="top">Cannot allocate object &amp;2 in library
&amp;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 &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9820 E</td>
<td align="left" valign="top">Not authorized to use library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9830 E</td>
<td align="left" valign="top">Cannot assign library &amp;1.</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 &amp;1 in library
&amp;2 ended. Reason code &amp;3.</td>
</tr>
</table>
<br>
<hr>
API introduced: V1R3
<hr>
<table align="center" cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top">Top</a> | <a href="wm1.htm">
Work Management APIs</a> | <a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink