Interpreting the PeopleCode Debugger Log File

You can produce a trace log using any of the following methods:

  • Using the Log File option in the PeopleCode debugger.

  • With the PeopleSoft Configuration Manager Trace tab.

  • Using the SetTracePC and SetTraceSQL built-in functions.

  • With PeopleTools utilities (included for backward compatibility purposes only and should not be used).

All trace files except those produced using the Log File option contain timing information, such as when each line started processing and how long it took to execute.

The Log File option writes to a file that you specify. The log file produced by the other options is specified by the PeopleTools Trace File option in PeopleSoft Configuration Manager. All of these options write to the same file.

Trace files are also produced by Application Engine. These logs may contain more information.

This section discusses:

  • Log file contents.

  • Other items in the log file.

The log file contains information useful for debugging PeopleCode.

You can view the log using any editor that displays ASCII text, such as Notepad. The log file has the following components.

Field or Control


Line Count

Specifies a line number in the file.

Internal Information

Contains reference numbers used for internal tracing. You can ignore this information.

Instruction Location

Address of an instruction processed in the program. You can follow programs and functions using this number.

Operation Code

Indicates the operation performed by the program.

Operation Operands

Contains information specific to each operation. The following table lists the possible operations and the operands that appear for the list and trace options.

The following table describes other items that can appear in a debugging trace:

Trace Item


Store Field:record name.field name Value=xx

Issued when the assignments trace option is selected. It contains the record and field names and the value that is stored.

Fetch Field:recordname.fieldname Value=xx

Issued when the Fetch Field option is selected. It contains the record and field name and the value that is retrieved.

Fetch Field:recordname.fieldname Contains Null Value

Issued when the Fetch Field option is selected and the selected record.field contains a null value.

Fetch Field:recordname.fieldname Does Not Exist

Issued when the Fetch Fields option is selected and when the field is not found.

Branch Taken

Displayed after a branch test when the branch is taken.

Field Not Found, Statement Skipped

Displayed whenever a referenced field was not found error causes the PeopleCode processor to skip to the next statement.

vvvvvv PeopleCode Program Listing

Issued when the List Program option is selected. It marks the beginning of a PeopleCode program listing.

^^^^^ PeopleCode Program Listing End

Issued when the List Program option is selected. It marks the end of a PeopleCode program listing.

Error Return -> NNN

Issued when a fatal error condition terminates the PeopleCode program.