Debug Session Control APIs

Debug session control APIs are used to start the source debug session, determine which programs, modules, and views are referenced, and control certain attributes of the debug environment.

The Debug Session Control APIs are:

• Change Current Thread (QteChangeCurrentThread) changes the current thread to any thread being debugged.
• Change Thread Status (QteChangeThreadStatus) changes the debug status for threads being debugged.
• End Source Debug (QteEndSourceDebug) takes the job out of debug mode.
• Register Service Entry Point Stop Handler (QteRegSrvEntPntStpHdlr) registers a special event handler to handle Service Entry breakpoint events.
• Retrieve Debug Attribute (QteRetrieveDebugAttribute) retrieves the attributes of the source debug session.
• Retrieve Debugged Threads (QteRetrieveDebuggedThreads) retrieves information for threads being debugged.
• Retrieve Module Views (QteRetrieveModuleViews()) returns to the caller the list of modules and views that are associated with a specific ILE or OPM program.
• Retrieve Source Path Name (QteRetrieveSourcePathName) returns the full source path name for a Java source file.
• Set Debug Attribute (QteSetDebugAttribute) sets the attributes of the source debug session.
• Start Source Debug (QteStartSourceDebug()) enables your session to use the source debugger.
• Stop Debugged Job (QteStopDebuggedJob) causes debug to halt all threads being debugged in a job.

Debug session control exit programs are used to process breakpoints and start, stop, and display screens within the source debug session. The debug session control exit programs are:

• Debug Session Handler manages the source debugger, telling it when to start, stop, and display its screens. This program is registered on the Start Debug Command.
• Program Stop Handler is registered on the Start Source Debug API. This program is called by the source debugger support when an ILE or OPM program stops at a breakpoint or for other reasons.
• Service Entry Point Stop Handler is a user-written program that handles the service entry point program-stop condition.