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/qwtrtvta.htm

2639 lines
77 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>Retrieve thread attribute (QWTRTVTA) 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. -->
<!-- QWTRTVTA SCR A converted by B2H R4.1 (346) (CMS) by V2CDIJAB at -->
<!-- RCHVMW2 on 5 Dec 2000 at 12:52:49 -->
<!-- Externalized for V5R2 -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- File cleanup completed Jan 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>Retrieve Thread Attribute (QWTRTVTA) 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="50%">Receiver variable</td>
<td align="left" valign="top" width="15%">Output</td>
<td align="left" valign="top" width="25%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Length of receiver variable</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">Format of receiver information</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Job or thread identification information</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Format of job identification information</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">6</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">7</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>
<tr>
<td align="center" valign="top">8</td>
<td align="left" valign="top">Reset performance statistics</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(1)</td>
</tr>
<tr>
<td align="center" valign="top">9</td>
<td align="left" valign="top">Error code</td>
<td align="left" valign="top">I/O</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Conditional; see <a href="#usagenotes">Usage
Notes</a>.<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Retrieve Thread Attribute (QWTRTVTA) API retrieves job and thread
attributes that apply to the job or thread specified in the job or thread
identification information parameter.</p>
<br>
<h3>Authorities and Locks</h3>
<p>The following authority restrictions apply only when the API is called for
format name RTVT0200. All other format names have no authority
restrictions.</p>
<dl>
<dt><em><strong>Job Authority</strong></em></dt>
<dd>When calling this API for format name RTVT0200, one of the following
conditions must be met:<br>
<br>
<ul>
<li>The API must be called from within the job for which the information is
being retrieved.<br>
<br>
</li>
<li>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.
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.<br>
<br>
</li>
<li>The caller of the API must be running under a user profile that has job
control (*JOBCTL) special authority.<br>
<br>
</li>
<li>The caller of the API must be authorized to the Thread Control function of
Operating System/400 through iSeries Navigator's Application Administration
support. The <a href="qsychfui.htm">Change Function Usage Information
(QSYCHFUI) API</a>, with a function ID of QIBM_SERVICE_THREAD, can be used to
change the list of users that are allowed to retrieve information about a
thread.</li>
</ul>
</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Receiver variable</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The variable that is used to return the attribute information for the
specified thread.</p>
</dd>
<dt><strong>Length of receiver variable</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the receiver variable provided. The length of receiver
variable parameter may be specified up to the size of the receiver variable
specified in the user program. If the length of receiver variable parameter
specified is larger than the allocated size of the receiver variable specified
in the user program, the results are not predictable. The minimum length is 8
bytes.</p>
</dd>
<dt><strong>Format of receiver information</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the information returned in the receiver variable. The
possible format name is:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>RTVT0100</em></td>
<td align="left" valign="top">See <a href="#HDRXXRTVT1">Format RTVT0100</a> for
details on the job or thread attribute information returned.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RTVT0200</em></td>
<td align="left" valign="top">Library list information. See <a href=
"#HDRXXRTVT2">Format RTVT0200</a> for details on the library information
returned for the thread.</td>
</tr>
<tr>
<td align="left" valign="top"><em>RTVT0300</em></td>
<td align="left" valign="top">Elapsed performance statistics. See <a href=
"#HDRXXRTVT3">Format RTVT0300</a> for details on the performance statistics
returned for the specified thread.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Job or thread identification information</strong></dt>
<dd>INPUT; CHAR(*)
<p>The information that is used to identify the job or thread within a job for
which attribute information is to be returned. See <a href="#HDRXXJJJF1">Format
of job or thread identification information</a> for details.</p>
</dd>
<dt><strong>Format of job or thread identification information</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the job or thread identification information. The possible
format names are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>JIDF0100</em></td>
<td align="left" valign="top">See <a href="#HDRXXJJJF1">Format of job or thread
identification information</a> for details on the job identification
information.</td>
</tr>
<tr>
<td align="left" valign="top"><em>JIDF0200</em></td>
<td align="left" valign="top">See <a href="#HDRXXJJJF1">Format of job or thread
identification information</a> for details on the job identification
information.
<p><strong>Note:</strong> If the thread handle is available, Format JIDF0200
provides a faster method of accessing a thread that is not the current thread
than Format JIDF0100.</p>
</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 specified format.</p>
</dd>
<dt><strong>Key of fields to be returned</strong></dt>
<dd>INPUT; ARRAY(*) of BINARY(4)
<p>The list of fields to be returned in the specified format. For a list of
valid fields, see <a href="#HDRLKJJJ"> Valid Keys</a>.</p>
</dd>
<dt><strong>Reset status statistics</strong></dt>
<dd>INPUT; CHAR(1)
<p>The elapsed time and all the key fields that are based on the elapsed time
are reset to zero. If a format other than RTVT0300 is specified, this field
needs to be zero. The following special values may be specified:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The elapsed time and the key fields based on the
elapsed time are not reset.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The elapsed time and the key fields based on the
elapsed time are reset back to zero.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Error code</strong></dt>
<dd>I/O; CHAR(*)
<p>The structure in which to return error information. For the format of the
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
</dd>
</dl>
<br>
<h3><a name="HDRXXRTVT1">Format RTVT0100</a></h3>
<p>The RTVT0100 format returns job or thread attribute information for the
specified thread. For the list of keys that are valid for job attributes and
thread attributes, see <a href="#HDRXXRTV1">Keys for RTVT0100</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Bytes returned</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bytes available</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job name</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="center" valign="top">12</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User name</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Job number</td>
</tr>
<tr>
<td align="center" valign="top">34</td>
<td align="center" valign="top">22</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4), UNSIGNED</td>
<td align="left" valign="top">Returned thread handle</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Returned thread identifier</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">Job status</td>
</tr>
<tr>
<td align="center" valign="top">58</td>
<td align="center" valign="top">3A</td>
<td align="left" valign="top">CHAR(2)</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">Offset to key fields</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of fields returned</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="7" colspan="2">These fields repeat, in
the order listed, for the number of key field returned.</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="Header_5">Field Descriptions</a></h3>
<p><strong>Bytes available.</strong> The number of bytes of data available to
be returned. All available data is returned if enough space is provided.</p>
<p><strong>Bytes returned.</strong> The number of bytes of data returned.</p>
<p><strong>Data.</strong> The data returned for the key field.</p>
<p><strong>Job name.</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.</strong> The system-assigned job number.</p>
<p><strong>Job status.</strong> The status of the job. The valid values
are:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<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:
<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.</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>Key field.</strong> The field returned. See <a href="#HDRLKJJJ">
Valid Keys</a> for the list of valid keys.</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>Offset to key fields.</strong> The offset in characters (bytes) from
the beginning of the receiver to the key fields array entry.</p>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>Returned thread handle.</strong> A value which addresses a
particular thread within the job. While the thread identifier uniquely
identifies the thread within the job, the thread handle can improve performance
when referencing the thread. This field will be 0 when called to return
attributes for a job.</p>
<p><strong>Returned thread identifier.</strong> A value which uniquely
identifies the thread within the job. This field will be 0 when called to
return attributes for a job.</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>
<p><strong>User name.</strong> The user profile under which the job is started.
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>
<br>
<h3><a name="HDRXXRTVT2">RTVT0200 Format</a></h3>
<p>The RTVT0200 format returns library list information for the specified
thread. The special value of -1 for the thread indicator field (part of the
JIDF0100 format) may not be used. For the list of keys that are valid for this
format, see <a href="#HDRXXRTV2">Keys for RTVT0200</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Bytes returned</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bytes available</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job name</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="center" valign="top">12</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User name</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Job number</td>
</tr>
<tr>
<td align="center" valign="top">34</td>
<td align="center" valign="top">22</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4), UNSIGNED</td>
<td align="left" valign="top">Returned thread handle</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Returned thread identifier</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to libraries in system library list</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of system libraries</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to libraries in product library list</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 product libraries</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to current library</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 current libraries</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to libraries in user library list</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of user libraries</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of one library array entry</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">Offset to ASP group information</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of ASP group information entries</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of one ASP group information entry</td>
</tr>
<tr>
<td align="left" valign="top" colspan="2" rowspan="5">See note</td>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">System library list (See <a href="#HDRLIBLE">
Library array entry</a> for format of library array entry.)</td>
</tr>
<tr>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">Product libraries (See <a href="#HDRLIBLE">
Library array entry</a> for format of library array entry.)</td>
</tr>
<tr>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">Current library (See <a href="#HDRLIBLE">Library
array entry</a> for format of library array entry.)</td>
</tr>
<tr>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">User library list (See <a href="#HDRLIBLE">
Library array entry</a> for format of library array entry.)</td>
</tr>
<tr>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">ASP group information entry (See <a href=
"#HDRASPDE">ASP Group Information Entry</a> for format of ASP group information
entry.)</td>
</tr>
<tr>
<td align="left" valign="top" colspan="4"><strong>Note:</strong> The decimal
and hexadecimal offsets depend on the number of libraries you have in the
various parts of your library lists and on keys requested. The data is
left-justified and padded with blanks on the right. The array is sequential.
See the <a href="../rbam6/clpro.htm">CL Programming</a> topic for the total
number of libraries that can be returned to you.</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRLIBLE">Library array entry</a></h3>
<p>The library array entry describes the data that is returned for each library
entry in the array of libraries. The name of the library as well as some
extended information about the library is returned with this format.</p>
<p>For details about the fields listed, see <a href="#Header_195">Field
Descriptions</a>.</p>
<table border width="80%">
<!-- cols="10 10 20 60" -->
<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="left" valign="top" rowspan="5" colspan="2" width="20%">The fields
repeat for each library object returned in the array.</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Library name</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(50)</td>
<td align="left" valign="top">Library text description</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Library ASP number</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Library ASP name.</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRASPDE">ASP Group Information Entry</a></h3>
<p>The ASP group information entry describes the data that is returned for each
ASP group. The name of the ASP group is returned with this format. For details
about the fields listed, see <a href="#Header_195"> Field Descriptions.</a></p>
<table border width="80%">
<!-- cols="10 10 20 60" -->
<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="left" valign="top" rowspan="3" colspan="2" width="20%">These fields
repeat for each ASP group returned.</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">ASP group name</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<br>
<h3><a name="Header_195">Field Descriptions</a></h3>
<p><strong>ASP group information.</strong> The list of Auxiliary Storage Pool
(ASP) group information for the current thread. This information does not
include the system ASP or the basic user ASPs.</p>
<p><strong>ASP group name.</strong> The name of an ASP group being used by the
thread. This is the name of the primary ASP device in an ASP group.</p>
<p><strong>Bytes available.</strong> All of the available bytes for use in your
application.The actual length depends on how many libraries are in the library
list.</p>
<p><strong>Bytes returned.</strong> The number of bytes returned to the user.
This may be some but not all of the bytes available.</p>
<p><strong>Current library.</strong> The name of the current library for the
specified thread. If no current library exists, the number of current libraries
field is zero and this field has no entry in the list.</p>
<p><strong>Job name.</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.</strong> The system-assigned job number.</p>
<p><strong>Length of one ASP group information entry.</strong> The length of an
entry in the ASP group information. Zero indicates that ASP group information
is not being returned.</p>
<p><strong>Length of one library array entry.</strong> The length of an entry
in one of the library list entries.</p>
<p><strong>Library ASP name.</strong> The name of the ASP in which the library
is located. The following special values may also be returned:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*SYSBAS</em></td>
<td align="left" valign="top">The library is located in the system ASP or a
basic ASP.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*N</em></td>
<td align="left" valign="top">The name of the ASP cannot be determined.</td>
</tr>
</table>
<p><strong>Library ASP number.</strong> The numeric identifier of the ASP
device containing the object's library. The following values may be
returned:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The library is located in the system ASP.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2-32</em></td>
<td align="left" valign="top">The library is located in a basic ASP.</td>
</tr>
<tr>
<td align="left" valign="top"><em>33-255</em></td>
<td align="left" valign="top">The library is located in an independent
ASP.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">The ASP device cannot be determined.</td>
</tr>
</table>
<p><strong>Library name.</strong> The name of the library object.</p>
<p><strong>Library text description.</strong> The text description of the
library object. This field is blank if no text description is specified.</p>
<p><strong>Number of ASP group information entries.</strong> The number of
elements in entries in the ASP group information. Zero indicates that ASP group
information is not being returned.</p>
<p><strong>Number of current libraries.</strong> The number of libraries in the
current part of the library list of the specified thread.</p>
<p><strong>Number of product libraries.</strong> The number of product
libraries found in the library list of the specified thread.</p>
<p><strong>Number of system libraries.</strong> The number of libraries in the
system part of the thread's library list. This value will be zero if system
libraries were not requested.</p>
<p><strong>Number of user libraries.</strong> The number of libraries in the
thread's user library list. This value will be zero if user libraries were not
requested.</p>
<p><strong>Offset to ASP group information.</strong> The offset in characters
(bytes) from the beginning of the receiver to the first ASP group information
entry. Zero indicates that ASP group information is not being returned.</p>
<p><strong>Offset to current library.</strong> The offset in characters (bytes)
from the beginning of the receiver to the current library array entry.</p>
<p><strong>Offset to libraries in product library list.</strong> The offset in
characters (bytes) from the beginning of the receiver to the first product
library array entry.</p>
<p><strong>Offset to libraries in system library list.</strong> The offset in
characters (bytes) from the beginning of the receiver to the first system
library array entry.</p>
<p><strong>Offset to libraries in user library list.</strong> The offset in
characters (bytes) from the beginning of the receiver to the first user library
array entry.</p>
<p><strong>Product libraries.</strong> The libraries that contain product
information for the specified thread. If no product libraries exist, the number
of product libraries field is zero and this field has no entry in the list.</p>
<p><strong>Reserved.</strong> An ignored field.</p>
<p><strong>Returned thread handle.</strong> A value which addresses a
particular thread within the job. While the thread identifier uniquely
identifies the thread within the job, the thread handle can improve performance
when referencing the thread.</p>
<p><strong>Returned thread identifier.</strong> A value which uniquely
identifies the thread within the job.</p>
<p><strong>System library list.</strong> The system portion of the library list
of the specified thread.</p>
<p><strong>User library list.</strong> The user portion of the library list for
the specified thread.</p>
<p><strong>User name.</strong> The user profile under which the job is started.
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>
<br>
<h3><a name="HDRXXRTVT3">Format RTVT0300</a></h3>
<p>The RTVT0300 format returns performance statistics information, calculated
over an elapsed time, for the specified thread. The special value of -1 for the
thread indicator field (part of the JIDF0100 format) may not be used. For the
list of keys that are valid for this format, see <a href="#HDRXXRTV3">Keys for
RTVT0300</a>.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Bytes returned</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Bytes available</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Job name</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="center" valign="top">12</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User name</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Job number</td>
</tr>
<tr>
<td align="center" valign="top">34</td>
<td align="center" valign="top">22</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4), UNSIGNED</td>
<td align="left" valign="top">Returned thread handle</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Returned thread identifier</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Elapsed time</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to key fields</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="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="7" colspan="2">These fields repeat, in
the order listed, for the number of key field returned.</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>Field Descriptions</h3>
<p><strong>Bytes available.</strong> The number of bytes of data available to
be returned. All available data is returned if enough space is provided.</p>
<p><strong>Bytes returned.</strong> The number of bytes of data returned.</p>
<p><strong>Data.</strong> The data returned for the key field.</p>
<p><strong>Elapsed time.</strong> The time, in milliseconds, that has elapsed
between the measurement start time and the current system time. This value is 0
the first time this API is called by this job. The measurement start is set the
first time this API is called and when the reset status statistics is set to
reset the elapsed time.</p>
<p><strong>Job name.</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.</strong> The system-assigned job number.</p>
<p><strong>Key field.</strong> The field returned. See <a href="#HDRLKJJJ">
Valid Keys</a> for the list of valid keys.</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>Reserved.</strong> An ignored field.</p>
<p><strong>Returned thread handle.</strong> A value which addresses a
particular thread within the job. While the thread identifier uniquely
identifies the thread within the job, the thread handle can improve performance
when referencing the thread.</p>
<p><strong>Returned thread identifier.</strong> A value which uniquely
identifies the thread within the job.</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>
<p><strong>User name.</strong> The user profile under which the job is started.
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>
<br>
<h3><a name="HDRXXJJJF1">Format of job or thread identification
information</a></h3>
<p>Format JIDF0100 is the format of the information needed to identify the job
or the thread for which the job or thread's attributes will be returned. This
format is to be used for returning job or thread information. This format
supports several special values that can help in identifying the thread.</p>
<p>Format JIDF0200 is the format of the information needed to identify the
thread for which the thread's attributes will be returned. This format is to be
used when referencing a specific thread that you already have the
identification information for.</p>
<p><strong>Note:</strong> If the thread handle is available, Format JIDF0200
provides a faster method of accessing a thread that is not the current thread
than Format JIDF0100.</p>
<br>
<h3>JIDF0100 Format</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(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(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Thread indicator</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Thread identifier</td>
</tr>
</table>
<br>
<br>
<h3><a name="Header_7">Field Descriptions</a></h3>
<p><strong>Internal job identifier.</strong> The internal identifier for the
job. The List Job (QUSLJOB) API returns this identifier. If you do not specify
*INT for the job name parameter, this parameter must contain blanks. With this
parameter, the system can locate the job more quickly than with a job name.</p>
<p><strong>Job name.</strong> A specific job name or one of the following
special values:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*</em></td>
<td align="left" valign="top">The job in which this program is running. The job
number and user name must contain blanks.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*INT</em></td>
<td align="left" valign="top">The internal job identifier locates the job. The
job number and user name must contain blanks.</td>
</tr>
</table>
<p><strong>Job number.</strong> A specific job number, or blanks when the job
name specified is a special value.</p>
<p><strong>Reserved.</strong> An unused field. This field must contain
hexadecimal zeros.</p>
<p><strong>Thread identifier.</strong> A value that uniquely identifies a
thread within a job. If a thread identifier is specified, a thread indicator
must also be specified. If the thread indicator is not 0, this field must
contain hexadecimal zeros.</p>
<p><strong>Thread indicator.</strong> A value that is used to specify the
thread within the job for which information is to be retrieved. If a thread
indicator is specified, a thread identifier must also be specified. The
following values are supported:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">Information should be retrieved for the job. The
value for the fields requested will be retrieved from the job. If the value
requested only resides in a thread, the value for the initial thread will be
returned. For example, the Current user field only resides in the thread and
the initial thread value will be returned. The returned thread identifier and
the returned thread handle will be returned as hexadecimal zeros.</td>
</tr>
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Information should be retrieved for the thread
specified in the thread identifier field. If the value requested only resides
in a job, the value for the job containing the thread will be returned.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Information should be retrieved for the thread
that this program is currently running in. If the value requested only resides
in a job, the value for the job containing the thread will be returned.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">Information should be retrieved for the initial
thread of the identified job. If the value requested only resides in a job, the
value for the job containing the thread will be returned.</td>
</tr>
</table>
<p><strong>Note:</strong> For all of the supported values, the combination of
the internal job identifier, job name, job number and user name fields must
also identify the job containing the thread.</p>
<p><strong>User name.</strong> A specific user profile name, or blanks when the
job name specified is a special value.</p>
<br>
<h3>JIDF0200 Format</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(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(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4), UNSIGNED</td>
<td align="left" valign="top">Thread handle</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Thread identifier</td>
</tr>
</table>
<br>
<br>
<h3>Field Descriptions</h3>
<p><strong>Internal job identifier.</strong> The internal identifier for the
job. The List Job (QUSLJOB) API returns this identifier. If you do not specify
*INT for the job name parameter, this parameter must contain blanks. With this
parameter, the system can locate the job more quickly than with a job name.</p>
<p><strong>Job name.</strong> A specific job name or one of the following
special values:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*</em></td>
<td align="left" valign="top">The job in which this program is running. The job
number and user name must contain blanks.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*INT</em></td>
<td align="left" valign="top">The internal job identifier locates the job. The
job number and user name must contain blanks.</td>
</tr>
</table>
<p><strong>Job number.</strong> A specific job number, or blanks when the job
name specified is a special value.</p>
<p><strong>Reserved.</strong> An unused field. This field must contain
hexadecimal zeros.</p>
<p><strong>Thread handle.</strong> A value that addresses a particular thread
within a job. While the thread identifier uniquely identifies the thread within
the job, the thread handle can improve performance when referencing the thread.
A valid thread handle must be specified. The thread handle is returned on
several other interfaces.</p>
<p><strong>Thread identifier.</strong> A value which uniquely identifies a
thread within a job. A valid thread identifier must be specified.</p>
<p><strong>User name.</strong> A specific user profile name, or blanks when the
job name specified is a special value.</p>
<br>
<h3><a name="HDRLKJJJ">Valid Keys</a></h3>
<p>The following tables indicate the valid keys for the formats specified.</p>
<br>
<h3><a name="HDRXXRTV1">Keys for RTVT0100</a></h3>
<p>The following table contains a list of the valid keys for format RTVT0100.
See <a href="#HDRJOBRDE2"> Key Field Descriptions</a> for the descriptions of
the valid key attributes. This table contains the keys that are valid for job
attributes and thread attributes.</p>
<p>The Scope column defines the location of the attribute. The attribute is
either scoped to the job or to the thread. If a job scoped attribute is
requested for a thread, the value from the job containing the thread will be
returned. If a thread scoped attribute is requested for a job, the value from
the initial thread will be returned.</p>
<table border width="100%">
<tr>
<th align="center" valign="bottom">Key</th>
<th align="left" valign="bottom">Type</th>
<th align="left" valign="bottom">Description</th>
<th align="left" valign="bottom">Scope</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0101</td>
<td align="left" valign="top" width="25%">CHAR(4)</td>
<td align="left" valign="top" width="55%">Active job status</td>
<td align="left" valign="top" width="10%">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">0104</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">ASP group information</td>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">0319</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Processing unit time used - total for the
thread</td>
<td align="left" valign="top">Thread</td>
</tr>
<tr>
<td align="center" valign="top">0320</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Processing unit time used for database - total
for the thread</td>
<td align="left" valign="top">Thread</td>
</tr>
<tr>
<td align="center" valign="top">0326</td>
<td align="left" valign="top">CHAR(45)</td>
<td align="left" valign="top">Client IP address - IPv4 or IPv6</td>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">0415</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Disk I/O count - total for the job</td>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">0420</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Disk I/O count - total for the thread</td>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">0504</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Extended object attribute of entity thread is
waiting on</td>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">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>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">1010</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Job type</td>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">1011</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Job subtype</td>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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</td>
<td align="left" valign="top">Job
<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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">1206</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Library of entity thread is waiting on</td>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">1407</td>
<td align="left" valign="top">CHAR(30)</td>
<td align="left" valign="top">Name of entity thread is waiting on</td>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">1503</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Object type of entity thread is waiting on</td>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">1804</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Run priority (thread)</td>
<td align="left" valign="top">Thread</td>
</tr>
<tr>
<td align="center" valign="top">1805</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Resources affinity group</td>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
<tr>
<td align="center" valign="top">2010</td>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Thread status</td>
<td align="left" valign="top">Thread</td>
</tr>
<tr>
<td align="center" valign="top">2011</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Thread type</td>
<td align="left" valign="top">Thread</td>
</tr>
<tr>
<td align="center" valign="top">2012</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Thread hold count</td>
<td align="left" valign="top">Thread</td>
</tr>
<tr>
<td align="center" valign="top">2013</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Thread resources affinity</td>
<td align="left" valign="top">Thread</td>
</tr>
<tr>
<td align="center" valign="top">2015</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Type of entity thread is waiting on</td>
<td align="left" valign="top">Thread</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</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>
<td align="left" valign="top">Job</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRASPD1">Format of ASP Group Information</a></h3>
<p>The ASP group information describes the data that is returned for key 104
from the RTVT0100 format.</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%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Number of entries in ASP group
information</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of one ASP group information entry</td>
</tr>
<tr>
<td valign="top" colspan="2">This field repeats for each ASP group information
entry.</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">ASP group information entry (See <a href=
"#HDRASPD2">Format of ASP Group Information Entry</a> for more
information.)</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRASPD2">Format of ASP Group Information Entry</a></h3>
<p>The ASP group information entry describes the data that is returned for each
ASP group. The name of the ASP group is returned with this format.</p>
<table border width="80%">
<!-- cols="10 10 20 60" -->
<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="left" valign="top" rowspan="2" colspan="2" width="20%">These fields
repeat for each ASP group returned.</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">ASP group name</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRXXRTV2">Keys for RTVT0200</a></h3>
<p>The following table contains a list of the valid keys for format RTVT0200.
See <a href="#HDRJOBRDE2"> Key Field Descriptions</a> for the descriptions of
the valid key attributes.</p>
<p>All the library keys are scoped to the thread. See <a href="#HDRLIBLE">
Library array entry</a> for format of library array entry. These keys are valid
only when retrieving the library list of a specific thread. The special value
of -1 for the thread indicator field (part of the JIDF0100 format) may not be
used. The job or thread identification format must specify a specific valid
thread.</p>
<table border width="80%">
<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="15%">0104</td>
<td align="left" valign="top" width="30%">CHAR(*)</td>
<td align="left" valign="top" width="55%">ASP group information (thread)</td>
</tr>
<tr>
<td align="center" valign="top">0310</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Current library</td>
</tr>
<tr>
<td align="center" valign="top">1660</td>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">Product libraries</td>
</tr>
<tr>
<td align="center" valign="top">1980</td>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">System library list</td>
</tr>
<tr>
<td align="center" valign="top">2110</td>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">User library list</td>
</tr>
<tr>
<td align="center" valign="top">2703</td>
<td align="left" valign="top">Array(*) of CHAR(*)</td>
<td align="left" valign="top">All portions of the library list for format
RTVT0200</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRXXRTV3">Keys for RTVT0300</a></h3>
<p>The following table contains a list of the valid keys for format RTVT0300.
See <a href="#HDRJOBRDE2"> Key Field Descriptions</a> for the descriptions of
the valid key attributes. All keys specified in this table are scoped to the
thread. The special value of -1 for the thread indicator field (part of the
JIDF0100 format) may not be used. The job or thread identification format must
specify a specific valid thread.</p>
<table border width="80%">
<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%">0321</td>
<td align="left" valign="top" width="35%">BINARY(4)</td>
<td align="left" valign="top" width="50%">Processing unit used - percent during
the elapsed time (thread).</td>
</tr>
<tr>
<td align="center" valign="top">0322</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Processing unit used - time during the elapsed
time (thread).</td>
</tr>
<tr>
<td align="center" valign="top">0323</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Processing unit used for database - percent used
during the elapsed time (thread).</td>
</tr>
<tr>
<td align="center" valign="top">0324</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Processing unit used for database - time during
the elapsed time (thread) .</td>
</tr>
<tr>
<td align="center" valign="top">0419</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Disk I/O count during the elapsed time
(thread).</td>
</tr>
<tr>
<td align="center" valign="top">0421</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Disk I/O count during the elapsed time -
asynchronous I/O (thread).</td>
</tr>
<tr>
<td align="center" valign="top">0422</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Disk I/O count during the elapsed time -
synchronous I/O (thread).</td>
</tr>
<tr>
<td align="center" valign="top">1610</td>
<td align="left" valign="top">BINARY(8), UNSIGNED</td>
<td align="left" valign="top">Page fault count during the elapsed time
(thread).</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRJOBRDE2">Key Field descriptions</a></h3>
<p>The descriptions of all the valid key attributes are described in <a href=
"../apis/WMAttrDesc.htm"> Work Management API Attribute Descriptions
(WMAttrDesc)</a>.</p>
<br>
<h3><a name="usagenotes">Usage Notes</a></h3>
<p>The conditions under which this API is threadsafe are as follows:</p>
<ul>
<li>Retrieving the attributes from a job - see <a href="qusrjobi.htm">Retrieve
Job Information</a> (QUSRJOBI) API for details on thread safety.<br>
<br>
</li>
<li>Retrieving the attribute for a specific thread - this is thread safe.</li>
</ul>
<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">CPF136A E</td>
<td align="left" valign="top">Job &amp;3/&amp;2/&amp;1 not active.</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">CPF18BF E</td>
<td align="left" valign="top">Thread &amp;1 not found.</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">CPF3C19 E</td>
<td align="left" valign="top">Error occurred with receiver variable
specified.</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">CPF3C24 E</td>
<td align="left" valign="top">Length of the receiver variable is not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C3B E</td>
<td align="left" valign="top">Value for parameter &amp;2 for API &amp;1 not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C3C E</td>
<td align="left" valign="top">Value for parameter &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C51 E</td>
<td align="left" valign="top">Internal job identifier not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C52 E</td>
<td align="left" valign="top">Internal job identifier no longer valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C53 E</td>
<td align="left" valign="top">Job &amp;3/&amp;2/&amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C54 E</td>
<td align="left" valign="top">Job &amp;3/&amp;2/&amp;1 currently not
available.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C55 E</td>
<td align="left" valign="top">Job &amp;3/&amp;2/&amp;1 does not exist.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C57 E</td>
<td align="left" valign="top">Not authorized to retrieve job information.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C58 E</td>
<td align="left" valign="top">Job name specified is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C59 E</td>
<td align="left" valign="top">Internal identifier is not blanks and job name is
not *INT.</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">CPF3CF2 E</td>
<td align="left" valign="top">Error(s) occurred during running of &amp;1
API.</td>
</tr>
</table>
<br>
<hr>
API introduced: V5R2
<hr>
<table align="center" cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">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