146 lines
8.9 KiB
HTML
146 lines
8.9 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="concept" />
|
|
<meta name="DC.Title" content="iSeries System Debugger components" />
|
|
<meta name="abstract" content="The components of the iSeries System Debugger work together to provide a powerful debugging tool." />
|
|
<meta name="description" content="The components of the iSeries System Debugger work together to provide a powerful debugging tool." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzamqmain.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzamqprintthis.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzamqinstall.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzamqrunning.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004,2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004,2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rzamqcomponents" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>iSeries System Debugger
|
|
components</title>
|
|
</head>
|
|
<body id="rzamqcomponents"><a name="rzamqcomponents"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1"><span class="keyword">iSeries</span> System Debugger
|
|
components</h1>
|
|
<div><p>The components of the <span class="keyword">iSeries™</span> System
|
|
Debugger work together to provide a powerful debugging tool.</p>
|
|
<p>IBM<sup>®</sup> <span class="keyword">iSeries</span> System Debugger consists of
|
|
the following components:</p>
|
|
<ul><li>Client-based<ul><li><a href="#rzamqcomponents__debugmanager">Debug Manager</a></li>
|
|
<li><a href="#rzamqcomponents__systemdebugger">System Debugger</a></li>
|
|
<li><a href="#rzamqcomponents__os400pasesystemdebugger">i5/OS PASE System Debugger</a></li>
|
|
</ul>
|
|
</li>
|
|
<li>Host-based<ul><li><a href="#rzamqcomponents__debughub">Debug Hub</a></li>
|
|
<li><a href="#rzamqcomponents__debugserver">Debug Server</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p>The following descriptions provide only general information about the <span class="keyword">iSeries</span> System Debugger components.
|
|
To learn more about the components, run <span class="keyword">iSeries</span> System
|
|
Debugger, and from any <span class="keyword">iSeries</span> System
|
|
Debugger window, click <span class="uicontrol">Help</span>. For more information about
|
|
running <span class="keyword">iSeries</span> System Debugger,
|
|
see <a href="rzamqrunning.htm#runningiseriessystemdebugger">Running iSeries System Debugger</a>.</p>
|
|
<div class="section" id="rzamqcomponents__debugmanager"><a name="rzamqcomponents__debugmanager"><!-- --></a><h4 class="sectiontitle">Debug Manager</h4><p>Debug Manager registers
|
|
the client with the Debug Hub, which enables using the graphical debugging
|
|
mode for the selected systems. A registered client that issues the Start Debugging
|
|
(STRDBG) CL command from an emulation session starts System Debugger.</p>
|
|
<p>Use
|
|
Debug Manager to manage your debugging operations and connections:</p>
|
|
<ul><li>Add and remove systems</li>
|
|
<li>Add and remove users</li>
|
|
<li>Start debugging operations</li>
|
|
<li>Start System Debugger and <span class="keyword">i5/OS™</span> PASE
|
|
System Debugger</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section" id="rzamqcomponents__systemdebugger"><a name="rzamqcomponents__systemdebugger"><!-- --></a><h4 class="sectiontitle">System Debugger</h4><p>Use System Debugger
|
|
to debug programs written in ILE and OPM languages and Java™ that
|
|
run on the <span class="keyword">iSeries</span> server.
|
|
You can debug programs that are running in existing jobs on the server or
|
|
use System Debugger to open and then debug programs in a system batch job.</p>
|
|
<p>You
|
|
can configure System Debugger to start automatically, manually from a workstation
|
|
command prompt, or by using the Debug Manager interface.</p>
|
|
<p>Use System
|
|
Debugger to perform debugging activities that include:</p>
|
|
<ul><li>Setting breakpoints</li>
|
|
<li>Stepping through programs</li>
|
|
<li>Inspecting variables</li>
|
|
<li>Examining the callstack</li>
|
|
<li>Examining memory associated with program variables</li>
|
|
<li>Examining thread activity</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section" id="rzamqcomponents__os400pasesystemdebugger"><a name="rzamqcomponents__os400pasesystemdebugger"><!-- --></a><h4 class="sectiontitle"><span class="keyword">i5/OS</span> PASE
|
|
System Debugger</h4><p>Use <span class="keyword">i5/OS</span> PASE
|
|
Debugger to debug programs that run in an <span class="keyword">i5/OS</span> PASE
|
|
environment. You can debug programs that are running in an existing process
|
|
on the system or use <span class="keyword">i5/OS</span> PASE
|
|
Debugger to open and then debug a program.</p>
|
|
<p>You can start <span class="keyword">i5/OS</span> PASE
|
|
Debugger directly from the command line or by using the Debug Manager interface.</p>
|
|
<p>In
|
|
addition to the debugging activites listed previously for System Debugger,
|
|
you can use <span class="keyword">i5/OS</span> PASE
|
|
Debugger to perform <span class="keyword">i5/OS</span> PASE-specific
|
|
debugging activities that include:</p>
|
|
<ul><li>Using the program loadmap to debug</li>
|
|
<li>Viewing a list of source files and methods</li>
|
|
<li>Tracking parent and child processes</li>
|
|
<li>Examining registers</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section" id="rzamqcomponents__debughub"><a name="rzamqcomponents__debughub"><!-- --></a><h4 class="sectiontitle">Debug Hub</h4><p>Debug Hub provides the following
|
|
functions:</p>
|
|
<ul><li>Serves as a registry for clients that want to use System Debugger or <span class="keyword">i5/OS</span> PASE Debugger</li>
|
|
<li>Handles incoming requests for starting debug servers</li>
|
|
</ul>
|
|
<p>Use the Debug Manager interface to register your client with Debug
|
|
Hub. Registering a client stores both the user information and the TCP/IP
|
|
address of the client in the registry. Using the Start Debugging (STRDBG)
|
|
CL command from an emulation session contacts Debug Hub to see if the user
|
|
executing the command is registered with Debug Manager. It also checks to
|
|
see if the command being executed is from the same TCP/IP addess as Debug
|
|
Manager. If these qualifications are met, <span class="keyword">iSeries</span> System
|
|
Debugger (the graphical application) is started instead of the traditional
|
|
debug environment.</p>
|
|
<p>Debug Hub also serves as a single point of contact
|
|
for all <span class="keyword">iSeries</span> System Debugging
|
|
applications. When an <span class="keyword">iSeries</span> System
|
|
Debugger component performs a start debug operation, Debug Hub submits a Debug
|
|
Server job on behalf of the user and passes the associated TCP/IP connection
|
|
to the job.</p>
|
|
</div>
|
|
<div class="section" id="rzamqcomponents__debugserver"><a name="rzamqcomponents__debugserver"><!-- --></a><h4 class="sectiontitle">Debug Server</h4><p>Debug Server is a
|
|
TCP/IP server that is started by the Debug Hub when one of the debuggers issues
|
|
a request to start debugging. The server job then services the job that is
|
|
being debugged and issues the appropriate debugging APIs and commands.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzamqmain.htm" title="IBM iSeries System Debugger provides a graphical user debugging environment on the iSeries server. Use iSeries System Debugger to debug and test programs that run on your iSeries server, including programs written in ILE and OPM languages, Java, and programs that run in the i5/OS PASE environment.">iSeries System Debugger</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rzamqinstall.htm" title="Before installing iSeries System Debugger on your workstation, you must meet some hardware and software requirements.">Installing iSeries System Debugger</a></div>
|
|
<div><a href="rzamqrunning.htm" title="Start the iSeries System Debugger components using these instructions.">Running iSeries System Debugger</a></div>
|
|
</div>
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="rzamqprintthis.htm" title="Use this to view and print a PDF of this information.">Printable PDF</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |