iSeries GUI Debugger

Chris Adair

Information Systems Director - National Envelopecadair@natenv.com

Treasurer – Metro Midrange Systems Associationtreasurer@metromidrange.org

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

AlternativeSubmit and Debug Batch Job

Debug Interactive Jobon System

Start Debug from Emulation

Debug Batch JobWith a “MSGW”

RPG/CGI JobRunning on an Apache HTTP

Debugger Toolbarand 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/mpo032703-story04.html

• http://lisug.org/Techtipnewdebugger.htm

• Thanks to:

• Cary Bates – IBM Rochester, MN

• Steve Halverson – IBM Rochester, MN