ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/stdbg.htm

101 lines
6.4 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="task" />
<meta name="DC.Title" content="Start debug mode" />
<meta name="abstract" content="Debug mode is a special environment in which the testing functions can be used in addition to the normal system functions." />
<meta name="description" content="Debug mode is a special environment in which the testing functions can be used in addition to the normal system functions." />
<meta name="DC.subject" content="STRDBG (Start Debug) command, example, Start Debug (STRDBG) command, testing, debug mode, debugging, testing applications" />
<meta name="keywords" content="STRDBG (Start Debug) command, example, Start Debug (STRDBG) command, testing, debug mode, debugging, testing applications" />
<meta name="DC.Relation" scheme="URI" content="opm.htm" />
<meta name="DC.Relation" scheme="URI" content="addbg.htm" />
<meta name="DC.Relation" scheme="URI" content="prodl.htm" />
<meta name="DC.Relation" scheme="URI" content="dbgile.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgdbg.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/strdbg.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/enddbg.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/rmvpgm.htm" />
<meta name="DC.Relation" scheme="URI" content="../clfinder/finder.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="stdbg" />
<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>Start debug mode</title>
</head>
<body id="stdbg"><a name="stdbg"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Start debug mode</h1>
<div><p>Debug mode is a special environment in which the testing functions
can be used in addition to the normal system functions.</p>
<div class="section"> <p>To begin testing, your program must be put in debug mode. Testing
functions cannot be used outside debug mode. To start debug mode, you must
use the <span class="cmdname">Start Debug (STRDBG)</span> command. In addition to placing
your program in debug mode, the STRDBG command lets you specify certain testing
information such as the programs that are being debugged. Your program remains
in debug mode until an <span class="cmdname">End Debug (ENDDBG)</span> or <span class="cmdname">Remove
Program (RMVPGM)</span> command is encountered or your current routing
step ends.</p>
<p>Note: If the System Debug Manager function in iSeries™ Navigator
has been used to select Debug in order to check the system, then issuing the <span class="cmdname">Start
Debug (STRDBG)</span>) command will cause the graphical interface to be
presented. In this case, whenever one of the users specified in the user
list issues the <span class="cmdname">Start Debug (STRDBG)</span> command, they will
see the iSeries Navigator
System Debug Manager rather than the Command Entry display. If the <span class="cmdname">End
Debug (ENDDBG)</span> command is entered and <em>Debug</em> in the System
Debug Manager is not currently selected, then issuing the <span class="cmdname">Start Debug
(STRDBG)</span> command will again start the system debugger using the
Command Entry display.</p>
<p>The following <span class="cmdname">Start Debug (STRDBG)</span> command
places the job in debug mode and adds program CUS310 as the program to be
debugged.</p>
<pre>STRDBG PGM(CUS310)</pre>
<p>You can use the ILE source debugger to debug OPM programs.
To create OPM programs that contain source debug data, specify the OPTION(*SRCDBG)
parameter or the OPTION(*LSTDBG) parameter on the <span class="cmdname">Create CL Program
(CRTCLPGM)</span> command. The source debug data is actually part of the
program object.</p>
<p>To add OPM programs that get created containing source
debug data to the ILE source debugger, use the Program (PGM) and OPM Source
Level Debug (OPMSRC) parameters on the STRDBG command. To start a debug session
with an OPM program created with source debug data, type: </p>
<pre><span><samp class="codeph">STRDBG PGM(*LIBL/MYOPMPGM) OPMSRC(*YES) DSPMODSRC(*YES)</samp></span></pre>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="addbg.htm">Add programs to debug mode</a></strong><br />
Before you can debug a program, you must put it in debug mode.</li>
<li class="ulchildlink"><strong><a href="prodl.htm">Prevent updates to database files in production libraries</a></strong><br />
You can use files in production libraries while you are in debug mode, and therefore need to prevent the files from being unintentionally updated.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="opm.htm" title="You can debug your OPM programs by using testing functions.">Debug OPM programs</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="dbgile.htm" title="You can debug your ILE programs by using the ILE source debugger.">Debug ILE programs</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/chgdbg.htm">Change Debug (CHGDBG) command</a></div>
<div><a href="../cl/strdbg.htm">Start Debug (STRDBG) command</a></div>
<div><a href="../cl/enddbg.htm">End Debug (ENDDBG) command</a></div>
<div><a href="../cl/rmvpgm.htm">Remove Program (RMVPGM) command</a></div>
<div><a href="../clfinder/finder.htm">CL command finder</a></div>
</div>
</div>
</body>
</html>