DVIPA Sysplex Distributors Attributes
Use these attributes to view information about the distributed dynamic virtual IP address (DVIPA) sysplex distributors.
Active Target Stacks The number of target TCP/IP stacks that are available to service connection requests.
Auto Switch Back An indication of whether the AUTOSWITCHBACK or NOAUTOSWITCHBACK option for the HOTSTANDBY distribution method is specified on the VIPADISTRIBUTE statement. The following values are valid:
- No (0): Specifies that the distributor does not switch back to the preferred target when it becomes available.
- Yes (1): Specifies that the distributor automatically switches distribution back to the preferred target when the preferred target becomes available.
Configured Target Stacks The number of configured target TCP/IP stacks. For distributors with DESTIP=ALL defined, this value does not apply and is set to N/A.
DESTIP ALL An indication of whether the DESTIP ALL parameter is specified on the VIPADISTRIBUTE statement. The following values are valid:
- 0: No
- 1: Yes
Distribution Method The method of distribution used for incoming connection requests. The following values are valid:
- baseWlm (1): Workload Manager (WLM) and policy information are used to determine the distribution.
- roundRobin (2): WLM and policy information are ignored and requests are distributed in a round-robin fashion among the existing server instances.
- serverWlm (3): Server-specific WLM and policy information is used to determine distribution.
- weightedActive (4): WLM and policy information are not used to determine how to route future incoming connection requests for this distributed DVIPA. Instead, distribution of incoming TCP connection requests is balanced across the targets such that the number of active connections on each target is proportionally equivalent to a configured active connection weight for each target (specified on the DESTIP parameter of each target).
- targetControlled (5): Incoming connection requests are distributed using weights provided by the Tier 1 targets. This distribution method can be used only with tier 1 targets, such as DataPower® appliances, that are not z/OS® tier 1 targets.
- hotStandby(6): One preferred target and at least one hot-standby target are configured.
DVIPA The dynamic virtual IP address.
DVIPA Port The DVIPA port.
DVIPA Port String The DVIPA port, formatted as a string.
Dynamic XCF IP Address The dynamic XCF IP address of the target TCP/IP stack.
Health Switch An indication of whether the HEALTHSWITCH or NOHEALTHSWITCH option for the HOTSTANDBY distribution method is specified on the VIPADISTRIBUTE statement. The following values are valid:
- No (0): Specifies that the distributor ignores health metrics and switches from the active target only if the target is not ready or if the distributor does not have an active route to the target.
- Yes (1): Specifies that the distributor automatically switches from the active target if the target is not healthy.
ILWEIGHTING When the value of the Distribution Method attribute is serverWlm, an indication of the weighting factor that WLM uses when comparing displaceable capacity at different importance levels (ILs) as it determines a SERVERWLM recommendation for each system.
Interface Name The name of the IPv4 or IPv6 interface associated with the IP address.
Listening Servers The number of servers across all the target stacks that are ready to service connection requests.
LPAR Name The name of the LPAR.
Mobility An indication of how a DVIPA can be moved to another TCP/IP stack. The following values are valid:
- none (1): Moveable status does not apply to the DVIPA. This value is used for entries where backup is specified for the Origin and Status fields.
- immediate (2): This DVIPA can be moved to another stack as soon as the other stack requests ownership.
- whenIdle (3): This DVIPA can be moved to another stack when it has no connections on the current stack.
- nonDisruptive (4): This DVIPA can be moved to another stack as soon as the other stack requests ownership. Existing connections are maintained by the new stack until they are closed, and new connection requests are directed to the new stack.
- disruptive (5): This DVIPA cannot be moved nondisruptively if it is within the defined range on the stack. This value is not supported for IPv6.
Opt Local An indication of whether TCP/IP target stacks should bypass sending connection requests for the DVIPA to the sysplex distributor stack when a server application is available on the target stack. The following values are valid:
- -1: The target stack should send the connection request to the sysplex distributor stack. This value corresponds to the NOOPTLOCAL parameter on the VIPADISTRIBUTE TCP/IP profile statement.
- 0: The connections originating from a target stack within the sysplex always are to bypass sending the connection request to the sysplex distributor.
- 1: The connections originating from a target stack within the sysplex are to bypass sending the connection request to the sysplex distributor as long as the WLM weight for the server on the local stack is not 0. This is the default value if OPTLOCAL is specified without a value.
- 2 - 16: The value is used as a multiplier against the raw WLM weight of the local target stack to cause it to be favored over other target stacks. The higher the value, the more the local stack is favored over other target stacks.
Origin Node The parent node of the workspace.
PROCTYPE CP When the value of the Distribution Method attribute is baseWlm, an indication of the proportion of the workload that is expected to use conventional processors.
PROCTYPE zAAP When the value of the Distribution Method attribute is baseWlm, an indication of the proportion of the workload that is expected to use zAAP processors.
PROCTYPE zIIP When the value of the Distribution Method attribute is baseWlm, an indication of the proportion of the workload that is expected to use zIIP processors.
PROCXCOST zAAP When the value of the Distribution Method attribute is serverWlm, an indication of the crossover cost of running the targeted zAAP workload on a conventional processor instead of on the zAAP processor.
PROCXCOST zIIP When the value of the Distribution Method attribute is serverWlm, an indication of the crossover cost of running the targeted zIIP workload on a conventional processor instead of on the zIIP processor.
Rank The rank of this stack in the chain of backup stacks for a given DVIPA. For entries that do not have an Origin value of backup or define, this value does not apply and is set to N/A.
Status The status of the DVIPA on the given TCP/IP stack. The following values are valid:
- unknown (1): An error occurred.
- active (2): The DVIPA is active.
- backup (3): The given TCP/IP stack is currently a backup owner for the DVIPA.
- moving (4): The DVIPA was active for the TCP/IP stack but the ownership transferred to another TCP/IP stack (for example, because of a takeover).
- quiescing (5): The DVIPA is no longer a target but still has connections. When all existing connections are closed, the status changes to deactivated.
- deactivated (6): The VARY,,TCPIP,SYSPLEX,DEACTIVATE command was run for this DVIPA. The DVIPA remains deactivated until a VARY,,TCPIP,SYSPLEX,REACTIVATE command is run for this DVIPA.
- deactLeavegroup (7): The VARY,,TCPIP,SYSPLEX,DEACTIVATE command was run for this DVIPA, and the VARY,,TCPIP,SYSPLEX,LEAVEGROUP command was run for this stack. If the stack rejoins the sysplex group before a VARY,,TCPIP,SYSPLEX,REACTIVATE command is run for this DVIPA, this DVIPA remains deactivated and the DVIPA status changes to deactivated.
- deactAutonomics (8): The VARY,,TCPIP,SYSPLEX,DEACTIVATE command was run for this DVIPA and the stack left the sysplex group because of an error condition detected by the sysplex autonomics function. If the stack rejoins the sysplex group before a VARY,,TCPIP,SYSPLEX,REACTIVATE command is run for this DVIPA, this DVIPA remains deactivated and the DVIPA status changes to deactivated.
- inactLeavegroup (9): The VARY,,TCPIP,SYSPLEX,LEAVEGROUP command was run for this stack, and the DVIPA is currently inactive. The DVIPA is reactivated if a VARY,,TCPIP,SYSPLEX,JOINGROUP command is run for this stack.
- inactAutonomics (10): The stack left the sysplex group because of an error condition detected by the sysplex autonomics function.
Sysplex Name The name of the sysplex.
Sysplex Port Enabled An indication of whether the sysplex-wide ephemeral port assignment is enabled. The following values are valid:
- Yes: The function is enabled.
- No: The function is not enabled.
System ID The SMF system ID.
TCPIP Host Name The short TCP/IP host name.
TCPIP Job Name The TCP/IP job name.
Timed Affinity The duration, in seconds, that the sysplex distributor function maintains an affinity between connections from a specific client and a server instance on a target stack. A value of 0 indicates that no connection affinity is maintained. A non-zero value indicates that, as long as the number of seconds specified have not elapsed since the close of the previous connection, a subsequent connection for a client is routed to the same server as the previous connection.
Update Time The date and time that the data was last updated. By default, this value is displayed as MM/DD/YY hh:mm:ss, where MM is the month, DD is the day, YY is the year, hh is the hour, mm is the minute, and ss is the second.
XCF Group Name The XCF name used by this TCP/IP stack when joining the sysplex. If the stack has not joined the sysplex group, this value is a zero-length string.
zOS Image Name The name of the z/OS operating system.
zOS Release Level The release level of the z/OS operating system.