statementTrace

When you generate a COBOL program for z/OS®, the statementTrace build descriptor option specifies whether the generated program includes COBOL DISPLAY statements to trace the program as it runs. COBOL DISPLAY statements are included to display each EGL statement before it runs, the SQL error code after each SQL I/O statement, and processing done by EGL-generated initialization, control, and termination code. If you set statementTrace to YES, the trace output is always produced at runtime and is written to standard output for the COBOL DISPLAY statement. If you want to disable the trace, you must set statementTrace to NO and generate the program again.

To trace the SQL error codes that occur during I/O operations on a relational database, use the sqlErrorTrace build descriptor option. To trace the actual SQL I/O statements, including the SQL error codes, use the sqlIOTrace build descriptor option.

Values

NO (the default value)
Specifies that the program will not include COBOL DISPLAY statements for tracing.
YES
Specifies that you want the generated program to include COBOL DISPLAY statements for tracing. Adding additional information to the code can increase generation time and affect performance.

Compatibility

Table 1. Compatibility considerations for statementTrace
Platform Issue
CICS® All output is displayed on a JES output stream (ususally CEEMSG), and output from different transactions is intermingled.
IMS/VS The output destination is the DDNAME that you specify in the COBOL compiler option OUTDD. By default, the output is written to the DDNAME SYSOUT in the job that starts the message region.

z/OS batch
IMS BMP

The output destination is the DDNAME that you specify in the COBOL compiler option OUTDD. By default, the output is written to the DDNAME SYSOUT in the JCL that starts the run unit.
zSeries COBOL Ensure that you have specified the correct CODEPAGE compiler option for your language so the text displays properly. Set the code page compiler option in one of the following ways:

Feedback