








	*SMF Tools*

SMF Type 89 Record

This table shows the record layout for type 89 SMF records
(RACF Usage - z/OS 1.10).

List of other SMF record layouts available.
List of sample SMF reports.

Purpose: The type 89 record provides information about product usage on a particular MVS system. 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.
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.

It's easy to report on SMF 89 data! (Jump to sample reports)

We have a low-cost 4GL report writer especially for SMF files. It's called Spectrum SMF Writer.

Spectrum SMF Writer handles the difficult SMF record parsing for you automatically. You just specify which fields you want to see.

Spectrum SMF Writer also converts the arcane date and time fields and reformats them into an attractive report.

Plus, Spectrum SMF Writer can export SMF data as comma delimited files to use on your PC.

SMF Type 89 Record -- RACF Usage - z/OS 1.10
Offset (Dec.)	Offset (Hex)	Name	Length	Format	Description
0	0	SMF89LEN	2	binary	Record length. This field and the next field (total of four bytes) form the RDW (record descriptor word).
2	2	SMF89SEG	2	binary	Segment descriptor (see record length field).
4	4	SMF89FLG	1	binary	System indicator: Bit Meaning When Set 0-2 Reserved 3-6 Version indicators* 7 Reserved.
5	5	SMF89RTY	1	binary	Record type 89 (X'59').
6	6	SMF89TME	4	binary	Time since midnight, in hundredths of a second, that the record was moved to the SMF buffer.
10	A	SMF89DTE	4	packed	Date that the record was moved to the SMF buffer, in the form 0cyydddF.
14	E	SMF89SID	4	EBCDIC	System identification (from the SID parameter in the SMFPRMxx parmlib member).
18	12	SMF89WID	4	EBCDIC	Subsystem identifier for the SMF address space - ‘STC' for Started Task.
22	16	SMF89STP	2	binary	Record subtype 1 Usage Data Interval Record 2 State Data Interval Record
24	18	SMF89SDL	4	binary	Length of self-defining section - '28'
Self-Defining Section This section contains the triplet fields (offset/length/number) that locate other sections on the record. This triplet information should be checked prior to accessing a section of the record. The ‘number’ triplet field is the primary indication of the existence of the field. This section is an extension of the header and follows it physically in the record.(Offset from beginning of record: 28)
0	0	SMF89PRO	4	binary	Offset to Record Product section from start of record, including the record descriptor word (RDW).
4	4	SMF89PRL	2	binary	Length of Record Product section - ‘36’.
6	6	SMF89PRN	2	binary	Number of Record Product sections - ‘1’.
8	8	SMF89SIO	4	binary	Offset to System ID section from start of record, including the record descriptor word (RDW).
12	0C	SMF89SIL	2	binary	Length of System ID section - ‘76’.
14	0E	SMF89SIN	2	binary	Number of System ID sections on record - ‘1’.
16	10	SMF89UDO	4	binary	Offset to first Usage or State Data section from start of record, including the record descriptor word (RDW).
20	14	SMF89UDL	2	binary	Length of each Usage Data section (‘84’) or State Data section (‘68’).
22	16	SMF89UDN	2	binary	Number of Usage or State Data sections on record (minimum of ‘0’).
24	18	SMF89UDR	4	binary	Number of State Data sections remaining (or ‘0’ for Usage Data section)
Record Product Section This section provides information about the type 89 record, the system, and the recording interval. Triplet Information: This section is located in the record using the following triplet fields, which are located in the ‘self-defining’ section: Offset SMF89PRO Length SMF89PRL Number SMF89PRN - This field is always ‘1’ because each type 89 record that is generated has one record product section.(Offset from beginning of record: SMF89PRO)
0	0	SMF89PNM	8	EBCDIC	Record product name - ‘SMF’.
8	8	SMF89RVN	4	binary	Record version number - ‘1’.
12	0C	SMF89OSL	8	EBCDIC	MVS system level (ie. ‘SP4.3.0’).
20	14	SMF89IST	4	binary	Reporting interval START Time (local, hundredths of a second from midnight). This field and SMF89IET define the recording interval. This is different from the usage data interval that is used to collect data into hourly buckets.
24	18	SMF89ISD	4	packed	Reporting interval START Date in the form 0cyydddF.
28	1C	SMF89IET	4	binary	Reporting interval END Time (local, hundredths of a second from midnight). This field and SMF89IST define the recording interval. This is different from the usage data interval that is used to collect data into hourly buckets.
32	20	SMF89IED	4	packed	Reporting interval END Date in the form 0cyydddF.
36	24	SMF89PFL	1	binary	Bit Meaning When Set 0 reserved 1 Indicates that LICENSE=zNALC was specified in IEASYSxx. (SMF89ZNA) 2 - 7 reserved
37	25	--	3	binary	Reserved
40	28	SMF89HOF	8	binary	Hypervisor date/time offset in STCK format. When present, this field contains the sysplex timer offset value.
48	36	SMF89DTO	8	binary	Local data/time offset, copied from CVTLDTO.
System ID Section Triplet Information: This section is located on the record using the following triplet fields, which are located in the ‘self-defining’ section: Offset SMF89SIO Length SMF89SIL Number SMF89SIN - This field is always ‘1’ because each type 89 record that is generated has one system ID section.(Offset from beginning of record: SMF89SIO)
0	0	SMF89SYN	8	EBCDIC	MVS system name (SYSNAME from IEASYSxx).
8	8	SMF89UST	4	binary	Usage data interval START time (local, hundredths of a second from midnight). This will usually be an hour value (such as 01:00:00.00) except in the case of the first record during an IPL (which will report the “IPL” time). This is different from the recording interval which is used to report on the generation of the usage records. This field and SMF89UET define the hour ‘bucket’ that the usage data reflects.
12	0C	SMF89USD	4	packed	Usage data interval START Date in the form 0cyydddF.
16	10	SMF89UET	4	binary	Usage data interval END time (local, hundredths of a second from midnight). This will usually be an hour value (such as 01:00:00.00). This field and SMF89UST define the hour ‘bucket’ that the usage data reflects.
20	14	SMF89UED	4	packed	Usage data interval END date in the form 0cyydddF.
24	18	--	4	binary	Reserved.
28	1C	--	4	binary	Reserved.
32	20	SMF89CMN	2	packed	CPU model number.
34	22	SMF89CVN	1	binary	CPU version number.
35	23	SMF89LPI	1	binary	LPAR indicators: Bit Meaning When Set 0 The one digit LPAR ID contained in SMF89LP2 (bit 4) is valid (SMF89LPV) 1 The two digit LPAR ID contained in field SMF89LP3 is valid (SMF89LPM) 2 - 3 reserved 4-7 The one digit LPAR ID (X'0-F') (SMF89LP2)Notes: 1. For one digit LPAR IDs (X'0-F'), both SMF89LPV (bit 0) and SMF89LPM (bit 1) will be on and both SMF89LP2 (bits 4-7) and field SMF89LP3 will contain the LPAR ID. 2. For two digit LPAR IDs (greater than X'F'), SMF89LPM (bit 1) will be on, and SMF89LP3 will contain the LPAR ID.
36	24	SMF89SER	1	packed	CPU serial number.
39	27	SMF89LP3	1	binary	LPAR ID.
40	28	SMF89RPP	4	binary	CPU relative processing power indicator
44	2C	SMF89SPN	8	EBCDIC	Sysplex name (from the SYSPLEX parameter in the COUPLExx parmlib member).
52	34	SMF89CPT	6	EBCDIC	CPC type number (blanks if data is not available)
58	3A	SMF89CPM	3	EBCDIC	CPC model number (blanks if data is not available)
61	3D	SMF89CPS	12	EBCDIC	CPC sequence number (blanks if data is not available)
73	49	SMF89SIF	1	binary	Bit Meaning When Set 0 Field SMF89LPN is valid. (SMF89LNV) 1 - 7 reserved
74	4A	--	2	binary	Reserved.
76	4C	SMF89MNF	16	EBCDIC	V1-CPC manufacturer
92	5C	SMF89TID	4	EBCDIC	V1-CPC type
96	60	SMF89MDL	16	EBCDIC	V1-CPC model
112	70	SMF89SQC	16	EBCDIC	V1-CPC sequence code
128	80	SMF89POM	4	EBCDIC	V1-CPC plant of manufacturer
132	84	SMF89CPC	4	binary	CPU capability
136	88	SMF89CCC	2	binary	Configured CPU count
138	8A	SMF89SCC	2	binary	Standby CPU count
140	8C	SMF89MAF	30	binary	Array of multiprocessing CPU capability adjustment factors
170	AA	SMF89LPN	8	EBCDIC	LPAR name when SYSIB 2.2.2 is valid, when returned by the STSI instruction (such as when running under z/VM). Bit SMF89LPV is on when the field is valid. Avoid looking at this field unless SMF89LNV is on.
Subtype 1 — Usage Data Section This section contains the product information (specified on the IFAUSAGE REGISTER request) and the usage data that has been collected for the interval specified by the start and end times (SMF89UST and SMF89UET) for that product. There will be one usage data section for each unique product identification (specified by owner, name, version, qualifier) that is actively registered for any part of that specified interval. The data reported will be accumulated for ALL address spaces that had any interaction with the product. Triplet Information: This section is located on the record using the following triplet fields, which are located in the ‘self-defining’ section: Offset SMF89UDO Length SMF89UDL Number SMF89UDN(Offset from beginning of record: SMF89UDO)
0	0	SMF89UPO	16	EBCDIC	Product owner or vendor name (specified on the PRODOWNER option of the IFAUSAGE macro).
16	10	SMF89UPN	16	EBCDIC	Product name (specified on the PRODNAME option of the IFAUSAGE macro).
32	20	SMF89UPV	8	EBCDIC	Product version (specified on the PRODVERS option of the IFAUSAGE macro).
40	28	SMF89UPQ	8	EBCDIC	Product qualifier (specified on the PRODQUAL option of the IFAUSAGE macro).
48	30	SMF89UPI	8	EBCDIC	Product ID number (specified on the PRODID option of the IFAUSAGE macro).
56	38	SMF89UCT	8	long	floating point Product TCB time (in hundredths of a second).
64	40	SMF89USR	8	long	floating point Product SRB time (in hundredths of a second).
72	48	SMF89UFG	1	binary	Usage entry flags Bit Meaning When Set 0 Unauthorized register 1-7 Unused
73	49	--	2	binary	Reserved.
75	4B	SMF89URT	1	binary	Data format of value in SMF89URD (specified on the FORMAT option of the IFAUSAGE macro FUNCTIONDATA request). 0 No data specified 1 CPU Time in long floating point (in hundredths of a second). 2 Binary (64-bit) 3 long floating point
76	4C	SMF89URD	8	BIN	Product specific resource data (specified by the data option of the IFAUSAGE macro FUNCTIONDATA request). SMF89URT identifies the format of the data in this field.
Subtype 2 — State Data Section This section contains the product information (specified on the MVS Register service or in the IFAPRDxx parmlib member) and the state data that has been collected for the interval specified by the start and end times (SMF89UST and SMF89UET) for that product. There will be one state data section for each unique product identification (specified by owner, name, feature, version, release, and modification level) registered for any part of the interval. Triplet Information: This section is located on the record using the following triplet fields, which are located in the ‘self-defining’ section: Offset SMF89UDO Length SMF89UDL Number SMF89UDN
0	0	SMF89T2ProdOwner	16	EBCDIC	Product owner or vendor name (from the prodowner parameter on the Register service or the OWNER field on the PROD statement in IFAPRDxx).
16	10	SMF89T2ProdName	16	EBCDIC	Product name (from the prodname parameter on the Register service or the NAME field on the PROD statement in IFAPRDxx).
32	20	SMF89T2FeatureName	16	EBCDIC	Feature name (from the featurename parameter on the Register service or the FEATURENAME field on the PROD statement in IFAPRDxx).
48	30	SMF89T2ProdVers	2	EBCDIC	Product version (from the prodvers parameter on the Register service or the VERSION field on the PROD statement in IFAPRDxx).
50	32	SMF89T2ProdRel	2	EBCDIC	Product release (from the prodrel parameter on the Register service or the RELEASE field on the PROD statement in IFAPRDxx).
52	34	SMF89T2ProdMod	2	EBCDIC	Product modification level (from the prodmod parameter on the Register service or the MOD field on the PROD statement in IFAPRDxx).
54	36	SMF89T2ProdID	8	EBCDIC	Product identifier (from the prodID parameter on the Register service or the ID field on the PROD statement in IFAPRDxx).
62	3E	SMF89T2Flags	1	binary	State entry flags Bit Meaning When Set 0 Entry is not defined in IFAPRDxx 1 Entry is enabled in IFAPRDxx 2-3 Reserved 4 Register entry 5 State entry 6 ‘No Report’ entry — registered with Ifaedreg_Type_NoReport 7 Registered with Ifaedreg_Type_LicensedUnderProd
63	3F	--	1	EBCDIC	Reserved.
64	40	SMF89T2NumInstances	4	binary	Number of instances of registration for this product.

The table above is based on the description provided by IBM in its "MVS Systems Management Facilities (SMF)" manual.

Spectrum SMF Writer - the 4GL SMF Report Writer.

Sample RACF Report from SMF 89 Subtype 1 Records

The sample SMF report below was created with Spectrum SMF Writer, the low-cost 4GL SMF report writer.

It reads as input the SMF file and selects just the type 89 (RACF Usage) records. (See SMF 89 record layout.)

We print a report showing the TCB and SRB time for each monitored product during each recording interval. The information is sorted and report by Sysplex name, then by System name and finally by Product name, with subtotals for each product. We have report both the TCB and SRB times in two ways: as the number of seconds, as they appear in the record. And again after converting the seconds into standard hour, minute and second notation. Spectrum SMf Writer makes this easy with its powerful built-in time handling functions.

All of this with just a few lines of code!
Why not install a Spectrum SMF Writer trial right now and start making your own SMF reports!

These Spectrum SMF Writer Statements:

INPUT:  SMF89V10

INCLUDEIF: SMF89RTY = 89 AND SMF89STP=1

COMPUTE: TCB_TIME = #MAKETIME(SMF89UCT)
COMPUTE: SRB_TIME = #MAKETIME(SMF89USR)

COLUMNS:
     SMF89SYN('MVS|SYSTEM|NAME')
     SMF89UST('INTERVAL|START|TIME')
     SMF89UET('INTERVAL|END|TIME')
     SMF89UPN('PRODUCT|NAME')
     SMF89UCT('TCB|TIME|SECONDS' 12)
     TCB_TIME('TCB|TIME')
     SMF89USR('SRB|TIME|SECONDS' 12)
     SRB_TIME('SRB|TIME')

SORT:  SMF89SPN SMF89SYN SMF89UPN SMF89UST     
BREAK: SMF89UPN SPACE(1)                       

TITLE: 'SMF 89 - RACF INITIALIZATION'
TITLE: 'SUBTYPE 1 - INTERVAL STATS FOR' SMF89SPN 'ON' SMF89USD

Produce This SMF Report:

 
                                    SMF 89 - RACF INITIALIZATION
                         SUBTYPE 1 - INTERVAL STATS FOR ZPACPLX2 ON 10/02/09

   MVS     INTERVAL    INTERVAL                        TCB                      SRB
  SYSTEM     START        END         PRODUCT          TIME         TCB         TIME         SRB
   NAME      TIME        TIME           NAME         SECONDS       TIME       SECONDS       TIME
 ________ ___________ ___________ ________________ ____________ ___________ ____________ ___________

 SYSZ1    11:00:00.00 12:00:00.00 z/OS                 5,342.00 01:29:02.00       305.00 00:05:05.00
 SYSZ1    12:00:00.00 13:00:00.00 z/OS                 3,955.00 01:05:55.00       343.00 00:05:43.00
 *** TOTAL FOR z/OS             (    2 ITEMS)          9,297.00 02:34:57.00       648.00 00:10:48.00

 SYSZ1    11:00:00.00 12:00:00.00 MQM MVS/ESA             69.00 00:01:09.00         0.00 00:00:00.00
 *** TOTAL FOR MQM MVS/ESA      (    1 ITEM )             69.00 00:01:09.00         0.00 00:00:00.00

 SYSZ9    11:00:00.00 12:00:00.00 z/OS                31,090.00 08:38:10.00       318.00 00:05:18.00
 SYSZ9    12:00:00.00 13:00:00.00 z/OS                27,710.00 07:41:50.00       290.00 00:04:50.00
 *** TOTAL FOR z/OS             (    2 ITEMS)         58,800.00 16:20:00.00       608.00 00:10:08.00

 SYSZ9    11:00:00.00 12:00:00.00 IMS/ESA             13,565.00 03:46:05.00         0.00 00:00:00.00
 *** TOTAL FOR IMS/ESA          (    1 ITEM )         13,565.00 03:46:05.00         0.00 00:00:00.00

 
 ****** GRAND TOTAL (     6 ITEMS)                    81,731.00 22:42:11.00     1,256.00 00:20:56.00

See other sample SMF reports.