5.1 Starting the IBM Distributed Debugger

This lesson will show you how to start the IBM Distributed Debugger.

Follow these steps:

  1. To start the debug server on your AS/400, from an AS/400 command line, type STRDBGSVR and then press Enter. If the debug server is already running, you will receive a message that it is already active.
  2. In CODE Project Organizer (CPO) select GUIDES1, which is the program you just compiled.
  3. Right click. Click on CODE debug. Click OK on the Confirm action window. The Load Program and the Distributed Debugger windows appear. The name of your program CUSTAPPxx/GUIDES1 is automatically written into the Specify the name of the program to add to debug field.

    load program dialog

  4. In CODE Project Organizer, choose Tools from the menu bar and then Command shell. The command shell opens.
  5. On the command shell's command line, type ADDLIBLE CUSTAPPxx to add the CUSTAPPxx application to your library list.

    tip You can alternatively enter commands in CODE Project Organizer's command line field.

  6. From the command shell, type DSPJOB. The 5250 emulator that is running your STRCODE session displays your job's name. Make note of the job name and press F12 to return to your emulator's Cooperative Development Environment/400 screen.
  7. In the Job to debug field of the Load Program window, type /USERID/ , where userid is your AS/400 user ID. Click on the Job List button. If prompted with a logon dialog, enter your user ID, password and host name (or IP address) for the AS/400 system you are connecting to. The Job List window is displayed.
  8. In the Job List window, select the job name that you noted previously and click OK. Your job is automatically filled into the Job to debug field of the Load Program window.
  9. From the Load Program window, click on the Advanced button. Then in the Debugger settings window enter your host name (or IP address) and check the box for Update Production Files. Click OK.

    debugger settings

  10. In the Load Program window, ensure that the Step into program and the Use Program profile boxes are checked. Click on Load.
  11. A message box appears asking you to start your application, go to the command shell and type CALL GUIDES1 to start the application then click the OK button on the same message box that prompted you to start your application. Your source is loaded into the Source pane.

    debugger source pane


Click on once you have completed these steps.