• The Four Hundred
  • Subscribe
  • Media Kit
  • Contributors
  • About Us
  • Contact
Menu
  • The Four Hundred
  • Subscribe
  • Media Kit
  • Contributors
  • About Us
  • Contact
  • Guru: Graphical Debugging Through ACS

    June 8, 2020 Ted Holt

    ACS (IBM i Access Client Solutions) keeps getting better and better. I can’t stay up-to-date with the latest releases of all the software I use, but I do everything I can to keep up-to-date with ACS. One of the handiest of the relatively most recent releases is the ability to access IBM i Debugger through Run SQL Scripts. If you haven’t tried IBM i Debugger, you’re missing out.

    IBM i Debugger (a.k.a. System Debugger) is part of the IBM Toolkit for Java. It’s graphical, and it makes the green-screen debugger (STRDBG) look like something built by cavemen. To show you how to access it through ACS, I debug a small interactive green-screen program.

    I can’t reference the debugger from the main ACS menu. Instead, I have to start Run SQL Scripts and take the System Debugger link under the Run menu, as shown in Figure 1.

    Figure 1: Start IBM i Debugger from Run SQL Scripts.

    Once the debugger is open, I select the Start Debug option from the Debug menu to open the Start Debug dialog. (Please see Figure 2.)

    Figure 2: Use the Start Debug dialog to set up to debug a program.

    If the program to be debugged does not use a display file, you have two options. You can debug an existing job or you can let the debugger run your program as a batch job. Since my program uses a display file, I have to run in a 5250 session, which I specify as the existing job.

    After filling in the appropriate information, I click on OK to proceed to the debugging screen. (Please see Figure 3.)

    Figure 3: The system debugger screen.

    The problem with this program is that it does not retrieve a customer name from the database. To add a breakpoint at the CHAIN operation, I click once to the left of the line number 5. The debugger places a red arrow where I clicked. Clicking on the arrow would remove the breakpoint.

    I click the green arrowhead (“Resume”) just under the menu bar to continue. Then I switch to that job and call the program I want to debug. I enter the customer account number and press Enter in my 5250 session. The debugger stops at the breakpoint. (Please see Figure 4.)

    Figure 4: The Locals tab displays values and allows them to be changed.

    Notice the bottom left panel. The Locals tab interests me. It shows me the local variables for the main routine or current subprocedure. If I wish, I can double-click on a value to change it. I can also hover the mouse pointer over a variable to see its value in a pop-up.

    I see the problem. The program uses the CUST field, which is defined in the database file, to read file YG021P. CUST has a value of zero, even though I keyed the value 1 into the screen. Ah, that’s it! The author of the program should have chained with #CUST, the field in the display file. Problem solved!

    I click on the green arrowhead in the debugger to let the program resume, switch to the 5250 session to end the program, and the debugger lets me know in a pop-up window that the program has finished. I select the End Debug option from the Debug menu.

    At this point, I change the source code, recompile, and begin again with Start Debug in the Debug menu. I will do this over and over until I’ve fixed the program and no longer wish to debug. Then I close the debugger and move on to my next task.

    It’s a good little debugger. It debugs ILE and OPM programs (be sure to set the debugging options appropriately when creating a program), Java, and programs that run in PASE. It’s got a tiny footprint and is simple enough to use intuitively. I’m grateful to IBM for giving me a way to access it from ACS.

    RELATED STORIES

    IBM i Debugger (IBM Knowledge Center)

    Debug IBM i Programs Graphically

    Share this:

    • Reddit
    • Facebook
    • LinkedIn
    • Twitter
    • Email

    Tags: Tags: 400guru, ACS, FHG, Four Hundred Guru, IBM i, ILE, Java, OPM, PASE, SQL

    Sponsored by
    WorksRight Software

    Do you need area code information?
    Do you need ZIP Code information?
    Do you need ZIP+4 information?
    Do you need city name information?
    Do you need county information?
    Do you need a nearest dealer locator system?

    We can HELP! We have affordable AS/400 software and data to do all of the above. Whether you need a simple city name retrieval system or a sophisticated CASS postal coding system, we have it for you!

    The ZIP/CITY system is based on 5-digit ZIP Codes. You can retrieve city names, state names, county names, area codes, time zones, latitude, longitude, and more just by knowing the ZIP Code. We supply information on all the latest area code changes. A nearest dealer locator function is also included. ZIP/CITY includes software, data, monthly updates, and unlimited support. The cost is $495 per year.

    PER/ZIP4 is a sophisticated CASS certified postal coding system for assigning ZIP Codes, ZIP+4, carrier route, and delivery point codes. PER/ZIP4 also provides county names and FIPS codes. PER/ZIP4 can be used interactively, in batch, and with callable programs. PER/ZIP4 includes software, data, monthly updates, and unlimited support. The cost is $3,900 for the first year, and $1,950 for renewal.

    Just call us and we’ll arrange for 30 days FREE use of either ZIP/CITY or PER/ZIP4.

    WorksRight Software, Inc.
    Phone: 601-856-8337
    Fax: 601-856-9432
    Email: software@worksright.com
    Website: www.worksright.com

    Share this:

    • Reddit
    • Facebook
    • LinkedIn
    • Twitter
    • Email

    Unit Testing Gets A Boost With ARCAD Thoroughly Modern: Top Five Reasons To Go Paperless With IBM i Forms

    One thought on “Guru: Graphical Debugging Through ACS”

    • Greg Wilburn says:
      June 8, 2020 at 9:01 am

      Wow. I didn’t know that was available! I use ACS Run SQL Scripts quite a bit. I added a button for Run SQL Scripts to the 5250 session to make it more convenient to access.

      Reply

    Leave a Reply Cancel reply

TFH Volume: 30 Issue: 36

This Issue Sponsored By

  • New Generation Software
  • Fresche Solutions
  • Profound Logic Software
  • ARCAD Software
  • Raz-Lee Security

Table of Contents

  • IBM Wheels And Deals With Solution Edition Booster Pack
  • Thoroughly Modern: Top Five Reasons To Go Paperless With IBM i Forms
  • Guru: Graphical Debugging Through ACS
  • Unit Testing Gets A Boost With ARCAD
  • IBM i PTF Guide, Volume 22, Number 23

Content archive

  • The Four Hundred
  • Four Hundred Stuff
  • Four Hundred Guru

Recent Posts

  • POWERUp 2025 –Your Source For IBM i 7.6 Information
  • Maxava Consulting Services Does More Than HA/DR Project Management – A Lot More
  • Guru: Creating An SQL Stored Procedure That Returns A Result Set
  • As I See It: At Any Cost
  • IBM i PTF Guide, Volume 27, Number 19
  • IBM Unveils Manzan, A New Open Source Event Monitor For IBM i
  • Say Goodbye To Downtime: Update Your Database Without Taking Your Business Offline
  • i-Rays Brings Observability To IBM i Performance Problems
  • Another Non-TR “Technology Refresh” Happens With IBM i TR6
  • IBM i PTF Guide, Volume 27, Number 18

Subscribe

To get news from IT Jungle sent to your inbox every week, subscribe to our newsletter.

Pages

  • About Us
  • Contact
  • Contributors
  • Four Hundred Monitor
  • IBM i PTF Guide
  • Media Kit
  • Subscribe

Search

Copyright © 2025 IT Jungle