TCP connection initiation record (subtype 1)

The TCP connection initiation record is collected whenever a TCP connection is opened. This record contains pertinent information about the connection available at the time of its opening.

Guidelines:

Because this information is duplicated in the TCP connection termination record, which contains additional information, you must collect only the TCP connection termination record.
Because this record is generated for every single TCP connection, significant load can be generated on a server and rapidly fill the SMF data sets. The TCP connection termination record is collected whenever a TCP connection is closed or terminated. This record contains all pertinent information about the connection, such as elapsed time, bytes transferred, and so on.

See Table 1 for the contents of the TCP/IP stack identification section. For the TCP/IP connection initiation record, the TCP/IP stack identification section indicates TCP as the subcomponent and X'08' (event record) as the record reason.

Table 1 shows the TCP connection initiation record self-defining section:

Table 1. TCP connection initiation record self-defining section
Offset	Name	Length	Format	Description
0(X'0')	Standard SMF header	24		Standard SMF header
Self-defining section
24(X'18')	SMF119SD_TRN	2	Binary	Number of triplets in this record (2).
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 TCP connection initiation section
40(X'28')	SMF119S1Len	2	Binary	Length of TCP connection initiation section
42(X'2A')	SMF119S1Num	2	Binary	Number of TCP connection initiation sections

Table 2 shows the TCP connection initiation specific section of this SMF record.

Table 2. TCP connection initiation specific section
Offset	Name	Length	Format	Description
0(X'0')	SMF119AP_TIRName	8	EBCDIC	TCP socket resource name (Address space name of address space that established this TCP connection)
8(X'8')	SMF119AP_TIConnID	4	Binary	TCP socket resource ID (connection ID)
12(X'C')	SMF119AP_TIRsv1	4	Binary	Reserved
16(X'10')	SMF119AP_TISubTask	4	Binary	Subtask Name (Address of MVS™ TCB for the task that owns this connection. Note that this is not the subtask value specified on an INITAPI call.)
20(X'14')	SMF119AP_TIRIP	16	Binary	Remote IP address at time of connection open
36(X'24')	SMF119AP_TILIP	16	Binary	Local IP address at time of connection open
52(X'34')	SMF119AP_TIRPort	2	Binary	Remote port number at time of connection open
54(X'36')	SMF119AP_TILPort	2	Binary	Local port number at time of connection open
56(X'38')	SMF119AP_TITime	4	Binary	Time of day of connection establishment
60(X'3C')	SMF119AP_TIDate	4	Packed	Date of connection establishment
64(X'40')	SMF119AP_TISTCK	8	Binary	STCK of connection establishment