The Trace Report Processing facility 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 appears:
15:15:06 **** ENTIRE OUTPUT MANAGEMENT ***** 2008-11-15
User ID XYZ - Trace Report Processing POWER -
Report _________________ ________
Exit-Pgm NatLib Lang
Class _ Node 33_ Job name Job no Queue
Trace 1_
Cmd Step RC RecNumb Action Message
___ ____ ___ _______ ________ ________________________________________________
__
__
__
__
__
__
__
__
__
__
__
Command => ___________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip Procs Brows Selct Menu
|
The information displayed differs depending on the spool system of the operating system. The individual 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 (except for BS2000/OSD), 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 that 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 are output fields and not modifiable. They are derived from parameters of the report definition: | |
| - Exit-Pgm | The name of the user routine program. |
| - Job name | The job name of the output being used. |
| - NatLib | The library where the user routine is located. |
| - Job no | The job number of the output being used. |
| - Lang | The language in which the user routine is written (Natural or other). |
| - Queue | The LS - POWER list queue. |
| 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. |
| 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. |
| Dataset | The spool dataset to be processed. |
| ProcName | The identifying PROCNAME. |
| Lang | The language in which the user routine is written (Natural or other). |
| Type | The dataset 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. |
| Field | Explanation |
|---|---|
| Report | Enter the report definition to be used. |
| Node | Enter the Entire System Server node number on which the print file resides. |
| Trace | Enter the number of calls to the user routine that are to be processed without user interaction. |
| Select File | Enter the completely or partially qualified name of the print file here. |
| Print File | The print file you have selected. |
| Step | Trace step number. |
| 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 dataset 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 for BS2000/OSD the selection criteria in the Select File field) or if you press PF11 (Select).
In the window, select the dataset / print 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.
