Starting debug from an emulator session

To start a debugging session from an emulator session:

  1. Start an emulation session to the desired system and sign onto your system.
  2. Start Debug Manager on the workstation.
  3. Select the Debug option for the desired system.
  4. Run the STRDBG command on the emulation session's command line.

    The STRDBG command sends a request containing connection information to the debug hub. The debug hub checks to ensure that the client is registered and verifies the TCP/IP address of the client with the registry. If the client is not registered or the TCP/IP address of the client is different from the values recorded in the registry, the STRDBG command runs as in previous releases (nongraphical mode).

    If the client is registered, the debug hub starts the System Debugger program on the workstation and passes the connection information to the system debugger program that enables a direct connection between the system debugger client and the job that issued the STRDBG command.

    Note that in this environment, the connection is directly between the System Debugger and the serviced job. In the other debugging environments, the debug server job is responsible for providing the debugging services to the requested job.

    Note:To enable starting a graphical debugging session from your emulator, you must select the Debug Manager's Debug option for the desired system. Failure to select this option results in a nongraphical debugging environment.

  5. Create the desired debugging environment, setting breakpoints and monitors as applicable to your situation. Select one of the options to process the program, such as the Resume or Step Into option, to release control of the environment to your emulation session. Then call your program (CALL lib/program) to start the debugging environment.

    Note: To return control of the program, from the emulator to the graphical debugger, enter DSPMODSRC.

  6. Use the various options offered by the System Debugger to debug your program. Refer to the System Debugger overview for more details on the available options.
  7. To end the debugger environment, release control of the debugging environment to your emulation session and enter ENDDBG.

Note: Normally, a informational windows appears upon successfully running a program object or class file unless the emulation session is not servicing a job.