TRACE

You can use the TRACE command to add trace information from callable interface applications to the QMF trace data output. This command can be used in Assembler, C, COBOL, Fortran, and PL/I applications. It cannot be issued from the QMF command line.

The TRACE command syntax is as follows:

Read syntax diagramSkip visual syntax diagramTRACE(Trace area definitions
Trace area definitions
Read syntax diagramSkip visual syntax diagramnumber of trace areas,trace title lengths,trace title addresses, trace area lengths,trace area addresses,value type
number of trace areas
The number of trace area definitions that you are using in your TRACE command. This number must be in the range of 1 through 10.
trace title lengths
A list of lengths for each trace title that is specified.
trace title addresses
A list of addresses that point to the trace titles that are to be used for each trace area. A trace title can be up to 40-characters long. Trailing blanks are removed. When the first trace title is SNAPREGS, all other trace titles and trace area addresses are ignored, and QMF register values are written to the QMF trace.
trace area lengths
A list that contains the number of bytes of storage that are to be displayed starting at the corresponding trace area address. Trace area lengths must be contained in FIXED(31) integer values.
trace area addresses
A list of addresses that are to be displayed in the trace output. The number of bytes of storage that are displayed at each trace area address is determined by the trace area length. When the first trace title is SNAPREGS, all trace area addresses and trace area lengths are ignored. When the trace area address is 0, the trace area length is also considered to be 0.
value type
Must be value FINT. FINT is a constant value that is provided in the interface communications area (DSQCOMM) for each programming language. The constant is a name that is similar to DSQ_VARIABLE_FINT. Check the interface communications area for your programming language to confirm the variable value.

The TRACE command writes trace area definitions to the QMF trace data output, regardless of QMF trace settings. If you want to write trace output only if QMF trace settings are active, use the DSQAO_APPL_TRACE or DSQAP_TRACE QMF global variables.