z/OS Communications Server: IP Programmer's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


DVIPA target server ended record (subtype 37)

z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02

The dynamic virtual IP address (DVIPA) target server ended record is created by a sysplex distributor stack when it receives notification from a target stack that a server has closed a listening socket on a distributed port, or that a server has been quiesced using the V TCPIP,,SYSPLEX,QUIESCE 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 ended 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 ended record self-defining section:

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

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

Table 2. DVIPA target server ended section
Offset Name Length Type Description
0(X'0') SMF119DV_TSEIPAddr4 4 Binary If SMF119DV_TSEFlags_IPv6 is not set, this field contains the IPv4 DVIPA address.
0(X'0') SMF119DV_TSEIPAddr6 16 Binary If SMF119DV_TSEFlags_IPv6 is set, this field contains the IPv6 DVIPA address.
16(X'10') SMF119DV_TSEDxcfAddr4 4 Binary If SMF119DV_TSEFlags_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_TSEDxcfAddr6 16 Binary If SMF119DV_TSEFlags_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_TSEFlags 1 Binary Various flags:
  • X'80', SMF119DV_TSEFlags_IPv6: If set, DVIPA address and destination XCF address are IPv6.
33(X'21')   1 Binary Reserved
34(X'22') SMF119DV_TSEPort 2 Binary The DVIPA distributed port number.
36(X'24') SMF119DV_TSEReadyCount 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

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014