HFZXTRCE – Write simple line of text to HFZTRACE

Format

#include "hfzxhfmt.h"

int HFZXTRCE(char *psz, ...);

General description

HFZXTRCE() can be used to perform the following functions:

  • Control the tracing of HFZ* function calls by writing information to the HFZTRACE DDname about passed parameters and final return code.
    • If the psz arg is specified as "(char )-1", then HFZ* function call tracing is enabled.
    • If the psz arg is specified as "NULL", then HFZ* function call tracing is disabled
  • Write a line of unformatted text to the HFZTRACE DDname. The psz argument must point to a NULL-terminated string. This mode of the function is equivalent to using the REXX command "SAY" from within a Z Abend Investigator REXX user exit.

If the psz argument is a format string suitable for use by the C sprintf() function, then extra required arguments can follow.

Returned value

HFZXTRCE() always returns zero.

Example

#include "hfzxhfmt.h"

int i = 5;
HFZTRACE((char *)-1);  /* start HFZ* function tracing */
HFZXTRCE("Couldn't format data area ABC.");
HFZXTRCE("A total of %d control blocks formatted.", i);