Debugging Batch Programs Through Command-Line Entry

To debug batch programs through command-line entry, use the following steps:

To debug batch programs through command-line entry

  1. If LAWENV is not called as part of your user profile’s sign-on program, you must call the LAWENV program to set the environment variables correctly.
    1. If you installed Lawson Core Technology on an IASP, at the IBM i command prompt, type

      SETASPGRP IASPName

    2. At the IBM i command line, type

      CALL LAWENV

    3. Type the name of an Environment and press Enter.
  2. Compile the program you want to debug. At the Qshell command line, type

    qcompile -D productline systemcode programcode

    Note: If you need to include modules in the compile, use qcompile -Dm productline systemcode programcode .
  3. Submit the program to a job queue that is on hold or is not tied to a subsystem (so that the batch job does not execute).
  4. Start a service job for the program.
    1. Get the job information by typing at the IBM i command line,

      WRKJOBQ QueueName

      where QueueName is the job queue to which you submitted the batch program.

      Select option 5 (Work with) for the job queue and then write down the job, user, and job number information for the appropriate job.

      Note: You can also use the WRKUSRJOB command to find the job information, but this may yield a much longer list of jobs to view in order to find the one you need.
    2. At the IBM i command line, type:

      STRSRVJOB JobNumber/UserName/JobName

  5. Start debug. At the command line, type STRDBG and prompt it (F4). Make sure the library is the one where you compiled the source and that UPDPROD(*YES) is set. If the information is correct, press Enter.
  6. When source listing appears, press F12 to resume.
  7. Start the batch program by changing the job to run in an active queue. On the "Work with Job Queue" screen, enter 2 (Change) to change the job queue for the job. After typing in the job queue name, press Enter.

    The ILE debugger will display the "Start Serviced Job" screen with the following message: "The serviced job has been released from the job queue. Press Enter to start the job or F10 to enter debug commands for that job."

  8. Press F10 and then at the IBM i command line, type:

    DSPMODSRC

  9. Set break points (F6), then press F12, and then press F3 to return to the "Start Serviced Job" screen.
  10. Press Enter to run the program.
  11. After finished with debugging, end debug and the service job. At the IBM i command line, type:

    ENDDBG

    then

    ENDSRVJOB