Consolidated Tracing Facility Return Codes

Calls to the Consolidated Tracing Facility library routines return one of the following return codes. These return codes are provided in the mftypes.cpy copybook for COBOL programs, and mftypes.h include file for C programs.

Value Name (COBOL) Name (C) Description
-1 78-CTF-RET-FAILURE CTF_RET_FAILURE Unspecified failure
0 78-CTF-RET-SUCCESS CTF_RET_SUCCESS Success
1 78-CTF-RET-INVALID-TRACE-HANDLE CTF_RET_INVALID_TRACE_HANDLE Invalid trace handle specified
2 78-CTF-RET-INVALID-TRACE-LEVEL CTF_RET_INVALID_TRACE_LEVEL Invalid trace level specified
3 78-CTF-RET-NOT-TRACE-ENABLED CTF_RET_NOT_TRACE_ENABLED Component not enabled for tracing
4 78-CTF-RET-NOT-TRACING-LEVEL CTF_RET_NOT_TRACING_LEVEL Specified event level less than threshold level configured for the component
5 78-CTF-RET-NOT-ENOUGH-MEMORY CTF_RET_NOT_ENOUGH_MEMORY Memory allocation error
6 78-CTF-RET-OUTPUT-ERROR CTF_RET_OUTPUT_ERROR Error outputting to one or more output destinations
7 78-CTF-RET-PROPERTY-NOT-FOUND CTF_RET_PROPERTY_NOT_FOUND Property not found
8 78-CTF-RET-BUFFER-TOO-SMALL CTF_RET_BUFFER_TOO_SMALL Buffer length too small
9 78-CTF-RET-VALUE-NOT-INTEGER CTF_RET_VALUE_NOT_INTEGER Value is not an integer
10 78-CTF-RET-EMITTER-NOT-FOUND CTF_RET_EMITTER_NOT_FOUND Emitter not found
11 78-CTF-RET-INVALID-EVENT-HANDLE CTF_RET_INVALID_EVENT_HANDLE Invalid event handle specified
12 78-CTF-RET-ZERO-LENGTH-DATA CTF_RET_ZERO_LENGTH_DATA Zero length data specified
13 78-CTF-RET-INVALID-PROP-NAME CTF_RET_INVALID_PROP_NAME Invalid property name specified
14 78-CTF-RET-INVALID-COMP-NAME CTF_RET_INVALID_COMP_NAME Invalid component name specified
15 78-CTF-RET-INVALID-EMITTER-NAME CTF_RET_INVALID_EMITTER_NAME Invalid emitter name specified
16 78-CTF-RET-INVALID-PROGRAM-NAME CTF_RET_INVALID_PROGRAM_NAME Invalid program name specified
17 78-CTF-RET-CALLBACK-NOT-FOUND CTF_RET_CALLBACK_NOT_FOUND Callback doesn’t exist
18 78-CTF-RET-CALLBACK-EXISTS CTF_RET_CALLBACK_EXISTS Callback already exists
19 78-CTF-RET-INVALID-FUNCTION-CODE CTF_RET_INVALID_FUNCTION_CODE Invalid function code specified
20 78-CTF-RET-INVALID-SLOT-ID CTF_RET_INVALID_SLOT_ID Invalid slot identifier specified