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.
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:
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:
|
17(X'11') | SMF119DV_SCOrigin | 1 | Binary | The origin of this DVIPA and how
it was configured to the stack:
|
18(X'12') | SMF119DV_SCStatus | 1 | Binary | The status of this DVIPA on the stack:
|
19(X'13') | SMF119DV_SCOptions | 1 | Binary | Flags indicating DVIPA options specified:
|
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 |