iSeries GUI Debugger Chris Adair Information Systems Director - National Envelope Treasurer – Metro Midrange Systems Association

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 ( –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 story04.htmlhttp:// story04.html Thanks to: Cary Bates – IBM Rochester, MN Steve Halverson – IBM Rochester, MN