2639 lines
77 KiB
HTML
2639 lines
77 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
|
<title>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>
|
||
|
|
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>
|
||
|
|
Default Public Authority: *USE<br>
|
||
|
|
<!-- iddvc RMBR -->
|
||
|
|
<br>
|
||
|
|
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 &3/&2/&1 not active.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CPF1866 E</td>
|
||
|
|
<td align="left" valign="top">Value &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 &1 in list not valid.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CPF18BF E</td>
|
||
|
|
<td align="left" valign="top">Thread &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 &1.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CPF3C21 E</td>
|
||
|
|
<td align="left" valign="top">Format name &1 is not valid.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">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 &2 for API &1 not
|
||
|
|
valid.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CPF3C3C E</td>
|
||
|
|
<td align="left" valign="top">Value for parameter &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 &3/&2/&1 not found.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CPF3C54 E</td>
|
||
|
|
<td align="left" valign="top">Job &3/&2/&1 currently not
|
||
|
|
available.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">CPF3C55 E</td>
|
||
|
|
<td align="left" valign="top">Job &3/&2/&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 &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>
|
||
|
|
|