aftp_set_trace_filename

The aftp_set_trace_filename call sets the name of the file to which trace information will be written. The default value for the trace level is AFTP_LVL_NO_TRACING. If trace is turned on by the aftp_set_trace_level call and the aftp_set_trace_filename call is not issued, the trace file generated is:

• On MVS: DD:SYSOUT
• On VM: ASUITE TRC
• On Win32®: ASUITE.TRC

AFTP_ENTRY aftp_set_trace_filename(
IN unsigned char AFTP_PTR filename,
IN AFTP_LENGTH_TYPE filename_length,
OUT AFTP_RETURN_CODE_TYPE AFTP_PTR return_code
);

Parameters

filename

The name of the file to be used for trace output.

filename_length

The length of the filename parameter in bytes.

return_code

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

Example

{
    AFTP_RETURN_CODE_TYPE      rc;

    /* The value used for filespec will vary based on platform:
     *   VM common naming:       filename="/a/aftp.trace"
     *   VM native naming:       filename="aftp.trace.a"
     *   MVS PDS common naming:  filename="/user.clist/aftptrac"
     *   MVS PDS native naming:  filename="'user.clist(aftptrac)'"
     *   MVS sequential common:  filename="/user.qual.a.aftptrac"
     *   MVS sequential native:  filename="'user.qual.a.aftptrac'"
     */
    static unsigned char AFTP_PTR filename = "/user.clist/aftptrac";

    /*
     * There are no prerequisite calls for this call.
     */

    aftp_set_trace_filename(
        filename,
        (AFTP_LENGTH_TYPE)strlen(filename),
        &rc);

    if (rc != AFTP_RC_OK) {
        fprintf(stderr, "Error setting tracing filename\n");
    }
}
 

Line Flows

None.