








	*SMF Tools*

SMF Type 119 Record - Subtype 6

This table shows the record layout for type 119 SMF records
(TCP/IP Statistics - Interface Statistics Record).

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

Purpose: Transmission Control Protocol/Internet Protocol (TCP/IP) writes type 119 records to collect statistics about Telnet servers and clients, FTP servers and clients, and API activity and stack usage information.

The Subtype 6 Interface statistics record is collected at user specified intervals. The record provides data about user-defined interfaces (LINK or INTERFACE statements), one interface specific section per defined interface. Only non-VIPA and non-loopback interfaces are included in the SMF record, and any interface in the process of being deleted from the stack at the time of interval reporting is likewise ignored. Each interface specific section reports statistical data about the interface for the previous recording interval. To determine a cumulative value for a given statistic reported, the user must sum the values reported for the statistic in the individual Interface statistics interval records. If interface statistics recording is turned off dynamically, or the TCP stack terminates, a final interface statistics record is generated to report close-out data. If a given LINK or INTERFACE statement is deleted during a recording interval, any data related to that interface during the recording interval is lost (for example, is not reported in the next interval record). Depending on the number of interfaces, this report can be spread across multiple records, in which case the self-defining section for each record specifies the content layout of that particular record. There is no Type 118 record equivalent to the link interface statistics record.

It's easy to report on SMF 119 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 119 Record -- TCP/IP Statistics - Interface Statistics Record
Offset (Dec.)	Offset (Hex)	Name	Length	Format	Description
0	0	SMF119LEN	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	SMF119SEG	2	binary	Segment descriptor (see record length field).
4	4	SMF119FLG	1	binary	System indicator Bit Meaning When Set 0 New record format 1 Subtypes used 2 Reserved. 3-6 Version indicators* 7 System is running in PR/SM mode.*See “Standard SMF Record Header” on page 13-1 for a detailed description.
5	5	SMF119RTY	1	binary	Record type 119 (X'77').
6	6	SMF119TME	4	binary	Time since midnight, in hundredths of a second, that the record was moved into the SMF buffer.
10	A	SMF119DTE	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	SMF119SID	4	EBCDIC	System identification (from the SMFPRMxx SID parameter).
18	12	SMF119SSI	4	EBCDIC	Subsystem identification.
22	16	SMF119STY	2	binary	Record subtype.
Self Defining Section
24	18	SMF119TRN	2	binary	Number of triplets in this record. A triplet is a set of three SMF fields (offset/length/number values) that defines a section of the record. The offset is the offset from the RDW.
26	1A	--	2	binary	Reserved.
28	1C	SMF119IDOff	4	binary	Offset to TCP/IP identification section from RDW.
32	20	SMF119IDLen	2	binary	Length of TCP/IP identification section.
34	22	SMF119IDNum	2	binary	Number of TCP/IP identification sections.
36	24	SMF119S1Off	4	Binary	Offset to first data section
40	28	SMF119S1Len	2	Binary	Length of first data section
42	2A	SMF119S1Num	2	Binary	Number of first data sections
44	2C	SMF119S2Off	4	Binary	Offset to 2nd data section
48	30	SMF119S2Len	2	Binary	Length of 2nd data section
50	32	SMF119S2Num	2	Binary	Number of 2nd data sections
TCP/IP Identification Section For the interface statistics record, the TCP/IP stack identification section indicates IP as the subcomponent and one of the six possible interval record reason settings, depending on if the reporting is due to interval expiration, statistics collection termination, or collection shutdown, and whether one or more physical records are needed to report all the interface statistics. (Offset from beginning of record: SMF119IDOff)
0	0	SMF119TI_ SYSName	8	EBCDIC	System name from SYSNAME in IEASYSxx
8	8	SMF119TI_ SysplexName	8	EBCDIC	Sysplex name from SYSPLEX in COUPLExx
16	10	SMF119TI_ Stack	8	EBCDIC	TCP/IP stack name
24	18	SMF119TI_ ReleaseID	8	EBCDIC	z/OS Communications Server TCP/IP release identifier
32	20	SMF119TI_ Comp	8	EBCDIC	TCP/IP subcomponent (right padded with blanks): FTPC FTP Client FTPS FTP server IP IP layer STACK Entire TCP/IP stack TCP TCP layer TN3270C TN3270 Client TN3270S TN3270 server UDP UDP layer
40	28	SMF119TI_ ASName	8	EBCDIC	Started task qualifier or address space name of address space that writes this SMF record
48	30	SMF119TI_ UserID	8	EBCDIC	User ID of security context under which this SMF record is written
56	38	--	2	EBCDIC	Reserved
58	3A	SMF119TI_ ASID	2	Binary	ASID of address space that writes this SMF record
60	3C	SMF119TI_ Reason	1	Binary	Reason for writing this SMF record: X'08' Event record X'C0' Interval statistics record, more records follow X'80' Interval statistics record, last record in set X'60' End-of-statistics record, more records follow X'20' End-of-statistics record, last record in set X'50' Shutdown starts record, more records follow X'10' Shutdown starts record, last record in set
61	3D	--	3	EBCDIC	Reserved
Subtype 6 - Interface statistics specific record (one per LINK or INTERFACE definition)(Offset from beginning of record: SMF119S1Off)
0	0	SMF119SP_ IFDuration	8	Binary	Duration of recording interval in microseconds, where bit 51 is equivalent to one microsecond
8	8	SMF119IS_ IFLnkHome	16	Binary	Interface HOME address. For IPv6 interfaces, additional addresses might be specified in subsequent HOME IP address sections.
24	18	SMF119IS_ IFName	16	EBCDIC	Link or interface name
40	28	SMF119IS_ IFDevName	16	EBCDIC	Device name
56	38	SMF119IS_ IFDesc	18	EBCDIC	Interface Description (TCPIP PROFILE keyword for LINK or INTERFACE type.) Possible values include: ATM, CDLC, CTC, ETHERnet, ETHEROR802.3, FDDI, HCH, IBMTR, IP, IPAQENET, IPAQIDIO, IPAQTR, MPCPTP, OSAENET, OSAFDDI, SAMEHOST, Unknown, 802.3, IPAQENET6, IPAQIDIO6, and MPCPTP6
74	4A	--	2	Binary	Reserved
76	4C	SMF119IS_ IFActualMtu	4	Binary	MTU size
80	50	SMF119IS_ IFSPeed	4	Binary	Speed Guideline: If the interface speed exceeds x'FFFFFFFF', then this field contains x'FFFFFFFF'. If this field contains x'FFFFFFFF', then use the SMF119IS_IFHSpeed field to determine the interface speed.
84	54	SMF119IS_ IFHSpeed	4	Binary	HSpeed
88	58	SMF119IS_ IFInBytes	8	Binary	Number of inbound bytes
96	60	SMF119IS_ IFInUniC	8	Binary	Number of inbound Unicast packets
104	68	SMF119IS_ IFInBroadC	8	Binary	Number of inbound broadcast packets
112	70	SMF119IS_ IFInMultiC	8	Binary	Number of inbound multicast packets
120	78	SMF119IS_ IFInDisc	4	Binary	Number of inbound discarded packets
124	7C	SMF119IS_ IFInError	4	Binary	Number of inbound packets in error
128	80	SMF119IS_ IFInUProt	4	Binary	Number of inbound packets with unknown protocol.
132	84	SMF119IS_ IFOutBytes	8	Binary	Number of outbound bytes
140	8C	SMF119IS_ IFOutUniC	8	Binary	Number of outbound Unicast packets
148	94	SMF119IS_ IFOutBroadC	8	Binary	Number of outbound broadcast packets
156	9C	SMF119IS_ IFOutMultiC	8	Binary	Number of outbound multicast packets
164	A4	SMF119IS_ IFOutDisc	4	Binary	Number of outbound discarded packets
168	A8	SMF119IS_ IFOutError	4	Binary	Number of outbound packets in error
172	AC	SMF119IS_ IFOQL	4	Binary	Current output queue length
176	B0	SMF119IS_ IFIQDXName	16	EBCDIC	For IPAQENET and IPAQENET6 interfaces that are defined with CHPIDTYPE OSX and with an associated IQDX interface, this field is the associated IQDX interface name. Otherwise, this field is blank and the following four counters are not valid.
192	C0	SMF119IS_ IFInIQDXBytes	8	Binary	Number of inbound bytes that were received over the associated IQDX interface. This field is valid only if the SMF119IS_IFIQDXName field is not blank.
200	C8	SMF119IS_ IFInIQDXUniC	8	Binary	Number of inbound unicast packets that were received over the associated IQDX interface. This field is valid only if the SMF119IS_IFIQDXName field is not blank.
208	D0	SMF119IS_ IFOutIQDXBytes	8	Binary	Number of outbound bytes that were sent over the associated IQDX interface. This field is valid only if the SMF119IS_IFIQDXName field is not blank.
216	D8	SMF119IS_ IFOutIQDXUniC	8	Binary	Number of outbound unicast packets that were sent over the associated IQDX interface. This field is valid only if the SMF119IS_IFIQDXName field is not blank.
224	E0	SMF119IS_ IFPNetID	16	EBCDIC	Physical network ID. This field is valid for only IPAQENET and IPAQENET6 interfaces that are active for Shared Memory Communications over RDMA (SMC-R).
Subtype 6 - HOME IP Address section:(Offset from beginning of record: SMF119S2Off)
0	0	SMF119IS_ IFAddIntfName	16	EBCDIC	Interface name, used to correlate this additional address to the interface statistics record in Table 169
16	10	SMF119IS_ IFAddIntfHome	16	Binary	Additional interface HOME address

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 Report from SMF 119 Subtype 2 Records
Showing Information about TCP Connections

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

In this report, we read as input the SMF file and select just the type 119 subtype 2 TCP Connection Termination records. (See SMF 119 Subtype 2 record layout.) The report shows information about terminated TCP connections, including start time, end time and computed elapsed time. It also shows the total number of bytes sent and received during the connection and the termination code. Our record layout also expands the 1-byte termination code into a readable descriptive text. The report is grouped by TCP/IP Stack and Resource. The report includes subtotals for each Resource.

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:  SMF119 LIST(YES)

INCLUDEIF: SMF119RTY=119 AND SMF119STY=2

COMPUTE: MY_DURATION(2) = #MAKETIME(
               ((#MAKENUM(SMF119AP_TTEDATE) * 86400)
                  + #MAKENUM(SMF119AP_TTETIME))
             - ((#MAKENUM(SMF119AP_TTSDATE) * 86400)
                  + #MAKENUM(SMF119AP_TTSTIME))
                                   )

TITLE: 'Z/OS TCP DAILY CONNECTIONS REPORT'
TITLE: 'SYSTEM:' SMF119TI_SYSNAME
       'SYSPLEX:' SMF119TI_SYSPLEXNAME
       'STACK:' SMF119TI_STACK
TITLE: 'SORTED BY STACK AND RESOURCE NAME'

COLUMNS: SMF119AP_TTRNAME('RESOURCE')
         SMF119AP_TTSDATE('DATE/STARTED')
         SMF119AP_TTSTIME('TIME/STARTED')
         SMF119AP_TTEDATE('DATE/ENDED')
         SMF119AP_TTETIME('TIME/ENDED')
         MY_DURATION('CONNECTION/DURATION/HH:MM:SS.SS' ACCUM
                     TP'ZZ:ZZ:Z9.99')
         SMF119AP_TTINBYTES('INBOUND/BYTES')
         SMF119AP_TTOUTBYTES('OUTBOUND/BYTES')
         SMF119AP_TTTERMCODE(HEX 'TERM/CODE')
         SMF119AP_TTTERMCODE_DESC('TERM CODE DESC')

SORT:    SMF119TI_STACK
         SMF119AP_TTRNAME
         SMF119AP_TTSDATE
         SMF119AP_TTSTIME

BREAK:   SMF119AP_TTRNAME

Produce This SMF Report:


                                              Z/OS TCP DAILY CONNECTIONS REPORT
                                    SYSTEM: ST1      SYSPLEX: SYPROD    STACK: S01QDAS
                                             SORTED BY STACK AND RESOURCE NAME

                                                    CONNECTION
            DATE      TIME       DATE      TIME      DURATION      INBOUND        OUTBOUND    TERM
 RESOURCE STARTED    STARTED    ENDED      ENDED    HH:MM:SS.SS     BYTES          BYTES      CODE     TERM CODE DESC
 ________ ________ ___________ ________ ___________ ___________ ______________ ______________ ____ _______________________

 FTPTA5   03/21/09 14:04:06.81 03/21/09 14:04:07.46        0.65        257,537          3,052  61  CLIENT SENT RESET
 FTPTA5   03/21/09 14:05:35.59 03/21/09 14:05:45.67       10.08         27,043            329  52  APPL ISSUED CLOSE
 FTPTA5   03/21/09 14:12:13.81 03/21/09 14:12:14.51        0.70        257,537          3,052  61  CLIENT SENT RESET
 FTPTA5   03/21/09 14:12:27.35 03/21/09 14:12:37.42       10.07         27,043            329  52  APPL ISSUED CLOSE
 FTPTA5   03/21/09 15:30:34.96 03/21/09 15:30:35.64        0.68        257,537          3,052  61  CLIENT SENT RESET
 FTPTA5   03/21/09 15:35:13.92 03/21/09 15:35:24.00       10.08         27,043            329  52  APPL ISSUED CLOSE
 *** TOTAL FOR FTPTA5   (    6 ITEMS)                     32.26        853,740         10,143
 
 FTPTA6   03/21/09 14:05:38.03 03/21/09 14:05:38.70        0.67        257,537          3,052  61  CLIENT SENT RESET
 FTPTA6   03/21/09 14:07:23.60 03/21/09 14:07:33.68       10.08         27,043            329  52  APPL ISSUED CLOSE
 FTPTA6   03/21/09 14:12:29.83 03/21/09 14:12:30.50        0.67        257,537          3,052  61  CLIENT SENT RESET
 FTPTA6   03/21/09 14:17:10.02 03/21/09 14:17:20.16       10.14         27,043            329  52  APPL ISSUED CLOSE
 FTPTA6   03/21/09 15:35:16.45 03/21/09 15:35:17.21        0.76        257,537          3,052  61  CLIENT SENT RESET
 FTPTA6   03/21/09 15:36:15.10 03/21/09 15:36:25.18       10.08         27,043            329  52  APPL ISSUED CLOSE
 *** TOTAL FOR FTPTA6   (    6 ITEMS)                     32.40        853,740         10,143
 
 FTPTA7   03/21/09 14:07:26.16 03/21/09 14:07:26.86        0.70        257,537          3,052  61  CLIENT SENT RESET
 FTPTA7   03/21/09 14:08:24.36 03/21/09 14:08:34.50       10.14             70            507  52  APPL ISSUED CLOSE
 FTPTA7   03/21/09 14:17:12.60 03/21/09 14:17:13.31        0.71        257,537          3,052  61  CLIENT SENT RESET
 FTPTA7   03/21/09 14:21:40.01 03/21/09 14:21:50.08       10.07         27,043            329  52  APPL ISSUED CLOSE
 FTPTA7   03/21/09 15:36:17.53 03/21/09 15:36:18.17        0.64        257,537          3,052  61  CLIENT SENT RESET
 FTPTA7   03/21/09 15:37:11.45 03/21/09 15:37:21.53       10.08         27,043            329  52  APPL ISSUED CLOSE
 *** TOTAL FOR FTPTA7   (    6 ITEMS)                     32.34        826,767         10,321
 
 FTPTA8   03/21/09 08:09:32.96 03/21/09 15:29:02.41  7:19:29.45        274,763         15,912  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 13:17:39.42 03/21/09 14:42:50.82  1:25:11.40         47,498          2,291  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 14:42:57.42 03/21/09 14:43:21.38       23.96         45,921          2,291  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 14:43:26.45 03/21/09 15:28:27.01    45:00.56         47,498          2,291  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 14:50:01.00 03/21/09 15:28:26.10    38:25.10         35,513          1,537  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 14:51:01.03 03/21/09 14:52:28.82     1:27.79         33,273            875  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 14:53:05.50 03/21/09 15:28:22.53    35:17.03         33,273            875  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 14:53:51.74 03/21/09 14:55:51.42     1:59.68         35,306          1,537  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 14:56:05.98 03/21/09 15:11:31.19    15:25.21         33,066            875  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 15:12:01.80 03/21/09 15:13:30.66     1:28.86         35,266          1,537  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 15:13:45.48 03/21/09 15:17:09.41     3:23.93         38,223          2,199  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 15:18:54.59 03/21/09 15:20:07.26     1:12.67         34,273          1,537  52  APPL ISSUED CLOSE
 FTPTA8   03/21/09 15:20:22.01 03/21/09 15:28:20.73     7:58.72         33,118            875  52  APPL ISSUED CLOSE
 *** TOTAL FOR FTPTA8   (   13 ITEMS)               11:16:44.36        726,991         34,632

 
 FTPTA9   03/21/09 14:09:28.52 03/21/09 14:09:29.22        0.70        257,537          3,052  61  CLIENT SENT RESET
 FTPTA9   03/21/09 14:10:24.02 03/21/09 14:10:34.10       10.08         27,043            329  52  APPL ISSUED CLOSE
 FTPTA9   03/21/09 15:01:06.82 03/21/09 15:01:07.46        0.64        257,537          3,052  61  CLIENT SENT RESET
 FTPTA9   03/21/09 15:13:52.13 03/21/09 15:14:02.53       10.40         27,043            329  52  APPL ISSUED CLOSE

 ...

See other sample SMF reports.