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.
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:
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.
DVIPA
The dynamic virtual IP address.
DVIPA Port
The distributed DVIPA port.
Dynamic XCF IP Address
The dynamic XCF IP address
of the target TCP/IP stack.
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.