ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzalf_5.4.0.1/rzalfdebug.htm

86 lines
5.8 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="Debug your i5/OS PASE programs" />
<meta name="abstract" content="The i5/OS PASE runtime environment provides library support for the syslog() runtime function, and a syslogd binary (for more sophisticated message routing). In addition, you can use existing facilities in i5/OS, such as job logs for diagnostic messages and sending severe messages to the i5/OS system operator message queue, QSYSOPR." />
<meta name="description" content="The i5/OS PASE runtime environment provides library support for the syslog() runtime function, and a syslogd binary (for more sophisticated message routing). In addition, you can use existing facilities in i5/OS, such as job logs for diagnostic messages and sending severe messages to the i5/OS system operator message queue, QSYSOPR." />
<meta name="DC.Relation" scheme="URI" content="rzalfintro.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzamq/rzamqmain.htm" />
<meta name="DC.Relation" scheme="URI" content="../sc092712.pdf" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2000, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2000, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzalfdebug" />
<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>Debug your i5/OS PASE
programs</title>
</head>
<body id="rzalfdebug"><a name="rzalfdebug"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Debug your <span class="keyword">i5/OS</span> PASE
programs</h1>
<div><p>The <span class="keyword">i5/OS™</span> PASE
runtime environment provides library support for the syslog() runtime function,
and a <tt>syslogd</tt> binary (for more sophisticated message routing). In
addition, you can use existing facilities in <span class="keyword">i5/OS</span>,
such as job logs for diagnostic messages and sending severe messages to the <span class="keyword">i5/OS</span> system operator message queue,
QSYSOPR.</p>
<p>Depending on the application, your strategy for debugging an <span class="keyword">i5/OS</span> PASE
application can take different paths:</p>
<ul><li>If the application does not require any <span class="keyword">i5/OS</span> integration
(for instance, with DB2<sup>®</sup> UDB for iSeries™ or with ILE functions), you should
first debug the application on AIX<sup>®</sup>.</li>
<li>Then, you use a combination of <span class="keyword">i5/OS</span> PASE <tt>dbx</tt> and <span class="keyword">i5/OS</span> debug capabilities (such as
job logs) to debug the application on <span class="keyword">i5/OS</span>.</li>
</ul>
<p>Applications that you have coded to use database or ILE functions cannot
be fully tested on AIX, but you can debug the remaining parts of the application
on AIX to
assure their proper structure and design.</p>
<div class="section"><h4 class="sectiontitle">Use <tt>dbx</tt> in <span class="keyword">i5/OS</span> PASE</h4><p> <span class="keyword">i5/OS</span> PASE supports the AIX <tt>dbx</tt> debugger
utility. The utility lets you debug related processes, such as parent and
child, at the source code level, if they were compiled as such. You can use
the Network File System (NFS) to make the AIX source visible to the debugger that
runs in <span class="keyword">i5/OS</span> PASE.</p>
<p><span class="keyword">i5/OS</span> PASE support for xterm and
aixterm lets you use <tt>dbx</tt> to debug both the parent and child processes. <tt>dbx</tt> launches
another <tt>xterm</tt> window with <tt>dbx</tt> attached to the second process.</p>
<p>For
details on <tt>dbx</tt>, see the <a href="http://www.ibm.com/servers/aix/library/" target="_blank">AIX documentation</a> Web site. You can also type <kbd class="userinput">help</kbd> on
the <tt>dbx</tt> command line.</p>
</div>
<div class="section"><h4 class="sectiontitle">Use <span class="keyword">i5/OS</span> debugging
tools</h4><div class="p">You can use the following tools on <span class="keyword">i5/OS</span> to
debug your <span class="keyword">i5/OS</span> PASE applications:<ul><li>The iSeries System
Debugger provides specific support for <span class="keyword">i5/OS</span> PASE
application debugging.</li>
<li>The ILE C source debugger is an effective tool for determining problems
with your code.</li>
</ul>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzalfintro.htm" title="IBM i5/OS Portable Application Solutions Environment (i5/OS PASE) allows you to port IBM AIX applications to the IBM iSeries server with minimal effort.">i5/OS PASE</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../rzamq/rzamqmain.htm">iSeries System Debugger</a></div>
<div><a href="../sc092712.pdf" target="_blank">WebSphere Development Studio ILE C/C++ Programmer's Guide PDF</a></div>
</div>
</div>
</body>
</html>