Run the COBOL Client

Walks you through the process of running the COBOL client application to debug the Web service.
Restriction: This topic applies to Windows environments (local development) only.

Run the COBOL Client

  1. From the Application Explorer view, expand ProgramREST > client.
  2. Right-click MakeCheckAppt-app.cbl; then select Debug As > COBOL Application from the context menu.
    Note: If a Confirm Perspective Switch message appears, click Switch.

    This places an entry into the Debug view for the client application.

  3. In the Debug view, right-click the bottom-most entry; then select Resume.
  4. The client invokes a console named runm, and waits for input. Complete the fields as follows to set an appointment slot:
    Service Address leave blank
    Username leave blank
    Password leave blank
    Operation 1
    lnk_customer_name Benton Riley
    lnk_consultant_id 8706
    lnk_date.lnk_yyyy 2525
    lnk_date.lnk_mm 1
    lnk_date.lnk_dd 1
    lnk_time_slot 5

    The client application then resumes execution, and pauses on the move 256 to wsc-srvc-faultcode-len statement.

  5. Switch back to the Debug view.
  6. Press F6 multiple times to step through the code until you have stepped just past the call "InvokeService03" statement and into schedule.cbl.
  7. On the Debug view, expand entries under all Application Thread entries. You should see that the deployed schedule application is now being accessed from Enterprise Server.
  8. Press F8 to resume and terminate execution.

Rerun the COBOL Client

Here you rerun the client, selecting the other operation to see that the appointment has been made.

  1. In the Debug view, right-click the MakeCheckAppt-app.dll entry marked as <terminated>; then select Relaunch from the context menu.
  2. In the Debug view, right-click the bottom-most entry; then select Resume.
  3. Complete the runm fields as follows:
    Service Address leave blank
    Username leave blank
    Password leave blank
    Operation 2
    lnk_customer_name Benton Riley
    lnk_consultant_id 8706
    lnk_date.lnk_yyyy 2525
    lnk_date.lnk_mm 1
    lnk_date.lnk_dd 1

    The client application then resumes execution, and pauses on the move 256 to wsc-srvc-faultcode-len statement.

  4. Press F6 multiple times to step through the code until the appointment you set appears on the list in the runm client. You should see it on line [00005] because it is the fifth appointment set for that day.
  5. From the Debug view, press F8 to resume and terminate execution.

This concludes the IMTK REST Web Service tutorial.