<?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>