aftp_set_trace_level

The aftp_set_trace_level call sets the level of tracing to use for AFTP activities. The new trace level will take effect immediately upon making this call. The trace output is captured in the file specified in the aftp_set_trace_filename call that must be issued before this call.

AFTP_ENTRY aftp_set_trace_level(
IN AFTP_TRACE_LEVEL_TYPE trace_level,
OUT AFTP_RETURN_CODE_TYPE AFTP_PTR return_code
);

Parameters

trace_level

The amount of trace information to be generated. The constants from AFTP_LVL_NO_TRACING to AFTP_LVL_MAX_TRACE_LVL incrementally increase the amount of trace information.

AFTP_LVL_NO_TRACING

Writes no data to the trace log.

AFTP_LVL_API

Traces crossings of the API boundary.

AFTP_LVL_MAX_TRACE_LVL

Provides the maximum amount of trace information.

Other trace levels are reserved for diagnosing problems with the assistance of vendor support.

return_code

The return code issued for this function. See AFTP Return Codes for the list of possible return codes.

Example

{

    /*
     * The following calls must be issued here:
     *    aftp_set_trace_filename()
     */

    /*
     * Turn on the tracing.
     */

    aftp_set_trace_level(trace_level, &rc);

    if (rc != AFTP_RC_OK) {
        fprintf(stderr, "Error setting the trace level\n");
    }
}
 

Line Flows

None.