Aggregate bucket sections

The aggregate buckets contain summary data about an IFAWIC exploiter's use of shared resources across multiple address spaces. The aggregate bucket is created from data that an IFAWIC exploiter's exit routine passes to an SMF service to generate SMF type 98 records.

Every IFAWIC exploiter instruments activities in its address space specific buffer. At the end of every 5 second interval, each address space is assigned a job priority (based on its WLM policy importance level) and a job size for each CPU type (relative to the total CPU time for each CPU type). Each IFAWIC exploiter's exit routine is called where the job activity is aggregated by CPU type, job priority, and job size into the aggregate bucket that matches the job attributes. The aggregate bucket summarizes activity for similar jobs.

Note: The SMF 98 records contain buckets that have more than one contributor (SMF98AggBucketEA_Contributors > 0).
You can locate this section in the record by using the following triplet fields which are found in the SMF98WicData section:
Offset
SMF98WicData_AggBucketOF1 or SMF98WicData_AggBucketOF2
Length
SMF98WicData_AggBucketLN1 or SMF98WicData_AggBucketLN2
Number
SMF98WicData_AggBucketON1 orSMF98WicData_AggBucketON2

Note that there are two possible aggregate bucket sections per WIC subtype.

Offsets Name Length Format Description
0 0 SMF98AggBucket * binary Aggregate bucket.
0 0 SMF98AggBucketHdr 6 binary Aggregate bucket header.
0 0 SMF98AggBucketHdr_CPUType 2 binary CPU type for this bucket. Valid values are:
Value (Constant)
Meaning
0 (PSAProcClass_CP)
CP
4 (PSAProcClass_zIIP)
zIIP
2 2 SMF98AggBucketHdr_JobPriority 2 binary Job priority. Valid values are:
Value (Constant)
Meaning
FFFF (SMF98_kPriorityBucket_All)
All
1 (SMF98_kPriorityBucket_1)
Critical
2 (SMF98_kPriorityBucket_2)
High
3 (SMF98_kPriorityBucket_3)
Low
4 (SMF98_kPriorityBucket_4)
Discretionary
4 4 SMF98AggBucketHdr_JobSize 2 binary Job size relative to other jobs in this system for this job priority, for this CPU type. Valid values are:
Value (Constant)
Meaning
FFFF (SMF98_kConsume_SubBucket_All)
All
1 (SMF98_kConsume_SubBucket_1)
Large
2 (SMF98_kConsume_SubBucket_2)
Medium
3 (SMF98_kConsume_SubBucket_3)
Small
4 (SMF98_kConsume_SubBucket_4)
Tiny
6 6 SMF98AggBucketExpArea * binary Aggregate bucket exploiter area.
6 6 SMF98AggBucketEA_Contributors 2 binary Number of address spaces contributing to this bucket entry.
8 8 SMF98AggBucketEA_Data * binary Exploiter data. See the exploiter of the IFAWIC service for their data mapping.