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);