ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahx_5.4.0.1/rzahxqapmjobwt.htm

182 lines
12 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="Performance data files: QAPMJOBWT" />
<meta name="abstract" content="This database file contains information about job, task, and thread wait conditions." />
<meta name="description" content="This database file contains information about job, task, and thread wait conditions." />
<meta name="DC.Relation" scheme="URI" content="rzahxapsparent.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzahxqapmjobwt" />
<meta name="DC.Language" content="en-us" />
<!-- 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. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Performance data files: QAPMJOBWT</title>
</head>
<body id="rzahxqapmjobwt"><a name="rzahxqapmjobwt"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Performance data files: QAPMJOBWT</h1>
<div><p>This database file contains information about job, task, and thread
wait conditions.</p>
<div class="section"><p>At least one record will be written for each job, task, or thread
that consumed CPU during the interval (multiple records are possible especially
during service activities).</p>
<p><img src="./delta.gif" alt="Start of change" />The purpose of this
file is to account for the time a job (this means a task, primary thread,
or secondary thread) spends waiting and to provide some indication as to the
type of wait. Since the reasons for a wait are too numerous to handle individually,
they are grouped into sets of functionally related waits. For each group,
both the number of waits and time the job spent waiting are reported. The
QAPMJOBWTD file provides a description of the type of wait conditions for
each counter set.<img src="./deltaend.gif" alt="End of change" /></p>
<p>Although the file contains fields for up to 16 sets
of counters, not all may be used. The number of counters is reported in field
JWTNUM. If the number of instrumented counter sets is greater than 16, an
additional record or records are written for each reported job.</p>
<p><img src="./delta.gif" alt="Start of change" />User
of this file should be aware of the dynamic nature of the content of this
file. Counter sets can be added or redefined by the new release of the operating
system. In addition, IBM<sup>®</sup> service representatives can define new counter sets
or redefine existing counter sets to allow more granular or more specialized
view of the job wait statistics. As a result, user cannot assume that the
content of this file is always the same.<img src="./deltaend.gif" alt="End of change" /></p>
<div class="tablenoborder"><!-- Link to dynamic table -->
<SCRIPT language="Javascript" type="text/javascript" src="../rzahg/iccommon.js"></SCRIPT>
<SCRIPT language="Javascript" type="text/javascript">
//<![CDATA[
//Do not split up the following string. Keep it on one line.
var textA = "<p>To easily compare and sort the data in this table, use the <a href='rzahxqapmjobwt.xml'>interactive table<\/a>.<\/p>";
if (isIE5) {
document.writeln(textA);
}
//]]>
</SCRIPT>
<!-- End of link to dynamic table --><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="25%" id="d0e31">Field Name</th>
<th valign="top" width="50%" id="d0e33">Description</th>
<th valign="top" width="25%" id="d0e35">Attribute</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="25%" headers="d0e31 ">INTNUM</td>
<td valign="top" width="50%" headers="d0e33 ">Interval number: The nth sample database interval based on the start
time specified in the <span class="cmdname">Create Performance Data (CRTPFRDTA)</span> command.</td>
<td valign="top" width="25%" headers="d0e35 ">PD (5,0)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">DTETIM</td>
<td valign="top" width="50%" headers="d0e33 ">Interval date (yymmdd) and time (hhmmss): The date and time of the
sample interval.</td>
<td valign="top" width="25%" headers="d0e35 ">C (12)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">INTSEC</td>
<td valign="top" width="50%" headers="d0e33 ">Elapsed interval seconds: The number of seconds since the last sample
interval.</td>
<td valign="top" width="25%" headers="d0e35 ">PD (7,0)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">DTECEN</td>
<td valign="top" width="50%" headers="d0e33 ">Century digit: where 0 indicates 19XX and 1 indicates 20XX.</td>
<td valign="top" width="25%" headers="d0e35 ">C (1)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">JWNAME</td>
<td valign="top" width="50%" headers="d0e33 ">Job / task name.</td>
<td valign="top" width="25%" headers="d0e35 ">C (16)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">JWUSER</td>
<td valign="top" width="50%" headers="d0e33 ">Job user.</td>
<td valign="top" width="25%" headers="d0e35 ">C (10)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">JWNBR</td>
<td valign="top" width="50%" headers="d0e33 ">Job number.</td>
<td valign="top" width="25%" headers="d0e35 ">C (6)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">JWTDE</td>
<td valign="top" width="50%" headers="d0e33 ">System task identifier.</td>
<td valign="top" width="25%" headers="d0e35 ">C (8)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 "><img src="./delta.gif" alt="Start of change" />JWCURT<img src="./deltaend.gif" alt="End of change" /></td>
<td valign="top" width="50%" headers="d0e33 "><img src="./delta.gif" alt="Start of change" />Current Wait Time: The time in milliseconds the job has spent in the
current wait. See JWCURB field for the counter set (bucket) which will be
updated when the current wait completes. (This time is not included in other
wait counter sets).<img src="./deltaend.gif" alt="End of change" /></td>
<td valign="top" width="25%" headers="d0e35 "><img src="./delta.gif" alt="Start of change" />B (9,0)<img src="./deltaend.gif" alt="End of change" /></td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">JWCURE</td>
<td valign="top" width="50%" headers="d0e33 ">Reserved.</td>
<td valign="top" width="25%" headers="d0e35 ">B (9,0)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 "><img src="./delta.gif" alt="Start of change" />JWCURB<img src="./deltaend.gif" alt="End of change" /></td>
<td valign="top" width="50%" headers="d0e33 "><img src="./delta.gif" alt="Start of change" />Current Counter Set (bucket): If this field is non-zero, it reflects
the counter set that will be updated when the wait completes.<img src="./deltaend.gif" alt="End of change" /></td>
<td valign="top" width="25%" headers="d0e35 "><img src="./delta.gif" alt="Start of change" />B (4,0)<img src="./deltaend.gif" alt="End of change" /></td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">JWDSEQ</td>
<td valign="top" width="50%" headers="d0e33 ">Description sequence number: Identifies the QAPMJOBWTD records associated
with this wait data.</td>
<td valign="top" width="25%" headers="d0e35 ">B (4,0)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 "><img src="./delta.gif" alt="Start of change" />JWBGN<img src="./deltaend.gif" alt="End of change" /></td>
<td valign="top" width="50%" headers="d0e33 "><img src="./delta.gif" alt="Start of change" />Beginning number of the first counter set reported in this record.
(see Note 1)<img src="./deltaend.gif" alt="End of change" /></td>
<td valign="top" width="25%" headers="d0e35 "><img src="./delta.gif" alt="Start of change" />B (4,0)<img src="./deltaend.gif" alt="End of change" /></td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">JWCT01</td>
<td valign="top" width="50%" headers="d0e33 ">Count 1. The number of times the job encountered wait conditions associated
with this group.</td>
<td valign="top" width="25%" headers="d0e35 ">B (9,0)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 ">JWTM01</td>
<td valign="top" width="50%" headers="d0e33 ">Time 1. The time in milliseconds the job spent waiting within this
group.</td>
<td valign="top" width="25%" headers="d0e35 ">B (9,0)</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e31 "><img src="./delta.gif" alt="Start of change" />JWCTnn JWTMnn<img src="./deltaend.gif" alt="End of change" /></td>
<td valign="top" width="50%" headers="d0e33 "><img src="./delta.gif" alt="Start of change" />Count and time are repeated for up to 16 counter sets per record. The
first record reports counter sets 1 to 16. If there are more than 16 counter
sets, the second record for the same job reports counter sets 17 to 32. (also
see Note 1)<img src="./deltaend.gif" alt="End of change" /></td>
<td valign="top" width="25%" headers="d0e35 "><img src="./delta.gif" alt="Start of change" />(B (9,0) + B (9,0) ) * 15<img src="./deltaend.gif" alt="End of change" /></td>
</tr>
</tbody>
</table>
</div>
<div class="note"><span class="notetitle">Note:</span> <img src="./delta.gif" alt="Start of change" /><ol><li>When QAPMJOBWT file was created from data collected on a system with operating
system version prior to <span class="keyword">i5/OS™</span> V5R4,
up to 32 counter sets can be reported, and all reported counter sets should
be considered to obtain the complete set of wait state data for the job.<p>When
data was collected on a system with operating system version <span class="keyword">i5/OS</span> V5R4
or later, only the first 16 counter sets should be used for the complete set
of job wait state data.</p>
<p>Counter sets with numbers greater than 16 (reported
in the second record for the job) represent additional information about wait
conditions and will only appear on a system with service activity in progress.
Data for these counter sets should normally be ignored and only used under
instruction from IBM service representative.</p>
</li>
<li>Wait counters are updated when a job wakes up from a wait; therefore,
counters for a job that is currently waiting will not change and the job will
not even be reported if it has done no processing in the interval. When the
wait is eventually reported, it may be longer than the interval it was reported
in.</li>
</ol>
<img src="./deltaend.gif" alt="End of change" /></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzahxapsparent.htm" title="Managing performance on iSeries systems requires the use of a variety of specialized applications. Each of these applications offers a specific insight into system performance. This topic explains several applications and the intended use of each application.">Applications for performance management</a></div>
</div>
</div>
</body>
</html>