IDIXTRCE – Write simple line of text to IDITRACE

#include "idixhfmt.h"

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

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

• Control the tracing of IDI* function calls by writing information to the IDITRACE DDname about passed parameters and final return code.
  • If the psz arg is specified as "(char )-1", then IDI* function call tracing is enabled.
  • If the psz arg is specified as "NULL", then IDI* function call tracing is disabled
• Write a line of unformatted text to the IDITRACE 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 Fault Analyzer 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.

IDIXTRCE() always returns zero.

#include "idixhfmt.h"

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