EZBCTAPI NMI return and reason codes

When control returns from EZBCTAPI, GPR 15 (and retcode, if you coded RETCODE) contains one of the return codes shown in Table 1. GPR 0 (and rsncode, if you coded RSNCODE) might contain one of the reason codes shown in Table 1.

Table 1. EZBCTAPI return and reason codes
Hexadecimal return code (CtApi_IRtnCd)	Hexadecimal reason code (CtApi_IRsnCd)	Meaning
00	00	Function was successful.
04	See note	The FORMAT function was not successful.
04	10	The SETUP function was not done or did not complete.
04	11	The trace record is not the correct format.
04	17	The trace record did not match the ENTRYID filter.
04	18	The trace record could not be identified.
04	1B	The filter/analysis routine failed.
08	See note	The SETUP function was not successful.
08	01	The SETUP function has already initialized the interface.
08	02	Print callback function was not provided.
08	03	Unable to load format table.
08	04	Unable to allocate storage for tables.
08	05	Unable to load analysis/format exit.
0C	xx	Unknown function code xx.
10	See note	Unable to load the function interface.
10	04	The EZBCTAPI interface routine could not be found.
10	08	An error occurred loading the EZBCTAPI interface routine.
14	See note	Unable to obtain storage for a work area.
14	04	The program was not able to obtain storage for the work area.
18	xxxxxxxx	The interface routine or the analysis routine abended; xxxxxxxx is the abend code.
Note: The first line of a new return code is a generic line about the return code.

Table 2. EZBCTAPI formatter return and reason codes
Hexadecimal return code (CtApi_FRtnCd)	Hexadecimal reason code (CtApi_FRsnCd)	Meaning
00	N/A	Normal processing of the entry
04	N/A	Reread the records from the first
08	N/A	The current entry is bypassed
0C	N/A	No further calls to the format/analysis routine
10	N/A	Ending of the subcommand

These return codes are described in z/OS MVS IPCS Customization for a CTRACE formatter filter/analysis exit. The packet trace formatter uses only a return code of 0 or 8. The interface return code (CtApi_IRtnCd) is always 0 for formatter return codes of 0, 4, 8, and 12; otherwise, an interface return code of 4 is returned (see interface reason code X'1B').