Go to Home Page
Questions?
Call 1-800-572-5517
 
  Go to Home Page  
  See all products
  See price schedules
  See manuals, tutorials, articles
  Download a free 30-day trial
  See user testimonials
  About Pacific Systems Group
 
 
SMF Tools
  See SMF Record Layouts
  See Sample SMF Reports
  Learn How to Export SMF Data
  Download Free SMF Reporting Software (30 days)
 
One of the greatest SMF record parsing programming languages I've ever seen. Chief, Large Systems Services Branch, NIH
  Choose Spectrum Writer to add 4GL to your product
  Free 60-Page Book (PDF) - How to Make an SMF Report
Spectrum DCOLLECT Reporter - the 4GL DCOLLECT Report Writer.

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

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!

SMF Spectrum Writer
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.
 
Try It FREE Now!

SMF Type 88 Record -- System Logger Data - z/OS 1.11
Offset
(Dec.)
Offset
(Hex)
NameLengthFormatDescription
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)
00SMF88LEN2binary
Record length. This field and the next field (total of four bytes) form the RDW (record descriptor word).
22SMF88SEG2binary
Segment descriptor (see record length field).
44SMF88FLG1binary
System indicator: Bit Meaning When Set 0-2 Reserved 3-6 Version indicators* 7 Reserved.
55SMF88RTY1binary
Record Type 88 (X'58').
66SMF88TME4binary
Time since midnight, in hundredths of a second, that the record was moved to the SMF buffer.
10ASMF88DTE4packed
Date that the record was moved to the SMF buffer, in the form 0cyydddF.
14ESMF88SID4EBCDIC
System identification (from the SID parameter in the SMFPRMxx parmlib member).
1812SMF88WID4EBCDIC
Subsystem identifier (STC)
2216SMF88STP2binary
Record subtype
2418SMF88SDL4binary
Length of Self-defining Section
281CSMF88POF4binary
Offset to Product Section from start of record, including the record descriptor word (RDW).
3220SMF88PLN2binary
Length of Product Section.
3422SMF88PON2binary
Number of Product Sections in this record.
3624SMF88LOF4binary
Offset to Log Stream Section from start of record, including the record descriptor word (RDW).
4028SMF88LLN2binary
Length of Log Stream Section.
422ASMF88LON2binary
Number of Log Stream Sections in this record.
442CSMF88EOF4binary
Offset to Event Section from start of record, including the record descriptor word (RDW).
4830SMF88ELN2binary
Length of Event Section.
5032SMF88EON2binary
Number of Event Sections in this record.
5234SMF88SOF4binary
Offset to Structure (Interim Storage) Section from start of record, including the record descriptor word (RDW).
5638SMF88SLN2binary
Length of Structure (Interim Storage) Section.
583ASMF88SON2binary
Number of Structure (Interim Storage) Sections in this record.
603CSMF88AOF4binary
Offset to Structure Alter Section from start of record, including the record descriptor word (RDW).
6440SMF88ALN2binary
Length of Structure Alter Section.
6642SMF88AON2binary
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)
00SMF88TYP2binary
Record Subtype 1–Log stream update
22SMF88RVN2EBCDIC
Record version number – 01.
44SMF88PNM8EBCDIC
Product name – SCLOG.
12CSMF88OSL8EBCDIC
MVS operating system name.
2014SMF88SYN8EBCDIC
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)
00SMF88LIT8EBCDIC
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.
88SMF88LSN26EBCDIC
Log stream name.
3422SMF88LFL2EBCDIC
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.

3624SMF88LTD8EBCDIC
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.
442CSMF88LWI4binary
IXGWRITE macro invocations for this log stream issued during the expiring SMF interval.
4830SMF88LIB4binary
Minimum BLOCKLEN value of IXGWRITE seen during the expiring SMF interval. Initialized to X'7FFFFFFF' if no SMF activity occurs within an SMF interval.
5234SMF88LAB4binary
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.
5638SMF88LWB8EBCDIC
Bytes requested by user application(s) on IXGWRITE macro invocations for this log stream during the expiring SMF interval (FORMAT=LONG FLOATING POINT).
6440SMF88LDB8EBCDIC
Bytes written to DASD for this log stream during the expiring SMF interval (FORMAT=LONG FLOATING POINT).
7248SMF88LIO4binary
Number of times a request was made by system logger to write log stream data to DASD during the expiring SMF interval.
7652SMF88LIS4binary
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.
8050SMF88GRP8EBCDIC
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)
00SMF88EDS4binary
Number of log stream DASD shifts initiated by this system during the expiring SMF interval. (FORMAT=32 bits)
44SMF88ERI4binary
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)
88SMF88ERC4binary
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)
12CSMF88ESF4binary
Number of times Logger detected structure full conditions for this Logstream on this system during the expiring SMF interval. (FORMAT=32 bits)
1610SMF88ETT4binary
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)
2014SMF88ETF4binary
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)
2418SMF88EO4binary
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)
281CSMF88EFS4binary
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)
3220SMF88EDO4binary
Number of times an offload was requested via the IXGOFFLD service during the expiring SMF interval. (FORMAT=32 bits)
3624SMF88EAF4binary
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)
4028--16EBCDIC
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)
00SMF88STN16EBCDIC
Name of the structure used for this log stream. For a dasd only log stream, this field will show *DASDONLY*.
1610SMF88SWB8EBCDIC
Current written bytes count. Count of bytes written to interim storage during this interval (FORMAT= LONG FLOATING POINT).
2418SMF88SIB8EBCDIC
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.
3220SMF88SAB8EBCDIC
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.
4028--4EBCDIC
Reserved.
442CSMF88SII4binary
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.
4830SMF88SAI4binary
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).
5234SMF88SC14binary
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.
5638SMF88SC24binary
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.
603CSMF88SC34binary
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.
6440--4binary
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)
00SMF88ANM16EBCDIC
Structure Name
1610SMF88ATK8binary
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.
2418SMF88AIT8binary
SMF-counter instance token identifies a connection to structure. It ties together SMF records for a given instance of a connection to the structure.
3220SMF88AWB8binary
Current written bytes count. Count of bytes written to the structure from this system and associated with this alter token, for this interval.
4028SMF88AO4binary
The number of offloads that occurred on this system associated with this alter token, for this interval.
442CSMF88ACB4binary
Current allocated average buffer size, which system logger uses to calculate entry-to-element ratio for the structure.
4830SMF88ATB4binary
Targeted average buffer size that system logger tried to achieve by altering the element to entry ratio.
5234SMF88ASZ4binary
Structure size in 4K blocks.
5638SMF88ATW4binary
Total number of log writes to the structure during the interval.
603CSMF88ALS4binary
Total number of log streams connected to the structure on this system at the recording.
6440SMF88AFG1binary
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.

Copyright 2017.
Pacific Systems Group.
All rights reserved.


Spectrum Writer 4GL - the economical alternative to SAS, Easytrieve, DYL-280...

Home | Products | Prices | Documentation | 30-Day Trials | Customer Reviews | Company | FAQ | Sample Reports | SMF Records
Send Your Comments or Questions