Use the GTRACE macro to record system or application errors through
the generalized trace facility (GTF). The GTRACE macro provides three
separate functions, depending on the keyword specified:
- GTRACE TEST indicates whether the operator requested a specific
user event.
- GTRACE QUERY indicates how much data GTF can store when a program
issues GTRACE DATA.
- GTRACE DATA generates GTF trace records for specific events.
Refer to z/OS MVS Diagnosis: Tools and Service Aids and z/OS Problem Management for information about using GTF.
The following description of the GTRACE macro is divided into three
sections, one for each function of the macro. The TEST and QUERY
functions have only one form each, while the DATA function has standard,
list, and execute forms.