Interface statistics record (subtype 6)

The Interface statistics record is collected at user specified intervals. The record provides statistical data about the interfaces of a stack, one interface specific section per interface. This SMF record does not provide data for VIPA, loopback, OSAENTA, or 10GbE RoCE Express® interfaces. It does not provide data for any interface in the process of being deleted from the stack at the time of interval reporting. For 10GbE RoCE Express interface statistics, see RDMA network interface card (RNIC) interface statistics record (subtype 44).

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.

See Table 1 for the contents of the TCP/IP stack 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.

Table 1 shows the interface statistics record self-defining section:

Table 1. Interface statistics record self-defining section
Offset	Name	Length	Format	Description
0(X'0')	Standard SMF Header	24		Standard SMF header; subtype is 6(X'6')
Self-defining section
24(X'18')	SMF119SD_TRN	2	Binary	Number of triplets in this record (3)
26(X'1A')		2	Binary	Reserved
28(X'1C')	SMF119IDOff	4	Binary	Offset to TCP/IP identification section
32(X'20')	SMF119IDLen	2	Binary	Length of TCP/IP identification section
34(X'22')	SMF119IDNum	2	Binary	Number of TCP/IP identification sections
36(X'24')	SMF119S1Off	4	Binary	Offset to first interface section
40(X'28')	SMF119S1Len	2	Binary	Length of each interface section
42(X'2A')	SMF119S1Num	2	Binary	Number of interface sections
44 (X'2C')	SMF119S2Off	4	Binary	Offset to first IPv6 additional HOME IP address section
48 (X'30')	SMF119S2Len	4	Binary	Length of each IPv6 additional HOME IP address section
50 (X'32')	SMF119S2Num	2	Binary	Number of IPv6 additional HOME IP address sections

Table 2 shows the interface statistics specific record (one per LINK or INTERFACE definition):

Table 2. Interface statistics section
Offset	Name	Length	Format	Description
0(X'0')	SMF119IS_IFDuration	8	Binary	Duration of recording interval in microseconds, where bit 51 is equivalent to one microsecond
8(X'8')	SMF119IS_IFLnkHome	16	Binary	Interface HOME address. For IPv6 interfaces, additional addresses might be specified in subsequent HOME IP address sections.
24(X'18')	SMF119IS_IFName	16	EBCDIC	Link or interface name
40(X'28')	SMF119IS_IFDevName	16	EBCDIC	Device name
56(X'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 MPCPTP6 IPAQIQDX IPAQIQDX6 RNIC
74(X'4A')	SMF119IS_IFFlags	1	Binary	Flags X'80': SMCR is configured. X'40': PNetID is provided.
75(X'4B')		1	Binary	Reserved
76(X'4C')	SMF119IS_IFActualMtu	4	Binary	MTU size
80(X'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(X'54')	SMF119IS_IFHSpeed	4	Binary	HSpeed
88(X'58')	SMF119IS_IFInBytes	8	Binary	Number of inbound bytes
96(X'60')	SMF119IS_IFInUniC	8	Binary	Number of inbound unicast packets
104(X'68')	SMF119IS_IFInBroadC	8	Binary	Number of inbound broadcast packets
112(X'70')	SMF119IS_IFInMultiC	8	Binary	Number of inbound multicast packets
120(X'78')	SMF119IS_IFInDisc	4	Binary	Number of inbound discarded packets
124(X'7C')	SMF119IS_IFInError	4	Binary	Number of inbound packets in error
128(X'80')	SMF119IS_IFInUProt	4	Binary	Number of inbound packets with unknown protocol.
132(X'84')	SMF119IS_IFOutBytes	8	Binary	Number of outbound bytes
140(X'8C')	SMF119IS_IFOutUniC	8	Binary	Number of outbound unicast packets
148(X'94')	SMF119IS_IFOutBroadC	8	Binary	Number of outbound broadcast packets
156(X'9C')	SMF119IS_IFOutMultiC	8	Binary	Number of outbound multicast packets
164(X'A4')	SMF119IS_IFOutDisc	4	Binary	Number of outbound discarded packets
168(X'A8')	SMF119IS_IFOutError	4	Binary	Number of outbound packets in error
172(X'AC')	SMF119IS_IFOQL	4	Binary	Current output queue length
176(X'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(X'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(X'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(X'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(X'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(X'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).

Table 3 shows the HOME IP Address section:

Table 3. HOME IP Address section
Offset	Name	Length	Format	Description
0 (X'0')	SMF119IS_IFAddIntfName	16	EBCDIC	Interface name, used to correlate this additional address to the interface statistics record in Table 2
16 (X'10')	SMF119IS_IFAddIntfHome	16	Binary	Additional interface HOME address