Guardian Procedure Calls Reference Manual

FP_IEEE_ENABLES_GET_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Returned Value
Considerations
Summary
The FP_IEEE_ENABLES_GET_ procedure reads the IEEE floating-point trap enable mask. A set bit
(value of one) means that the trap for that particular exception is enabled. A zero bit means that
it is disabled.
NOTE: This procedure is supported in all J-series and H-series RVUs and in G-series RVUs
beginning with G06.06. IEEE floating-point is available on all NB-Series and NS-Series systems,
and on all S-Series systems, except S70000 servers with NSR-G processors.
Syntax for C Programmers
#include <kfpieee.h
fp_ieee_enables FP_IEEE_ENABLES_GET_ ( void );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KFPIEEE
traps := FP_IEEE_ENABLES_GET_;
Returned Value
INT(32)
The trap enable mask. The mask bit values are:
Trap on FP_IEEE_INVALID exception.FP_IEEE_ENABLE_INVALID
Trap on FP_IEEE_DIVBYZERO exception.FP_IEEE_ENABLE_DIVBYZERO
Trap on FP_IEEE_OVERFLOW exception.FP_IEEE_ENABLE_OVERFLOW
Trap on FP_IEEE_UNDERFLOW exception.FP_IEEE_ENABLE_UNDERFLOW
Trap on FP_IEEE_INEXACT exception.FP_IEEE_ENABLE_INEXACT
Considerations
• A constant named FP_IEEE_ALL_ENABLES is equivalent to a combination of the mask bits to
enable traps for all the exceptions.
• In some cases, the conditions that cause a trap are slightly different from the conditions that
cause the corresponding exception flag to be set.
• When a trap occurs, a SIGFPE signal is raised. The default handling of this signal is process
termination. If a signal handler for SIGFPE is armed and that signal is not blocked, the handler
is called. A SIGFPE signal handler typically does a function frame trace showing the point
of failure, and then abends the process. The SIGFPE signal is not allowed to return to the point
where the trap happened.
FP_IEEE_ENABLES_GET_ Procedure 639