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:

• Tracing Report Processing

• Selecting Spool Data for Trace

• Browsing a Report

• Displaying a Spool Record

---

Tracing Report Processing

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:

  15:15:06 **** ENTIRE OUTPUT MANAGEMENT ***** 2018-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 fields are descibed below for each spool system.

Special PF Keys

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.

Line Commands

Command	Function
BR	Browse a report.
DI	Display a record.

To trace processing for a report:

1. Enter the report name in the Report field, the class in the Class field (except for BS2000), and the number of steps to be traced in the Trace field.

   A message indicates whether spool data (print files) exist in this class.

2. If spool data (print files) exist, press PF9 (Procs).

   Report processing is traced for the number of steps entered in the Trace field.

Fields - POWER

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.

Fields - JES

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.

Fields - BS2000

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.

Selecting Spool Data for Trace

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:

1. A selection window is displayed automatically the first time you enter the spool type in the Class field (or for BS2000 the selection criteria in the Select File field) or if you press PF11 (Select).

2. 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.

3. 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.

Browsing a Report

To browse the contents of a report:

1. On the Trace Report Processing screen, press PF10 (Brows).

   A selection window is displayed.

2. 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.

Special PF Keys

PF Key	Function	Explanation
PF4	Layou	Modify report screen layout.
PF5	Rfind	Find a string again.

Displaying a Spool Record

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.