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:
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.