Debug View for IMS MPP
The Debug view provides information about the debug session and controls for forwarding progress of the debug session. The Debug view gives information about the call path that execution has followed to the current location. The information, which is derived from the call stack using a methodology that depends on standard z/OS linkage conventions, may include CSECT, load module, label, line number, address, and offset. If the information presented does not appear accurate, ensure that standard z/OS linkage conventions were followed.
Debug View Options
Button | Description |
Varies | The launch configuration used to launch the current debug session. Along with an icon that varies, the name of the configuration along with the type of the configuration (such as Xpediter CICS Debug Session) appear in name [type] format. |
| The system on the mainframe that you chose in the launch configuration. The debug session is currently connected to this system. |
| The thread of execution and the current status of your debug session. |
| A stack frame representing a called routine/program within execution. The call stack is presented in chronological order, with the current stack frame on top and the least recently called stack on the bottom. As much information as possible is given for each stack frame. The top stack frame displays the current line number that execution is at. If a line number is shown for any other stack frame, it is the line number that a call was made within that given stack frame. Important To show IBM system modules in the call stack, in the Debug view, click |
, then select Xpediter>Show System Modules. Alternatively, from the Xpediter Preferences page, select the Show system modules in the call stack check box. By default, system modules are not shown.Debug view toolbar
Xpediter/Eclipse provides debugging controls in the Debug view’s toolbar. Each control is enabled depending on which item is selected in the Debug view.
Button | Description |
| Remove all Terminated Launches - Click to clear out all terminated launches from the Debug view. It is only enabled when terminated launches exist in the Debug view. |
| Resume - Click to continue execution. This button is only enabled when a system, thread, or stack frame item is selected and program execution is suspended. |
| Terminate - Click to end your debug session. This button is enabled for any item selected but will be disabled for terminated sessions. Clicking it when any item is selected terminates your debug session. |
| Step Into - Click to step into the call and step line-by-line through it. When execution is stopped at a CALL statement, Step Into places the execution pointer at the first statement within the CALL. When execution is stopped at a non-CALL statement, Step Into performs a Step Over. Notes for Xpediter/TSO: To perform a Step Into, execution must be stopped on a statement that invokes an external module and the external module must have a separate, available associated DDIO member. Calls to dynamically-loaded modules are honored only in COBOL and only if DYNTRAP hasn’t been set OFF in Xpediter/TSO. Calls to statically-linked modules are honored only if the STATIC option hasn’t been set OFF in Xpediter/TSO. |
| Step Over - Click to execute the call but not step line-by-line through it. If the program is suspended on a COBOL PERFORM paragraph/section, clicking this button will cause the paragraph/section to be executed but not stepped through line-by-line. If a breakpoint is encountered or an abend occurs before execution reaches the return point, execution stops at that breakpoint/abend instead. This button is only enabled when a thread or stack frame item is selected and program execution is suspended. |
| Step Return - Click to return to the program that invoked the current program and place the execution pointer at the next available statement after the calling sequence. If a breakpoint is encountered or an abend occurs before execution reaches the return point, execution stops at that breakpoint/abend instead. If there is no calling program in the current context, performing a Step Return ends the debug session. Notes for Xpediter/TSO: If Code Coverage is active, Xpediter will not step return to a program if these is a possibility that such an operation could activate collection for a new program. |
| Review Step Backward - Directs Xpediter to go 1 step backward. |
| Review Step Forward - Directs Xpediter to go 1 step forward. |
| Review Resume Backward - Directs Xpediter to go backward to the next breakpoint or to the point where monitoring started. |
| Review Resume Forward - Directs Xpediter to go forward to the next breakpoint or to the current line of execution. |
| Exit with Abend - Click to request that the step terminate with a particular abend code. Specifying Unnnn causes a USER ABEND nnnn code to be used, while specifying Snnn causes a SYSTEM ABEND nnn code to be used. |
| View Abend-AID Report - Click to display an Abend-AID Snapshot report containing context-sensitive diagnostic information about an abend. If no abend is present, the Snapshot report displays environment-specific run-time characteristics during a test session. If you have the Abend-AID VSAM, IDMS, IMS, or DB2 options, the report also displays subsystem-related debugging information. |
Related topic