DVIPA removed record (subtype 33)

The dynamic virtual IP address (DVIPA) removed record is created when a DVIPA is removed from a TCP/IP stack. 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 removed 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 removed record self-defining section:
Table 1. DVIPA removed record self-defining section
Offset Name Length Format Description
0(X'0') Standard SMF Header 24   Standard SMF header; subtype is 33(X'21')
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 removed section
40(X'28') SMF119S1Len 2 Binary Length of DVIPA removed section
42(X'2A') SMF119S1Num 2 Binary Number of DVIPA removed sections

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

Table 2. DVIPA removed section
Offset Name Length Type Description
0(X'0') SMF119DV_RmIPAddr4 4 Binary If SMF119DV_RmFlags_IPv6 is not set, this field contains the IPv4 DVIPA address.
0(X'0') SMF119DV_RmIPAddr6 16 Binary If SMF119DV_RmFlags_IPv6 is set, this field contains the IPv6 DVIPA address.
16(X'10') SMF119DV_RmFlags 1 Binary Various flags:
  • X'80', SMF119DV_RmFlags_IPv6: If set, this record describes an IPv6 DVIPA address.
17(X'11') SMF119DV_RmOrigin 1 Binary The origin of this DVIPA and how it was configured to the stack:
  • X'01', SMF119DV_Orig_Unknown

    A value of X'01' should not occur and represents an error.

  • X'02', SMF119DV_Orig_Backup
  • X'03', SMF119DV_Orig_Define
  • X'04', SMF119DV_Orig_RangeBIND
  • X'05', SMF119DV_Orig_RangeIOCTL
  • X'06', SMF119DV_Orig_DistTarget
18(X'12') SMF119DV_RmStatus 1 Binary The status of this DVIPA on the stack before it was removed:
  • X'01', SMF119DV_Stat_Unknown

    A value of X'01' should not occur and represents an error.

  • X'02', SMF119DV_Stat_Active
  • X'03', SMF119DV_Stat_Backup
  • X'04', SMF119DV_Stat_Moving
  • X'05', SMF119DV_Stat_Quiescing
  • X'06', SMF119DV_Stat_Deact
  • X'07', SMF119DV_Stat_DeactLG
  • X'08', SMF119DV_Stat_DeactAuto
  • X'09', SMF119DV_Stat_InactLG
  • X'0A', SMF119DV_Stat_InactAuto
19(X'13') SMF119DV_RmOptions 1 Binary Flags indicating DVIPA options specified:
  • X'80', SMF119DV_Opt_MoveImmed
  • X'40', SMF119DV_Opt_MoveIdle
  • X'20', SMF119DV_Opt_MoveNonDis
  • X'10', SMF119DV_Opt_MoveDisrupt
20(X'14') SMF119DV_RmRank 2 Binary The rank of this stack in the chain of backup stacks for this DVIPA. For entries where the SMF119DV_RmOrigin value is not SMF119DV_Orig_Backup or SMF119DV_Orig_Define, this field does not apply and is set to X'FFFF'.
22(X'16')   10 Binary Reserved