Explanation
This message is issued to document the effective
failure detection interval (INTERVAL) and the effective operator notification
interval (OPNOTIFY), and the data used to compute these values. The
message is issued by XCF in response to changes that can impact the
failure detection interval or the operator notification interval.
In
the message text:
- sysname
- The name of system whose settings are being documented.
- einterval
- The effective failure detection interval (INTERVAL) being used,
expressed in seconds.
When the USERINTERVAL function is disabled
(which is the default behavior), this value takes the larger of the
user-specified INTERVAL and the interval derived from the excessive
spin recovery parameters. When the USERINTERVAL function is enabled,
the user-specified INTERVAL value is used even if it is smaller than
the interval derived from the excessive spin parameters. IBM® suggests that the INTERVAL be defaulted to
the derived interval.
- eopnotify
- The effective operator notification interval (OPNOTIFY) being
used, expressed in seconds.
- If OPNOTIFY is specified as a relative value, the effective OPNOTIFY
value is the sum of the effective INTERVAL value einterval and
the relative OPNOTIFY value +ooooo, but not more
than the maximum value of 86400.
- If OPNOTIFY is specified as an absolute value, the effective OPNOTIFY
value is the larger of the effective INTERVAL value einterval and
the absolute OPNOTIFY value ooooo.
- isource
- The source from which XCF obtains the user failure detection interval
value:
- SETXCF
- The value is set by the SETXCF COUPLE,INTERVAL command.
- PARMLIB
- The value is explicitly set by the INTERVAL parameter of the COUPLE
statement in the COUPLExx parmlib member at IPL time.
- DEFAULT
- The default value is used. The default INTERVAL value is derived
from the excessive spin parameters that are currently defined for
the system. The value changes dynamically in response to the SET
EXS command.
- CLUSTER
- The value is set by cluster management instrumentation software.
- uinterval
- The failure detection interval specified for the system, either
explicitly or by default. The value is expressed in seconds.
- spinfdi
- The failure detection interval derived from the current excessive
spin recovery parameters, expressed in seconds.
The value is computed
as follows:
spinfdi = (N+1)*SpinTime + 5
where
N is
the number of excessive spin recovery actions, +1 indicates the implicit
SPIN action, and
SpinTime is the excessive spin loop
timeout interval. The SPINRCVY statement and the SPINTIME keyword
in the EXSPATxx parmlib member determine the number of spin actions
and the spin loop timeout, respectively. If the excessive spin parameters
are not explicitly set on an EXSPATxx parmlib member, the IBM supplied default spin parameters
are used. Note that the failure detection interval derived from the
excessive spin parameters changes if the SET EXS command is issued
to change the excessive spin recovery parameters.
- osource
- The source of the user-specified operator notification value:
- SETXCF
- The value is set by the SETXCF COUPLE,OPNOTIFY command.
- PARMLIB
- The value is explicitly set by the OPNOTIFY parameter of the COUPLE
statement in the COUPLExx parmlib member at IPL time.
- DEFAULT
- The default value of +3 is used. Thus the effective OPNOTIFY is
three seconds more than the effective failure detection interval.
- [+]uopnotify
- The OPNOTIFY value specified by the user, whether explicitly or
by default. The value is displayed as +ooooo for
a relative OPNOTIFY value, ooooo for an absolute
OPNOTIFY value.
- impetus
- The processing for which this message is issued:
- XCF INITIALIZATION
- The message documents the values being used as a result of XCF
initialization.
- SETXCF COUPLE,INTERVAL
- The message documents the values being used as a result of processing
a SETXCF COUPLE,INTERVAL command.
- CLUSTER SETSYSTEMFDI
- The message documents the values being used as a result of processing
changes made by cluster management instrumentation software.
- SETXCF COUPLE,OPNOTIFY
- The message documents the values being used as a result of processing
a SETXCF COUPLE,OPNOTIFY command.
- SETXCF FUNCTIONS
- The message documents the values being used as a result of
processing a SETXCF FUNCTIONS command to enable or disable the USERINTERVAL
function.
The current setting of the USERINTERVAL can be determined
by issuing the DISPLAY XCF,COUPLE command.
- SET EXS
- The message documents the values being used as a result of processing
a SET EXS command to set excessive spin recovery parameters.
- XCF RECOVERY
- The message documents the values being used as a result of resolving
an XCF error.
System action
The system uses the indicated effective intervals.
- If the system fails to update its status within the effective
failure detection interval, it is considered to be status
update missing.
- If the system fails to update its status within the effective
operator notification interval, the operator can be notified of the
condition by an XCF message (for example, IXC402D).
A system that is
status update missing can cause
sympathy sickness on other systems in the sysplex, and therefore should
be removed from the sysplex to avoid further problems.
Operator response
When XCF recovery is displayed,
XCF might have reset the failure detection interval (INTERVAL), or
the operator notification interval (OPNOTIFY), or both, to the IBM supplied default values. If
so, issue the SETXCF COUPLE,INTERVAL command to set the failure detection
interval to the required installation specified value, or the SETXCF
COUPLE,OPNOTIFY command to set the operator notification interval
to the required installation specified value.
No action is
required for other cases.
System programmer response
Source
Cross System Coupling Facility (SCXCF)
Module
IIXCI2PH2, IXCO1ASY, IXCB1MRP
Routing code
Descriptor code