tracing & debugging in people tools 8.4x cms411
DESCRIPTION
Detail overview of tracing and debugging techniques in PeopleSoft by Kai Markowitz from CSUTRANSCRIPT
Tracing & Debugging in PeopleTools 8.4x
Kai MarkowitzTechnical Lead
** This presentation has notes, don’t just view/print the slides **
April 2007
Student Administration
22
Student Administration
Introduction PeopleTools 8.4x Changes Tracing SQL & PeopleCode Tracing SQR Programs Tracing Cobol Programs Tracing App Engine Programs PeopleCode Debugging Questions
Agenda
33
Student Administration
Introduction PeopleTools 8.4x ChangesPeopleTools 8.4x Changes Tracing SQL & PeopleCodeTracing SQL & PeopleCode Tracing SQR ProgramsTracing SQR Programs Tracing Cobol ProgramsTracing Cobol Programs Tracing App Engine ProgramsTracing App Engine Programs PeopleCode DebuggingPeopleCode Debugging QuestionsQuestions
Agenda
44
Student Administration
IntroductionIntroduction PeopleTools 8.4x Changes Tracing SQL & PeopleCodeTracing SQL & PeopleCode Tracing SQR ProgramsTracing SQR Programs Tracing Cobol ProgramsTracing Cobol Programs Tracing App Engine ProgramsTracing App Engine Programs PeopleCode DebuggingPeopleCode Debugging QuestionsQuestions
Agenda
55
Student Administration
No more pstools.exe on the local client!– CS 8.9 can’t be run in two-tier mode.
No tracing/debugging in two-tier mode.– App Engine programs are the only exception
to this. Trace files are on the application server.
– Examining the trace files requires access to the Unix server.
PeopleTools 8.4x Changes
66
Student Administration
IntroductionIntroduction PeopleTools 8.4x ChangesPeopleTools 8.4x Changes Tracing SQL & PeopleCode Tracing SQR ProgramsTracing SQR Programs Tracing Cobol ProgramsTracing Cobol Programs Tracing App Engine ProgramsTracing App Engine Programs PeopleCode DebuggingPeopleCode Debugging QuestionsQuestions
Agenda
77
Student Administration
These are very good trace settings to use in order to get a very “light” but useful trace.– Use a unique
User ID when tracing to make the trace file easier to read.
Tracing SQL & PeopleCode
88
Student AdministrationTracing SQL & PeopleCode
Trace files are found in the PS_SERVDIR/LOGS directory of your application server.– PS_SERVDIR is a Unix environment variable.
99
Student AdministrationTracing SQL & PeopleCode
1010
Student AdministrationTracing SQL & PeopleCode
SQL Error
1111
Student AdministrationTracing SQL & PeopleCode
PeopleCode Error
1212
Student AdministrationTracing SQL & PeopleCode
If you find an area of PeopleCode that appears to be a performance issue or returns “unexpected” results, you can trace the same area again with an expanded set of trace options
1313
Student AdministrationTracing SQL & PeopleCode
Expanded PeopleCode Error
1414
Student Administration
IntroductionIntroduction PeopleTools 8.4x ChangesPeopleTools 8.4x Changes Tracing SQL & PeopleCodeTracing SQL & PeopleCode Tracing SQR Programs Tracing Cobol ProgramsTracing Cobol Programs Tracing App Engine ProgramsTracing App Engine Programs PeopleCode DebuggingPeopleCode Debugging QuestionsQuestions
Agenda
1515
Student Administration
Append the –s flag to the Process Definition to see a list of the SQL in the program and execution counts .
Tracing SQR Programs
1616
Student AdministrationTracing SQR Programs
1717
Student Administration
Append the –debug flag to the Process Definition along with the debug flag(s) you want to see.
Tracing SQR Programs
1818
Student Administration
The trace file can be accessed directly within the Process Monitor.
Tracing SQR Programs
1919
Student Administration
IntroductionIntroduction PeopleTools 8.4x ChangesPeopleTools 8.4x Changes Tracing SQL & PeopleCodeTracing SQL & PeopleCode Tracing SQR ProgramsTracing SQR Programs Tracing Cobol Programs Tracing App Engine ProgramsTracing App Engine Programs PeopleCode DebuggingPeopleCode Debugging QuestionsQuestions
Agenda
2020
Student Administration
Override the Parameters List in the Process Definition using the following template:– PRCSNAME ORACLE/%%DBNAME%%/%%OPRID%
%/%%OPRPSWD%%/%%RUNCNTLID%%/%%INSTANCE%%/255/%%DBFLAG%%
Tracing Cobol Programs
2121
Student Administration
The trace file can be accessed directly within the Process Monitor.
Tracing Cobol Programs
2222
Student AdministrationTracing Cobol Programs
PeopleSoft Cobol
2323
Student AdministrationTracing Cobol Programs
Trace (Body)
2424
Student AdministrationTracing Cobol Programs
Trace (Timings)
1.
3.
2.
2525
Student AdministrationTracing Cobol Programs
SQL Error
2626
Student AdministrationTracing Cobol Programs
“DMS” Error: Select Item
2727
Student AdministrationTracing Cobol Programs
“DMS” Error: Bind Variable
2828
Student AdministrationTracing Cobol Programs
Subscript out of range
2929
Student Administration
Tracing Cobol executed from a RemoteCall in PeopleCode (e.g., pushbutton) is the most complex type of trace to setup in PeopleTools 8.4x.
Requires making changes to the psappsrv.cfg file on the Unix server.– Located in PS_SERVDIR directory.
Impacts everyone using the application. Be sure to turn off the trace as soon as you are done.
Tracing Cobol Programs
3030
Student Administration
Set TraceSQL=255 in psappsrv.cfg*.*Note: The associated “Mask” value must
be set higher than this.
Tracing Cobol Programs
3131
Student Administration
Set RCCBL Redirect=1 in psappsrv.cfg.
Tracing Cobol Programs
3232
Student Administration
Cobol trace files can be found in the PS_SERVDIR/LOGS directory*.*Note: The .err file is only found if there is a Cobol error.
Tracing Cobol Programs
3333
Student Administration
IntroductionIntroduction PeopleTools 8.4x ChangesPeopleTools 8.4x Changes Tracing SQL & PeopleCodeTracing SQL & PeopleCode Tracing SQR ProgramsTracing SQR Programs Tracing Cobol ProgramTracing Cobol Programs Tracing App Engine Programs PeopleCode DebuggingPeopleCode Debugging QuestionsQuestions
Agenda
3434
Student Administration
App Engine programs rule! App Engine programs can be traced in
two-tier mode from the Application Designer.
The PeopleCode Debugger can be used with App Engine programs in two-tier mode from the Application Designer*.*Note: This is the only case in PeopleTools 8.4x where the
PeopleCode Debugger can be run in two-tier mode
Tracing App Engine Programs
3535
Student Administration
Append the appropriate trace flag(s) to the Process Definition.• -TRACE 131 (App Engine trace, required)• -TOOLSTRACEPC 2048 (PCode trace, optional)
• -TOOLSTRACESQL 31 (SQL trace, optional)
Tracing App Engine Programs
3636
Student Administration
The trace files can be accessed directly in process monitor.
Tracing App Engine Programs
3737
Student Administration
Trace (Body)
Tracing App Engine Programs
3838
Student Administration
Trace (SQL Timings)
Tracing App Engine Programs
3939
Student Administration
Trace (PeopleCode Timings)
Tracing App Engine Programs
4040
Student Administration
Trace (Totals & Environment)
Tracing App Engine Programs
4141
Student Administration
SQL Error (Process Monitor)
Tracing App Engine Programs
4242
Student Administration
SQL Error (Trace)
Tracing App Engine Programs
4343
Student Administration
PeopleCode Error (Process Monitor)
Tracing App Engine Programs
4444
Student Administration
PeopleCode Error (Trace)
Tracing App Engine Programs
4545
Student Administration
Dynamic Call Error (Trace)
Tracing App Engine Programs
4646
Student Administration
For two-tier tracing, you must run App Engine processes through the web browser at least once; you need to do this in order to have a Run Control ID and Process Instance Number*.
Tracing App Engine Programs
4747
Student Administration
Turn on your Application Engine Trace flags in the Configuration Manager.
Tracing App Engine Programs
4848
Student Administration
With the App Engine program open in the Application Designer, press the Run Program icon and enter the Run Control ID and Process Instance Number. Click ‘OK’ to run the App Engine process in two-tier mode.
Tracing App Engine Programs
Defaults
4949
Student Administration
You can find the log files for the run in the C:\TEMP\PS\DBName directory*.*Note: The location of this file can vary depending on the
particular configuration of your workstation.
Tracing App Engine Programs
5050
Student Administration
To debug PeopleCode in an App Engine program, turn on the PeopleCode Debugger Mode and set breakpoints before running.
Tracing App Engine Programs
5151
Student Administration
IntroductionIntroduction PeopleTools 8.4x ChangesPeopleTools 8.4x Changes Tracing SQL & PeopleCodeTracing SQL & PeopleCode Tracing SQR ProgramsTracing SQR Programs Tracing Cobol ProgramsTracing Cobol Programs Tracing App Engine ProgramsTracing App Engine Programs PeopleCode Debugging QuestionsQuestions
Agenda
5252
Student Administration
Online PeopleCode Debugging must be done three-tier from the Citrix desktop.– Login to App Designer with the name of the
application server.
PeopleCode Debugging
5353
Student Administration
Debugging swaps back and forth between browser session and App Designer*.*Note: You must login to both sessions with the same Userid.
PeopleCode Debugging
5454
Student Administration
IntroductionIntroduction PeopleTools 8.4x ChangesPeopleTools 8.4x Changes Tracing SQL & PeopleCodeTracing SQL & PeopleCode Tracing SQR ProgramsTracing SQR Programs Tracing Cobol ProgramsTracing Cobol Programs Tracing App Engine ProgramsTracing App Engine Programs PeopleCode DebuggingPeopleCode Debugging Questions
Agenda
5555
Student Administration