FCAI_Status_TraceFailed and FCAI_TraceStatus: Reporting failures in the interface trace function

A failure in the interface trace function is not treated as a severe error; if possible, processing continues for the request.
The interface trace function is disabled when it encounters an error and cannot be restarted for this instance of use of the interface.
The additional information described in Table 5 is available only immediately after the request that returns FCAI_Status_TraceFailed. A concurrent error on the request can overwrite the additional information fields.
When a request returns FCAI_Status_TraceFailed and sets a reason of FCAI_TraceStatus_AllocErr (error in dynamic allocation), the additional information can be interpreted as follows:
- The return code, upon completion of the call to the interface, does not contain the return code from dynamic allocation. The return code from dynamic allocation is not reported except as noted in the following item.
- The FCAI_ReturnCode field contains S99ERROR or the number 8.
  If the FCAI_ReturnCode field contains the value 8, the dynamic allocation return code was 8. This return code means an installation validation routine failed the request and S99ERROR is not available.
- The FCAI_ReasonCode field contains S99ERSN for DFSMS failures. For all other cases, it contains S99INFO.
  - S99ERSN is reported in FCAI_ReasonCode for all S99ERROR values that begin with X'97'.
  - S99INFO can be returned when no error was reported on the allocation. In those cases, the FCAI_ReasonCode field contains the S99INFO value even though no other results fields are set.
  - S99INFO can be (and often is) 0 when an error is reported. Only certain conditions set S99INFO.
FCAI_Result contains FCAI_Result_Status when the trace encounters a failure unless a concurrent error sets FCAI_Result to a higher value.
The request that disables the interface trace function adds FCAI_Status_TraceFailed to any other value that is returned in FCAI_Status. When FCAI_Status_TraceFailed is subtracted from FCAI_Status, the result is one of the FCAI_Status values or 0. The result that remains in FCAI_Status is described in Table 7.
FCAI_TraceStatus always reflects the current status of the interface trace function and, if applicable, the reason it was disabled. FCAI_TraceStatus field values are described in Table 5.