The dynamic virtual IP address (DVIPA) target server started
record is created by a sysplex distributor stack when it receives
notification from a target stack that a server has opened a listening
socket on a distributed port, or that a server has been resumed using
the V TCPIP,,SYSPLEX,RESUME command.
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 server started 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 server started record self-defining section:
Table 1. DVIPA target server
started record self-defining section| Offset |
Name |
Length |
Format |
Description |
|---|
| 0(X'0') |
Standard SMF Header |
24 |
|
Standard SMF header; subtype is 36(X'24') |
| 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 server started
section |
| 40(X'28') |
SMF119S1Len |
2 |
Binary |
Length of DVIPA target server started
section |
| 42(X'2A') |
SMF119S1Num |
2 |
Binary |
Number of DVIPA target server started
sections |
Table 2 shows the DVIPA
target server started specific section of this SMF record:
Table 2. DVIPA target server
started section| Offset |
Name |
Length |
Type |
Description |
|---|
| 0(X'0') |
SMF119DV_TSSIPAddr4 |
4 |
Binary |
If SMF119DV_TSSFlags_IPv6 is not
set, this field contains the IPv4 DVIPA address. |
| 0(X'0') |
SMF119DV_TSSIPAddr6 |
16 |
Binary |
If SMF119DV_TSSFlags_IPv6 is set,
this field contains the IPv6 DVIPA address. |
| 16(X'10') |
SMF119DV_TSSDxcfAddr4 |
4 |
Binary |
If SMF119DV_TSSFlags_IPv6 is not
set, this field contains the IPv4 destination XCF address of the target
stack on which the target server was added. |
| 16(X'10') |
SMF119DV_TSSDxcfAddr6 |
16 |
Binary |
If SMF119DV_TSSFlags_IPv6 is set,
this field contains the IPv6 destination XCF address of the target
stack on which the target server was added. |
| 32(X'20') |
SMF119DV_TSSFlags |
1 |
Binary |
Various flags: - X'80', SMF119DV_TSSFlags_IPv6: If set, DVIPA address and destination
XCF address are IPv6.
|
| 33(X'21') |
|
1 |
Binary |
Reserved |
| 34(X'22') |
SMF119DV_TSSPort |
2 |
Binary |
The DVIPA distributed port number. |
| 36(X'24') |
SMF119DV_TSSReadyCount |
4 |
Binary |
The number of servers on the indicated
target stack that are ready to service connection requests for the
indicated port. |
| 40(X'28') |
|
8 |
Binary |
Reserved |
z/OS Communications Server: IP Programmer's Guide and Reference
Copyright IBM Corporation 1990, 2014