11.3. Condition Information

When a condition is trapped and causes a SIGNAL or CALL, this becomes the current trapped condition, and certain condition information associated with it is recorded. You can inspect this information by using the CONDITION built-in function.

The condition information includes:

The name of the current trapped condition
The name of the instruction processed as a result of the condition trap (CALL or SIGNAL)
The status of the trapped condition
A descriptive string (see Section 11.3.1, “Descriptive Strings”) associated with that condition
Optional additional object information (see Section 11.3.2, “Additional Object Information”)

The current condition information is replaced when control is passed to a label as the result of a condition trap (CALL ON or SIGNAL ON). Condition information is saved and restored across subroutine or function calls, including one because of a CALL ON trap and across method invocations. Therefore, a routine called by CALL ON can access the appropriate condition information. Any previous condition information is still available after the routine returns.