Record type 89 (X'59') — Usage Data

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).

Record type 89 has two subtypes:
  • 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.

  • Subtype 2 — State Data

    Contains, for the scheduled interval, summary state data for all products across the system that have registered to indicate that they are running. These products issue the MVS Register service to indicate that they are running. MVS uses information a product supplies to determine if the product is enabled and to maintain a list of active products.

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.

SMFPRMxx parameters are described in z/OS MVS Initialization and Tuning Reference. The usage reporting program is described in z/OS MVS Product Management. The Register service is described in MVS Programming: Registration Services.