








	*SMF Tools*

SMF Type 88 Record

This table shows the record layout for type 88 SMF records
(System Logger Data - z/OS 1.10).

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

Purpose: Record type 88 is produced in response to ENF signal 37, which indicates that the SMF global recording interval has ended. Each record reports system logger activity for one log stream or structure. Record values from multiple systems can be summed to give the sysplex view of system logger activity.

Record type 88 has the following subtypes; each contains a header and product section and sections unique for each record:

Subtype 1 - Records log stream activity.

You can use system logger activity data to identify high or low users of system logger services. System logger event data indicates conditions that cause system logger services to be unavailable, such as the STRUCTURE FULL condition for a coupling facility log stream. You can also use system logger activity data to perform capacity planning or configuration analysis.

The structure-related data in subtype 1 allows you to analyze input/output to interim storage for a log stream in terms of one input stream and two output streams. The input is the count of bytes written to interim storage (SMF88SWB).

The two outputs are the count of the number of bytes deleted from interim storage under two scenarios:

– Bytes deleted before the data was offloaded to DASD log data sets. (SMF88SIB).
– Bytes deleted after data was offloaded to DASD log data sets (SMF88SAB).

If the first output count is high and the second is low, system logger is successfully using interim storage to avoid the I/O incurred by offloading to DASD log data sets.

Subtype 11 -

Records coupling facility structure alter activity, which is the changes to the entry-to-element ratio made by system logger for coupling facility structures associated with coupling facility log streams. This information allows you to monitor how system logger is managing the entry-to-element ratio for coupling facility structures.

It's easy to report on SMF 88 data!

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 88 Record -- System Logger Data - z/OS 1.10
Offset (Dec.)	Offset (Hex)	Name	Length	Format	Description
Self-Defining Section This section contains the common SMF record headers fields and the triplet fields (offset/length/number) that locate the other sections on the record. This triplet information should be checked prior to accessing a section of the record. All three fields being non-zero mean that the section exists on the record; conversely any of the fields being zero indicates that the section does not exist on the record. The ‘number’ triplet field is the primary indication of the existence of the field. (Offset from beginning of record: 0)
0	0	SMF88LEN	2	binary	Record length. This field and the next field (total of four bytes) form the RDW (record descriptor word).
2	2	SMF88SEG	2	binary	Segment descriptor (see record length field).
4	4	SMF88FLG	1	binary	System indicator: Bit Meaning When Set 0-2 Reserved 3-6 Version indicators* 7 Reserved.
5	5	SMF88RTY	1	binary	Record Type 88 (X'58').
6	6	SMF88TME	4	binary	Time since midnight, in hundredths of a second, that the record was moved to the SMF buffer.
10	A	SMF88DTE	4	packed	Date that the record was moved to the SMF buffer, in the form 0cyydddF.
14	E	SMF88SID	4	EBCDIC	System identification (from the SID parameter in the SMFPRMxx parmlib member).
18	12	SMF88WID	4	EBCDIC	Subsystem identifier (STC)
22	16	SMF88STP	2	binary	Record subtype
24	18	SMF88SDL	4	binary	Length of Self-defining Section
28	1C	SMF88POF	4	binary	Offset to Product Section from start of record, including the record descriptor word (RDW).
32	20	SMF88PLN	2	binary	Length of Product Section.
34	22	SMF88PON	2	binary	Number of Product Sections in this record.
36	24	SMF88LOF	4	binary	Offset to Log Stream Section from start of record, including the record descriptor word (RDW).
40	28	SMF88LLN	2	binary	Length of Log Stream Section.
42	2A	SMF88LON	2	binary	Number of Log Stream Sections in this record.
44	2C	SMF88EOF	4	binary	Offset to Event Section from start of record, including the record descriptor word (RDW).
48	30	SMF88ELN	2	binary	Length of Event Section.
50	32	SMF88EON	2	binary	Number of Event Sections in this record.
52	34	SMF88SOF	4	binary	Offset to Structure (Interim Storage) Section from start of record, including the record descriptor word (RDW).
56	38	SMF88SLN	2	binary	Length of Structure (Interim Storage) Section.
58	3A	SMF88SON	2	binary	Number of Structure (Interim Storage) Sections in this record.
60	3C	SMF88AOF	4	binary	Offset to Structure Alter Section from start of record, including the record descriptor word (RDW).
64	40	SMF88ALN	2	binary	Length of Structure Alter Section.
66	42	SMF88AON	2	binary	Number of Structure Alter Sections in this record.
Product Section This section provides information about the system logger and the system at the time the record was generated. Triplet Information: This section is located in the record using the following triplet fields, which are located in the ‘Header/self-defining’ section: Offset SMF88POF Length SMF88PLN Number SMF88PON(Offset from beginning of record: SMF88POF)
0	0	SMF88TYP	2	binary	Record Subtype 1—Log stream update
2	2	SMF88RVN	2	EBCDIC	Record version number — 01.
4	4	SMF88PNM	8	EBCDIC	Product name — SCLOG.
12	C	SMF88OSL	8	EBCDIC	MVS operating system name.
20	14	SMF88SYN	8	EBCDIC	System name (from SYSNAME parameter in the IEASYSxx parmlib member)
Subtype 1 — Log Stream Section This section identifies the log stream that generated the record and provides general log stream usage statistics. Triplet Information: This section is located on the record using the following triplet fields, which are located in the ‘Header/self-defining’ section: Offset SMF88LOF Length SMF88LLN Number SMF88LON(Offset from beginning of record: SMF88LOF)
0	0	SMF88LIT	8	EBCDIC	SMF-counter instance token identifies a connection to a log stream. It ties together SMF records for a given instance of a connection to a log stream.
8	8	SMF88LSN	26	EBCDIC	Log stream name.
34	22	SMF88LFL	2	EBCDIC	Log stream flags: Bit Meaning When Set 0 Reserved 1 This log stream used staging data sets during the expiring SMF interval. 2 When ON, the SMF record has been generated when the log stream disconnected from the system. 3-15 Reserved.
36	24	SMF88LTD	8	EBCDIC	TOD-time when SMF global interval expired (from parameter list of ENF event 37, which requested this SMF record from logger). Time is reported in GMT.
44	2C	SMF88LWI	4	binary	IXGWRITE macro invocations for this log stream issued during the expiring SMF interval.
48	30	SMF88LIB	4	binary	Minimum BLOCKLEN value of IXGWRITE seen during the expiring SMF interval. Initialized to X'7FFFFFFF' if no SMF activity occurs within an SMF interval.
52	34	SMF88LAB	4	binary	Maximum BLOCKLEN value of IXGWRITE seen by this log stream during the expiring SMF interval. Initialized to zero if no SMF activity occurs within an SMF interval.
56	38	SMF88LWB	8	EBCDIC	Bytes requested by user application(s) on IXGWRITE macro invocations for this log stream during the expiring SMF interval (FORMAT=LONG FLOATING POINT).
64	40	SMF88LDB	8	EBCDIC	Bytes written to DASD for this log stream during the expiring SMF interval (FORMAT=LONG FLOATING POINT).
72	48	SMF88LIO	4	binary	Number of times a request was made by system logger to write log stream data to DASD during the expiring SMF interval.
76	52	SMF88LIS	4	binary	Number of times system logger had to suspend before writing log stream data to DASD because a previously-initiated write to DASD had not yet completed during the expiring SMF interval.
80	50	SMF88GRP	8	EBCDIC	GROUP value for the log stream. Either PROD (production) or TEST.
Subtype 1 — Events Section This section contains flags and counters used for unusual events. Triplet Information: This section is located on the record using the following triplet fields, which are located in the ‘self-defining’ section: Offset SMF88EOF Length SMF88ELN Number SMF88EON(Offset from beginning of record: SMF88EOF)
0	0	SMF88EDS	4	binary	Number of log stream DASD shifts initiated by this system during the expiring SMF interval. (FORMAT=32 bits)
4	4	SMF88ERI	4	binary	Number of structure rebuild events initiated for this log stream, as seen by this system. Cumulative from the creation of this SMF-counter instance. (FORMAT=32 bits)
8	8	SMF88ERC	4	binary	Number of structure rebuild events completed for this log stream, as seen by this system. Cumulative from the creation of this SMF-counter instance. (FORMAT=32 bits)
12	C	SMF88ESF	4	binary	Number of times Logger detected structure full conditions for this Logstream on this system during the expiring SMF interval. (FORMAT=32 bits)
16	10	SMF88ETT	4	binary	Number of times system logger detected a Staging Data Set Threshold Hit condition for this log stream on this system during the expiring SMF interval. (FORMAT=32 bits)
20	14	SMF88ETF	4	binary	Number of times system logger detected a Staging Data Set Full condition for this log stream on this system during the expiring SMF interval. (FORMAT=32 bits)
24	18	SMF88EO	4	binary	Number of successful offloads (greater than one byte of data) performed for this log stream on this system during the expiring interval. (FORMAT=32 bits)
28	1C	SMF88EFS	4	binary	Number of times IXGLOGR initiated an offload for all the log streams connected on this system to the structure due to the structure's total in-use list entries reaching 90% of the total available entries for the structure. This count is the number of occurrences of this condition for the expiring interval. (FORMAT=32 bits)
32	20	SMF88EDO	4	binary	Number of times an offload was requested via the IXGOFFLD service during the expiring SMF interval. (FORMAT=32 bits)
36	24	SMF88EAF	4	binary	Number of times IXGLOGR detected 'Staging-Dataset- Async-Buffer_Full' condition for this logstream on this system during the expiring SMF interval. (FORMAT=32 bits)
40	28	--	16	EBCDIC	Reserved.
Subtype 1 — Structure (Interim Storage) Section This section contains information related to the interim storage for a log stream. For a coupling facility log stream, interim storage is coupling facility structure space allocated to the log stream. For a dasd only log stream, interim storage is staging data set space. Triplet Information: This section is located on the record using the following triplet fields, which are located in the ‘self-defining’ section: Offset SMF88SOF Length SMF88SLN Number SMF88SON(Offset from beginning of record: SMF88SOF)
0	0	SMF88STN	16	EBCDIC	Name of the structure used for this log stream. For a dasd only log stream, this field will show DASDONLY.
16	10	SMF88SWB	8	EBCDIC	Current written bytes count. Count of bytes written to interim storage during this interval (FORMAT= LONG FLOATING POINT).
24	18	SMF88SIB	8	EBCDIC	Current instead bytes count. Count of bytes deleted from interim storage during this interval, instead of being offloaded (FORMAT=LONG FLOATING POINT). This field is incremented due to either a user invocation of IXGDELET where the data had not been offloaded or system logger internal management of interim storage.
32	20	SMF88SAB	8	EBCDIC	Current after bytes count. Count of bytes deleted from interim storage during this interval, after being offloaded (FORMAT=LONG FLOATING POINT). This field is incremented by system logger's internal management of interim storage.
40	28	--	4	EBCDIC	Reserved.
44	2C	SMF88SII	4	binary	Current instead invocation count. Count of times a deletion from interim storage for this log stream was performed during this interval, where the data was not first offloaded.
48	30	SMF88SAI	4	binary	Current after invocation count. Count of times a deletion from interim storage was performed during this interval, after being offloaded (occurs due to system logger management of interim storage).
52	34	SMF88SC1	4	binary	The count of type-1 completions during the expired SMF interval. The Logstream contents can remain in the primary storage. No need to move data from primary storage to DASD. This field is valid for both coupling facility and DASDONLY Logstreams.
56	38	SMF88SC2	4	binary	The count of type-2 completions during the expired SMF interval. Logstream is filling the primary storage but space is not critical. System Logger begins asynchronous offloading of Logstream data from the primary storage to DASD. This field is valid for both coupling facility and DASDONLY Logstreams.
60	3C	SMF88SC3	4	binary	The count of type-3 completions during the expired SMF interval. Space used in the structure (by this Logstream) is critical but does not exceed 100 percent. This field is only valid for coupling facility based Logstreams.
64	40	--	4	binary	Reserved
Subtype 11 — Structure Alter Section This section identifies a structure and provides statistics on system logger's management of the structures entry to element ratio. Triplet Information: This section is located on the record using the following triplet fields, which are located in the ‘self-defining’ section: Offset SMF88AOF Length SMF88ALN Number SMF88AON(Offset from beginning of record: SMF88AOF)
0	0	SMF88ANM	16	EBCDIC	Structure Name
16	10	SMF88ATK	8	binary	Alter Token, which is a STCK timestamp, showing last time the element to entry ratio was altered to accommodate the average buffer size being written to the structure.
24	18	SMF88AIT	8	binary	SMF-counter instance token identifies a connection to structure. It ties together SMF records for a given instance of a connection to the structure.
32	20	SMF88AWB	8	binary	Current written bytes count. Count of bytes written to the structure from this system and associated with this alter token, for this interval.
40	28	SMF88AO	4	binary	The number of offloads that occurred on this system associated with this alter token, for this interval.
44	2C	SMF88ACB	4	binary	Current allocated average buffer size, which system logger uses to calculate entry-to-element ratio for the structure.
48	30	SMF88ATB	4	binary	Targeted average buffer size that system logger tried to achieve by altering the element to entry ratio.
52	34	SMF88ASZ	4	binary	Structure size in 4K blocks.
56	38	SMF88ATW	4	binary	Total number of log writes to the structure during the interval.
60	3C	SMF88ALS	4	binary	Total number of log streams connected to the structure on this system at the recording.
64	40	SMF88AFG	1	binary	Alter Flags Bit Meaning When Set 0 When ON, record was generated to report a change in the average buffer size being written to the structure. 1 When ON, record was generated due to the last log stream disconnecting which resulted in the structure being disconnected. 2-7 Reserved.

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.

SMF Type 88 Record

This table shows the record layout for type 88 SMF records (System Logger Data - z/OS 1.10).

It's easy to report on SMF 88 data!

This table shows the record layout for type 88 SMF records
(System Logger Data - z/OS 1.10).