Introduction
The type 89 record provides information about product usage on a particular MVS™ system. The usage reporting program analyzes the data collected in the type 89 record. For more information see z/OS MVS Product Management. The record is generated on a scheduled interval (1 hour maximum).
Subtype 1 — Usage data
Contains, for the scheduled interval, summary usage data for all products across the system that have registered to request usage recording. These products must issue the IFAUSAGE macro to specify:
Registration information.
Level and scope of data collection (task or address space level).
Start and end of collection period.
For more information on the IFAUSAGE macro, see IFAUSAGE — Collecting usage data.
The installation controls the scheduling of the type 89 record by checking the INTERVAL value specified for the SMF address space. Because SMF is a started task, this is the INTERVAL value for SUBSYS=STC in the SMFPRMxx member. If the INTERVAL value is less than or equal to one hour, then that value is used as the reporting interval for type 89 records. If that value is greater than one hour, or if no INTERVAL value is specified, then one hour is used as the reporting interval for type 89 recording.
There are two sets of interval START and STOP times in the record:
Usage data interval START/STOP.
Reporting interval START/STOP.
The usage data interval represents the hourly buckets that the usage reporting program records product usage in. This interval is synchronized to the top of the hour.
The reporting interval represents the increment when the type 89 records are generated and is also synchronized to the top of the hour. For example, if you specified an interval value of 30 minutes, type 89 records would be generated at 9:00, 9:30, 10:00... If you are collecting usage data at the task level, you may want to synchronize interval processing to the top of the hour in your SMFPRMxx member because task level data collection is scheduled by interval processing.
SMF type 89 records are generated on the interval as requested; if no products are registered, then a type 89 record is generated with a product count of 0.
Product intersection time data sections are generated when a product registers at the ADDRSP level, and then invokes a product that registers at the TASK level. When no product intersections occur, the product intersection count in SMF89CNN is zero.
Product intersection time data sections are generated when a product registers at the ADDRSP level, and then invokes a product that registers at the TASK level.
When no product intersections occur, the product intersection count in SMF89CNN is zero.
Fields
Stored in swUsageData
| SMF Field | DB Column name | Description |
|---|---|---|
| recordType | Value is always SW1P | |
| startTime | ||
| endTime | ||
| sid | ||
| SMF89PNM | recordName | Record product name |
| SMF89RVN | recordVersion | Record version number |
| SMF89OSL | mvsLevel | MVS™ system level (For example, SP4.3.0) |
| SMF89PFL | flag | True if SMF field equal to 1 |
| SMF89_CoreMode_CP | totCpCpus | The number of CPUs that are active on a CP core |
| SMF89_CoreMode_zAAP | totZpCpus | The number of CPUs that are active on a zAAP core |
| SMF89_CoreMode_zIIP | totSeCpus | The number of CPUs that are active on a zIIP core |
| SMF89SYN | sysName | MVS™ system name (SYSNAME from IEASYSxx) |
| SMF89CMN | modelNum | CPU model number |
| SMF89CVN | cpuVersion | CPU version number |
| SMF89SER | cpuSerial | CPU serial number |
| SMF89LP3 | lparId | LPAR ID |
| SMF89RPP | processingPower | CPU relative processing power indicator |
| SMF89SPN | sysplex | Sysplex name (from the SYSPLEX parameter in the COUPLExx parmlib member) |
| SMF89CPT | cpcType | CPC type number (blanks if data is not available) |
| SMF89CPM | cpcModel | CPC model number (blanks if data is not available) |
| SMF89CPS | cpcSequence | CPC sequence number (blanks if data is not available) |
| SMF89CPC | cpuCapability | CPU capability |
| SMF89CCC | cpuConfig | Configured CPU count |
| SMF89SCC | cpuStandby | Standby CPU count |
| SMF89UPO | prodOwner | Product owner or vendor name (specified on the PRODOWNER option of the IFAUSAGE macro) |
| SMF89UPN | prodName | Product name (specified on the PRODNAME option of the IFAUSAGE macro) |
| SMF89UPV | prodVer | Product version (specified on the PRODVERS option of the IFAUSAGE macro) |
| SMF89UPQ | prodQual | Product qualifier (specified on the PRODQUAL option of the IFAUSAGE macro) |
| SMF89UPI | prodId | Product ID number (specified on the PRODID option of the IFAUSAGE macro) |
| SMF89UCT | tcbTime | Product TCB time |
| SMF89USR | srbTime | Product SRB time |
| SMF89UZT | prodOfflEngineTime | Product offload engine time |
| actionId |