DVIPA status change record (subtype 32)

The dynamic virtual IP address (DVIPA) status change record is created when a DVIPA is defined and when the status of a DVIPA changes on a TCP/IP stack. This record is not created when the TCP/IP stack leaves the sysplex group and a DVIPA becomes inactive. 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 status change 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 status change record self-defining section:
Table 1. DVIPA status change record self-defining section
Offset Name Length Format Description
0(X'0') Standard SMF Header 24   Standard SMF header; subtype is 32(X'20')
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 status change section
40(X'28') SMF119S1Len 2 Binary Length of DVIPA status change section
42(X'2A') SMF119S1Num 2 Binary Number of DVIPA status change sections

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

Table 2. DVIPA status change section
Offset Name Length Type Description
0(X'0') SMF119DV_SCIPAddr4 4 Binary If SMF119DV_SCFlags_IPv6 is not set, this field contains the IPv4 DVIPA address.
0(X'0') SMF119DV_SCIPAddr6 16 Binary If SMF119DV_SCFlags_IPv6 is set, this field contains the IPv6 DVIPA address.
16(X'10') SMF119DV_SCFlags 1 Binary Various flags:
  • X'80', SMF119DV_SCFlags_IPv6: If set, this record describes an IPv6 DVIPA address.
17(X'11') SMF119DV_SCOrigin 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_SCStatus 1 Binary The status of this DVIPA on the stack:
  • 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_SCOptions 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
This field does not apply to DVIPAs whose SMF119DV_SCOrigin field is set to SMF119DV_Orig_DistTarget.
20(X'14') SMF119DV_SCRank 2 Binary The rank of this stack in the chain of backup stacks for this DVIPA. For entries where the SMF119DV_SCOrigin value is not SMF119DV_Orig_Backup or SMF119DV_Orig_Define, this field does not apply and is set to X'FFFF'.
22(X'16')   2 Binary Reserved
24(X'18') SMF119DV_SCActTime 4 Binary DVIPA activation time, or the time when this DVIPA was activated on the local stack, either because the stack is the owner of the DVIPA or because the stack is a target for this DVIPA.
28(X'1C') SMF119DV_SCActDate 4 Packed DVIPA activation date