Tracing & Debugging in People Tools 8.4x CMS411

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