Transcript iSeries GUI Debugger

iSeries GUI Debugger
Chris Adair
Information Systems Director - National Envelope
[email protected]
Treasurer – Metro Midrange Systems Association
[email protected]
Supported Releases
• V5R3 – SI18710 (Latest Server PTF)
• V5R2 PTF’s
– Server PTF SI09834, SI08512
– Client PTF SI09844
• V5R1 PTF’s
– Server PTF SI09825
– Client PTF SI06031
Supported Languages
•
•
•
•
•
•
•
•
ILE C/C++
ILE RPG
ILE COBOL
ILE CL
JAVA
OPM RPG
OPM COBOL
OPM CL
Supported Debug Scenarios
• Submit and Debug Program in Batch Job
– Job name is same name as program
– Job owner is current User
– Submitted to QUSRWRK subsystem
• Debug existing job on system
– Browse option for locating job
– Cut and paste job information
• STRDBG command from emulation session
– Debug manager must be active and ready
– Must be same user as registered in Debug Manager
– Emulation session must be running on same ip address as
Debug Manager
– If criteria is not satisfied; traditional green screen debugger is
launched
Advantages
•
•
•
•
Run to Cursor
Monitor/Watch several fields at a time
Multiple Breakpoint Groups in 1 program
Automatically Saves Previous Debug
Session
• Save the current session to local drive
QTESDBGHUB
• Starting the Debug Hub
– V5R1 Call QSYS/QTESSTRSVR
– V5R2 STRTCPSVR *DBG
• Runs in QSYSWRK subsystem
• Single point of contact for user interface
– Registered in TCP/IP service table (port 4026)
– User interface uses port mapper to locate server
• Submits Debug Server jobs (QTESDBGSVR)
• Registration facility for iSeries Debug Manager
– STRDBG command from an emulator will perform graphical
debug instead of traditional green screen debug
QTESDBGSVR
• Submitted by QTESDBGHUB
• Runs in QUSRWRK subsystem
– Make sure QUSRWRK subsystem is started
– Make sure QUSRNOMAX job queue is not held
• Issues STRSRVJOB and STRDBG against job to be
debugged
• One QTESSBGSVR job per user interface window
Client Setup
• Install Java 1.3 run-time environment (JRE)
• Copy JavaHelp (http://java.sun.com/products/javahelp)
– Jhall.jar contains java classes necessary to display help
• Copy jt400.jar to client
– /QIBM/PRODDATA/HTTP/public/jt400/lib/jt400.jar
• Copy iSeries System Debugger tes.jar to client
– /QIBM/PRODDATA/HTTP/public/jt400/lib/tes.jar
• Modify Classpath
–
–
–
–
–
Right click “My Computer”
select “Properties”
Select “ADVANCED” tab
Select “ENVIORNMENT VARIABLES”
Highlight “CLASSPATH” and select EDIT
– i.e. CLASSPATH=C:\debugger\tes.jar;C:\debugger\jt400.jar;C:\debugger\jhall.jar
Start the Debug Manager
Add System to Manager
Submit and Debug in Batch
Alternative
Submit and Debug Batch Job
Debug Interactive Job
on System
Start Debug from Emulation
Debug Batch Job
With a “MSGW”
RPG/CGI Job
Running on an Apache HTTP
Debugger Toolbar
and Window Panes
Main Options on Toolbar
Condition a Breakpoint
Setup Monitors
Monitor Pane – Displays Values
Monitor/Watch
Locals Tab – Displays Local
Variables
Breakpoint Groups
Saving the Environment
References
• Online Help
• http://www.itjungle.com/mpo/mpo032703story04.html
• http://lisug.org/Techtipnewdebugger.htm
• Thanks to:
• Cary Bates – IBM Rochester, MN
• Steve Halverson – IBM Rochester, MN