TCP/IP profile record distributed dynamic VIPA (DVIPA) section

This section provides information about distributed TCP connection processing for dynamic VIPA (DVIPA) interfaces. This information is configured on the VIPADYNAMIC VIPADISTRIBUTE profile statement. There can be multiple sections in the record. Each section represents one distributed dynamic VIPA, per one distributed port, per one destination to a target TCP/IP stack or non-z/OS® target.

If requested configuration changes for this section were cancelled, then the following occurs:

Only one section is provided in the record.
Flag NMTP_DDVSChgCancelled is set. If this flag is set, no other information is provided in the section.

Table 1 shows the Distributed dynamic VIPA section.

Table 1. TCP/IP profile record Distributed dynamic VIPA (DVIPA) section
Offset	Name	Length	Format	Description
0(X'0')	NMTP_DDVSEye	4	EBCDIC	DDVS eyecatcher
4(X'4')	NMTP_DDVSFlags	2	Binary	Distributed DVIPA flags: X'8000', NMTP_DDVSChgCancelled: If set, pending configuration changes for this section were cancelled because the stack is not currently joined to the sysplex group. If this flag is set, no other information is provided in this section. X'4000', NMTP_DDVSIPv6: If set, this is an IPv6 entry; otherwise, it is an IPv4 entry. X'2000', NMTP_DDVSPort: If set, the PORT parameter was specified and field NMTP_DDVSDistPortNum contains the distributed port number. X'1000', NMTP_DDVSDestipAll: If set, connections to the DVIPA address can be distributed to all stacks connected to this stack by way of a dynamic XCF interface of the same protocol type (IPv4 or IPv6) as the DVIPA address. If flag NMTP_DDVSTier2 is set, connections can be distributed only to targets on the same CPC as the Tier2 distributor. X'0800', NMTP_DDVSOptLocal: If set, target stacks should normally process new connection requests locally instead of sending them to the sysplex distributor stack, depending on the OPTLOCAL value in field NMTP_DDVSOptLocalValue. X'0400', NMTP_DDVSSysplexPorts: If set, coordinated sysplex-wide ephemeral port assignment is activated for the distributed DVIPA on all stacks where the DVIPA is defined.
4(X'4') (Cont)				X'0200', NMTP_DDVSTier1: If this parameter is set, and the NMTP_DDVSTier1Gre flag is set, incoming connection requests to the distributed DVIPA are distributed to non-z/OS targets. If this parameter is set, and the NMTP_DDVSTier1Gre flag is not set, incoming connection requests to the distributed DVIPA are distributed to z/OS targets. If NMTP_DDVSIPv6 is not set, the NMTP_DDVSDestipAddr4 field contains the IPv4 target IP address. If NMTP_DDVSIPv6 is set, the NMTP_DDVSDestipAddr6 fields contain the IPv6 target IP address. The NMTP_DDVSTierGroupName field contains the TIER1 group name. If the NMTP_DDVSTier1Gre flag is set, the NMTP_DDVSControlPortNum field contains the control port number. X'0100', NMTP_DDVSTier1Gre: If set and NMTP_DDVSIPv6 is not set, generic routing encapsulation (GRE) is used to distribute requests to IPv4 tier 1 non-z/OS targets. If set and NMTP_DDVSIPv6 is set, IPv6 routing encapsulation is used to distribute requests to IPv6 tier 1 non-z/OS targets. This flag can be set only if flag NMTP_DDVSTier1 is set. X'0080', NMTP_DDVSTier2: If set, the DVIPA is used to distribute incoming requests from tier 1 targets to server applications. The NMTP_DDVSTierGroupName field contains the TIER2 group name. X'0040', NMTP_DDVSDeactivated: If set, the associated distributed DVIPA is currently deactivated. DVIPA distribution can be deactivated by using the VARY TCPIP,,SYSPLEX,DEACTIVATE command to deactivate the corresponding DVIPA address. X'0020', NMTP_DDVSSrvTypePreferred: When the value of NMTP_DDVSDistMethod is HotStandby, this flag is set if the server type is Preferred: 1 This is the preferred server. 0 This is not the preferred server.
4(X'4') (Cont)				X'0010', NMTP_DDVSSrvTypeBackup: When the value of NMTP_DDVSDistMethod is HotStandby, this flag is set if the server type is Backup: 1 This is a backup server. 0 This is not a backup server. X'0008', NMTP_DDVSAutoSwitchBack: When the value of NMTP_DDVSDistMethod is HotStandby, this flag is the AUTOSWITCHBACK setting: 1 AUTOSWITCHBACK is configured. 0 NOAUTOSWITCHBACK is configured X'0004', NMTP_DDVSHealthSwitch: When the value of NMTP_DDVSDistMethod is HotStandby, this flag is the HEALTHSWITCH setting: 1 HEALTHSWITCH is configured. 0 NOHEALTHSWITCH is configured.
6(X'6')	NMTP_DDVSDistMethod	1	Binary	One of the following distribution methods: NMTP_DDVSBaseWlm(1) BaseWlm NMTP_DDVSRoundRobin(2) RoundRobin NMTP_DDVSServerWlm(3) ServerWlm NMTP_DDVSWeightedActive(4) WeightedActive NMTP_DDVSTargetControlled(5) TargetControlled NMTP_DDVSHotStandby(6) HotStandby
7(X'7')	NMTP_DDVSBWProcTypeCp	1	Binary	When the value of NMTP_DDVSDistMethod is BaseWlm, this field contains the proportion of the workload that is expected to use conventional processors.
8(X'8')	NMTP_DDVSBWProcTypeZaap	1	Binary	When the value of NMTP_DDVSDistMethod is BaseWlm, this field contains the proportion of the workload that is expected to use zAAP processors.
9(X'9')	NMTP_DDVSBWProcTypeZiip	1	Binary	When the value of NMTP_DDVSDistMethod is BaseWlm, this field contains the proportion of the workload that is expected to use zIIP processors.
10(X'A')	NMTP_DDVSSWProcXcostZaap	1	Binary	When the value of NMTP_DDVSDistMethod is ServerWlm, this field contains the crossover cost of running the targeted zAAP workload on a conventional processor instead of the zAAP processor.
11(X'B')	NMTP_DDVSSWProcXcostZiip	1	Binary	When the value of NMTP_DDVSDistMethod is ServerWlm, this field contains the crossover cost of running the targeted zIIP workload on a conventional processor instead of the zIIP processor.
12(X'C')	NMTP_DDVSSWIlWeighting	1	Binary	When the value of NMTP_DDVSDistMethod is ServerWlm, this field contains the weighting factor WLM uses when comparing displaceable capacity at different importance levels (IL's) as it determines a SERVERWLM recommendation for each system.
13(X'D')	NMTP_DDVSWADestipWeight	1	Binary	When the value of NMTP_DDVSDistMethod is WeightedActive, this field contains the weight used by the distributor to determine the proportion of active connections on this target.
14(X'E')	NMTP_DDVSOptLocalValue	1	Binary	If flag NMTP_DDVSOptLocal is set, this field contains the OPTLOCAL value.
15(X'F')	NMTP_DDVSBackupRank	1	Binary	When the flag NMTP_DDVSSrvTypeBackup is set, this field contains the rank of the backup server.
16(X'10')		2	Binary	Reserved
18(X'12')	NMTP_DDVSTimedAffinity	2	Binary	The number of seconds during which connection requests from a client are routed to the same target server. This value is valid only if the NMTP_DDVSOptlocal flag is not set.
20(X'14')	NMTP_DDVSControlPortNum	2	Binary	If flag NMTP_DDVSTier1 is set, this field contains the destination port number to be used when establishing a control connection to the Tier1 target.
22(X'16')	NMTP_DDVSDistPortNum	2	Binary	If flag NMTP_DDVSPort is set, this field contains the port number for one of the distributed ports.
24(X'18')	NMTP_DDVSTierGroupName	16	EBCDIC	If either flag NMTP_DDVSTier1 or flag NMTP_DDVSTier2 is set, this field contains the group name.
40(X'28')	NMTP_DDVSDistAddr	4	Binary	One of the following values: If the NMTP_DDVSIPv6 flag is not set, this field contains the IPv4 distributed DVIPA IP address. If the NMTP_DDVSIPv6 flag is set, this field contains the IPv6 distributed DVIPA interface name.
40(X'28')	NMTP_DDVSDistIntfName	16	EBCDIC	One of the following values: If the NMTP_DDVSIPv6 flag is not set, this field contains the IPv4 distributed DVIPA IP address. If the NMTP_DDVSIPv6 flag is set, this field contains the IPv6 distributed DVIPA interface name.
56(X'38')	NMTP_DDVSDestipAddr4	4	Binary	If the flag NMTP_DDVSDestipAll is not set, this field contains one of the destinations to which connections requests are sent. If the NMTP_DDVSIPv6 flag is set, this field contains an IPv6 IP address, otherwise it contains an IPv4 IP address. The address is one of the following values: If the NMTP_DDVSTier1Gre flag is not set, a dynamic XCF IP address to a target stack. If the NMTP_DDVSTier1GRE flag is set, a non- z/OS target's IP address.
56(X'38')	NMTP_DDVSDestipAddr6	16	Binary	If the flag NMTP_DDVSDestipAll is not set, this field contains one of the destinations to which connections requests are sent. If the NMTP_DDVSIPv6 flag is set, this field contains an IPv6 IP address, otherwise it contains an IPv4 IP address. The address is one of the following values: If the NMTP_DDVSTier1Gre flag is not set, a dynamic XCF IP address to a target stack. If the NMTP_DDVSTier1GRE flag is set, a non- z/OS target's IP address.