The Trace Report Processing function enables you to monitor each step in the processing of user routines which create or separate a report.
This section covers the following topics:
To invoke this function:
On the Report Definition > Separation
Attributes screen of the report to be traced, press PF11
(Trace); or enter the direct command TRACE in the
command line of any screen.
The Trace Report Processing screen is displayed.
The information displayed differs depending on the spool system of the operating system. The fields are descibed below for each spool system.
| Key | Name | Function |
|---|---|---|
| PF9 | Procs | Begin or continue trace report processing for the specified number of trace steps. |
| PF10 | Brows | Browse a report. |
| PF11 | Selct | Select spool data for trace. |
| Command | Function |
|---|---|
| BR | Browse a report. |
| DI | Display a record. |
To trace processing for a report:
Enter the report name in the Report field, the class in the Class field, and the number of steps to be traced in the Trace field.
A message indicates whether spool data (print files) exist in this class.
If spool data (print files) exist, press PF9 (Procs).
Report processing is traced for the number of steps entered in the Trace field.
| Field | Explanation |
|---|---|
| Report | Enter the report definition to be used. |
| Class | Enter the spool class where the output to be used is located. |
| Trace | Enter the number of calls to the user routine, which are to be processed without user interaction. |
| Node | Enter the number of the Entire System Server node on which the spool resides. |
| The following parameters cannot be modified. They are derived from parameters of the report definition: | |
| Exit-Pgm | The name of the user routine program. |
| Job no | The job number of the output being used. |
| Job name | The job name of the output being used. |
| NatLib | The library where the user routine is located. |
| Data set | The spool file to be processed. |
| ProcName | The identifying PROCNAME. |
| Lang | The language in which the user routine is written (Natural or other). |
| Type | The file type: JL, SI, SO etc. |
| Step | The identifying STEPNAME. |
| DDName | The identifying DDNAME. |
| Step | Identifying step number (number of times the exit has been called). |
| RC | Return code given by the user routine. |
| RecNumb | Record number being processed with this call to the user routine. |
| Action | Action code given by the user routine. |
| Message | Additional information. |
If more than one spool file or print file has been identified, you can select one to be traced.
To select spool data for Trace:
A selection window is displayed automatically the first time you enter the spool type in the Class field or if you press PF11 (Select).
In the window, select the file to be traced by marking it with any character.
The Trace Report Processing screen for the respective spool system will be displayed again.
Enter the class in the Class field and the number of steps to be traced in the Trace field and press PF9 (Procs).
Report processing is traced for the number of steps entered.
To browse the contents of a report:
On the Trace Report Processing screen, press PF10 (Brows).
A selection window is displayed.
In the selection window, mark with "X" the report you wish to browse.
The report is displayed. ISPF-like local commands enable you to browse the report.
| PF Key | Function | Explanation |
|---|---|---|
| PF4 | Layou | Modify report screen layout. |
| PF5 | Rfind | Find a string again. |
To display a spool record:
On the Trace Report Processing screen,
enter the line command DI next to the record you
want to display.
A window is displayed, showing the selected spool record on the left-hand side of the screen and in hexadecimal form on the right-hand side.
