Collection Services data files: QAPMJOBWT
This database file contains information about job, task, and thread wait conditions.
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).
Normally these entries contain individual data for each task and secondary thread that consumed CPU during the interval; however, tasks and secondary threads that both start and end in an interval and have a lifespan that is shorter than the reporting threshold will not be individually reported. Instead records will be added to report this activity each interval by job and node. See field JBSLTCNT in file QAPMJOBMI to identify these entries.
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.
Although the file contains fields for up to 32 sets of counters, not all may be used. The counter sets (buckets) actually used are reported in a separate file QAPMJOBWTD.
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® 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.
| Field Name | Description | Attribute |
|---|---|---|
| INTNUM | Interval number: The nth sample database interval based on the start time specified in the Create Performance Data (CRTPFRDTA) command. | PD (5,0) |
| JWTDE | System task identifier. | X (8) |
| JWCURT | Current Wait Time: The time in microseconds 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). | B (9,0) |
| JWCURE | Reserved. | B (9,0) |
| JWCURB | Current Counter Set (bucket): If this field is non-zero, it reflects the counter set that will be updated when the wait completes. | B (4,0) |
| JWDSEQ | Description sequence number: Identifies the QAPMJOBWTD records associated with this wait data. | B (4,0) |
| JWCT01 | Count 1. The number of times the job encountered wait conditions associated with this group. | B (9,0) |
| JWTM01 | Time 1. The time in microseconds the job spent waiting within this group. | B (9,0) |
| JWCTnn JWTMnn | Count and time are repeated for up to 32 counter sets per record. See note 1. |
- When QAPMJOBWT file data was collected on a system with operating system version i5/OS V5R4, only the first 16 counter sets are provided.
- A job that is waiting will not be reported if it has done no processing in the interval. However, current waits for jobs that have used no CPU are reported in the wait gap file QAPMJOBWTG.