DVIPA target added record (subtype 34)

The dynamic virtual IP address (DVIPA) target added record is created by a sysplex distributor stack when it determines that a designated target stack is active. A separate record is created for each DVIPA and port.

Creation of this SMF record is controlled by the following:

DVIPA and NODVIPA parameters on the SMFCONFIG profile statement
If DVIPA is specified, the record is created and written to the SMF MVS™ data sets.
DVIPA and NODVIPA options of the SMFSERVICE parameter on the NETMONITOR profile statement
If DVIPA is specified, the record is created and written to the real-time TCP/IP network monitoring NMI. For more information about this NMI, see Real-time TCP/IP network monitoring NMI.

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

Table 1 shows the DVIPA target added record self-defining section:

Table 1. DVIPA target added record self-defining section
Offset	Name	Length	Format	Description
0(X'0')	Standard SMF Header	24		Standard SMF header; subtype is 34(X'22')
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 DVIPA target added section
40(X'28')	SMF119S1Len	2	Binary	Length of DVIPA target added section
42(X'2A')	SMF119S1Num	2	Binary	Number of DVIPA target added sections

Table 2 shows the DVIPA target added specific section of this SMF record:

Table 2. DVIPA target added section
Offset	Name	Length	Type	Description
0(X'0')	SMF119DV_TAIPAddr4	4	Binary	If SMF119DV_TAFlags_IPv6 is not set, this field contains the IPv4 DVIPA address.
0(X'0')	SMF119DV_TAIPAddr6	16	Binary	If SMF119DV_TAFlags_IPv6 is set, this field contains the IPv6 DVIPA address.
16(X'10')	SMF119DV_TADxcfAddr4	4	Binary	If SMF119DV_TAFlags_IPv6 is not set, this field contains the IPv4 dynamic XCF address of the target stack that was added.
16(X'10')	SMF119DV_TADxcfAddr6	16	Binary	If SMF119DV_TAFlags_IPv6 is set, this field contains the IPv6 dynamic XCF address of the target stack that was added.
32(X'20')	SMF119DV_TAFlags	1	Binary	Various flags: X'80', SMF119DV_TAFlags_IPv6: If set, DVIPA address and dynamic XCF address are IPv6. X'40', SMF119DV_TAFlags_DestIPAll: If set, DESTIP ALL was specified on the VIPADISTRIBUTE DEFINE statement. X'20', SMF119DV_TAFlags_DynPorts: If set, dynamic ports were specified for this VIPADISTRIBUTE DEFINE statement.
33(X'21')		1	Binary	Reserved
34(X'22')	SMF119DV_TAPort	2	Binary	The DVIPA distributed port number. If dynamic ports are in use for this target, this port number is 0.
36(X'24')		12	Binary	Reserved