








	*SMF Tools*

SMF Type 17 Record

This table shows the record layout for type 17 SMF records
(Scratch Data Set Status).

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

Purpose: Record type 17 is written when a non-temporary DASD data set or a temporary DASD data set is scratched. This record contains the data set name, number of volumes, and volume serial numbers. The job name, time, and date that the reader recognized the JOB card (for this job) constitute the job log identification. Its length varies, depending upon the number of volumes for the data set. Refer to record type 65 for information on renaming a VSAM object.

Note: You use the REC parameter, in the SMFPRMxx parmlib member, to specify record type 17 is to be collected. REC(ALL) specifies that record type 17 is to be written for both temporary and non-temporary data sets. REC(PERM) specifies that SMF is to write record type 17 only for non-temporary data sets; it is not to be written for temporary data sets (data sets having names that start with SYSyyddd.Thhmmss, either from DSN=&&datasetname or from the absence of any data set name).

It's easy to report on SMF 17 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 17 Record -- Scratch Data Set Status
Offset (Dec.)	Offset (Hex)	Name	Length	Format	Description
0	0	SMF17LEN	2	binary	Record length. This field and the next field (total of four bytes) form the RDW (record descriptor word). See “Standard SMF Record Header” on page 13-1 for a detailed description.
2	2	SMF17SEG	2	binary	Segment descriptor (see record length field).
4	4	SMF17FLG	1	binary	System indicator: Bit Meaning When Set 0-2 Reserved 3-6 Version indicators* 7 Reserved.*See “Standard SMF Record Header” on page 13-1 for a detailed description.
5	5	SMF17RTY	1	binary	Record type 17 (X'11').
6	6	SMF17TME	4	binary	Time since midnight, in hundredths of a second, when the record was moved into the SMF buffer.
10	A	SMF17DTE	4	packed	Date when the record was moved into the SMF buffer, in the form 0cyydddF. See “Standard SMF Record Header” on page 13-1 for a detailed description.
14	E	SMF17SID	4	EBCDIC	System identification (from the SID parameter).
18	12	SMF17JBN	8	EBCDIC	Job name. The job name, time, and date that the reader recognized the JOB card (for this job) constitute the job log identification, or transaction name (for APPC output).
26	1A	SMF17RST	4	binary	Time since midnight, in hundredths of a second, that the reader recognized the JOB card (for this job).
30	1E	SMF17RSD	4	packed	Date when the reader recognized the JOB card (for this job), in the form 0cyydddF. See “Standard SMF Record Header” on page 13-1 for a detailed description.
34	22	SMF17UID	8	EBCDIC	User-defined identification field (taken from common exit parameter area, not from USER=parameter on job statement).
42	2A	SMF17RIN	2	--	Reserved.
44	2C	SMF17DSN	44	EBCDIC	Data set name.
88	58	SMF17RV1	3	--	Reserved.
91	5B	SMF17NVL	1	binary	Number of volumes.
Volume Information Section For each volume there is this eight-byte entry.
0	0	SMF17RV2	2	--	Reserved.
2	2	SMF17FVL	6	EBCDIC	Volume serial number.

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.

Example -- Sample Report from SMF 15 and 17 Records
showing 'Opens for Update' and 'Deletes' for Selected DSNAME

The sample SMF report below was created with Spectrum SMF Writer, the low-cost 4GL SMF report writer. This is a simple example of producing a report from multiple SMF record types. It reads as input the SMF file and selects both the type 15 (DD opened for output or update) and type 17 (dataset deleted) SMF records. (See SMF 15 or SMF 17 record layout.)

This report selects only records with a specific text ("SPFTEMP") somewhere withing the DSNAME. (And note that the DSNAME field is not in the same location in type 15 and type 17 SMF records.)

It then prints a report line for each type 15 or 17 record that refers to "SPFTEMP" dataset. Each report line shows data from either the SMF 15 record or the SMF 17 record. The report is then sorted and grouped by job. (However, in this example only 1 job happened to pass the selection criteria.)

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: SMF15     /* GET TYPE 15 DEFINITIONS */
COPY:  REC17     /* GET TYPE 17 DEFINITIONS, TOO */
*
***************************************************************
* MOVE DATA FROM DIFF LOCATIONS TO WORK FIELDS                *
***************************************************************
COMPUTE: JOBID   = WHEN(SMF15RTY=15) ASSIGN(SMF15-JOBID)
                   ELSE              ASSIGN(SMF17-JOBID)
*
COMPUTE: LOGTIME = WHEN(SMF15RTY=15) ASSIGN(SMF15TME)
                   ELSE              ASSIGN(SMF17TME)
*
COMPUTE: DSN     = WHEN(SMF15RTY=15) ASSIGN(SMF15-JFCBDSNM)
                   ELSE              ASSIGN(SMF17DSN)
*
COMPUTE: MGMT    = WHEN(SMF15RTY=15) ASSIGN(SMF15MCN)
                   ELSE              ASSIGN(' ')
*
COMPUTE: DISP    = WHEN(SMF15RTY=15) ASSIGN(SMF15-DISP)
                   ELSE              ASSIGN('DELETE')
*
***************************************************************
* SELECT TYPE 15 AND TYPE 17 RECS FOR SELECTED DSNS           *
***************************************************************
INCLUDEIF: (SMF15RTY = 15 OR 17)  /* SELECT BOTH 15 AND 17*/
           AND DSN : 'SPFTEMP'    /* ":" MEANS SCAN FOR TEXT */
*
***************************************************************
* OUTPUT REPORT LINES FROM OUR COMPUTED VALUES.               *
***************************************************************
COLUMNS: JOBID('JOB NAME AND READER TIME')
         LOGTIME
         SMF15RTY(4 'SMF|TYPE' NOACC)
         DSN(30 'DATASET NAME')
         MGMT('MANAGEMENT|CLASS')
         DISP
*
SORT:  JOBID SMF15DTE SMF15TME /* SORT ON JOB, THEN DATE & TIME */
BREAK: JOBID SPACE(1) NOTOTALS /* PRT 1 BLANK LINE WHEN JOB CHGS */
*
TITLE: #DATE / 'SMF OPENS FOR UPDATE, AND DELETES' / 'PAGE' #PAGENUM
TITLE:       / 'ON DATASETS CONTAINING "SPFTEMP"' /

Produce This SMF Report:

 
03/19/09                       SMF OPENS FOR UPDATE, AND DELETES                      PAGE    1
                                ON DATASETS CONTAINING "SPFTEMP"
                                           SMF                                 MANAGEMENT
   JOB NAME AND READER TIME      LOGTIME   TYPE          DATASET NAME            CLASS     DISP
 _____________________________ ___________ ____ ______________________________ __________ ______

 W0TTRP1  08/02/07 10:55:36.66 12:23:48.47   15 W0TTRP1.SPFTEMP2.CNTL           TSO       OLD
 W0TTRP1  08/02/07 10:55:36.66 12:23:57.47   15 W0TTRP1.SPFTEMP1.CNTL           TSO       OLD
 W0TTRP1  08/02/07 10:55:36.66 12:23:57.65   17 W0TTRP1.SPFTEMP1.CNTL                     DELETE


 ****** GRAND TOTAL (     3 ITEMS)

See other sample SMF reports.