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

90 lines
7.2 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="Add programs to debug mode" />
<meta name="abstract" content="Before you can debug a program, you must put it in debug mode." />
<meta name="description" content="Before you can debug a program, you must put it in debug mode." />
<meta name="DC.subject" content="program, placing in debug mode, number that can be debugged simultaneously, number of, programs that can be debugged simultaneously, see='breakpoint'.debug mode, see='trace'.debug mode, see='testing'.debug mode, adding program, placing program, ADDPGM (Add Program) command, Add Program (ADDPGM) command, command, CL, ADDPGM (Add Program), Add Program (ADDPGM), adding, STRDBG (Start Debug) command, Start Debug (STRDBG) command, command, CL, STRDBG (Start Debug), Start Debug (STRDBG), debugging, starting, debug, RMVPGM (Remove Program) command, using, Remove Program (RMVPGM) command, RMVPGM (Remove Program), Remove Program (RMVPGM), removing, testing, default program, default, in testing, CHGDBG (Change Debug) command, Change Debug (CHGDBG) command, CHGDBG (Change Debug), Change Debug (CHGDBG), changing, used in testing" />
<meta name="keywords" content="program, placing in debug mode, number that can be debugged simultaneously, number of, programs that can be debugged simultaneously, see='breakpoint'.debug mode, see='trace'.debug mode, see='testing'.debug mode, adding program, placing program, ADDPGM (Add Program) command, Add Program (ADDPGM) command, command, CL, ADDPGM (Add Program), Add Program (ADDPGM), adding, STRDBG (Start Debug) command, Start Debug (STRDBG) command, command, CL, STRDBG (Start Debug), Start Debug (STRDBG), debugging, starting, debug, RMVPGM (Remove Program) command, using, Remove Program (RMVPGM) command, RMVPGM (Remove Program), Remove Program (RMVPGM), removing, testing, default program, default, in testing, CHGDBG (Change Debug) command, Change Debug (CHGDBG) command, CHGDBG (Change Debug), Change Debug (CHGDBG), changing, used in testing" />
<meta name="DC.Relation" scheme="URI" content="stdbg.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgdbg.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/addpgm.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/strdbg.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="addbg" />
<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>Add programs to debug mode</title>
</head>
<body id="addbg"><a name="addbg"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Add programs to debug mode</h1>
<div><p>Before you can debug a program, you must put it in debug mode.</p>
<div class="section"> <p>Any program can be run in debug mode. You can place
a program in debug mode by specifying it in the PGM parameter on the <span class="cmdname">Start
Debug (STRDBG)</span> command or by adding it to the debugging session
with an <span class="cmdname">Add Program (ADDPGM)</span> command. You can specify as
many as twenty (20) programs to be debugged simultaneously in a job. You must
have *CHANGE authority to add a program to debug mode.</p>
<p>If you specified
twenty (20) programs for debug mode (using either the <span class="cmdname">Start Debug
(STRDBG)</span> or <span class="cmdname">Add Program (ADDPGM)</span> command or both
commands) and you want to add more programs to the debug job, you must remove
some of the previously specified programs. Use the <span class="cmdname">Remove Program
(RMVPGM)</span> command. When debug mode ends, all programs are automatically
removed from debug mode.</p>
<p>When you start debug mode, you can specify
that a program be a default program. By specifying a default program, you
can use any debug command that has the PGM parameter without having to specify
a program name each time a command is used. This is helpful if you are only
debugging one program. For example, in the <span class="cmdname">Add Breakpoint (ADDBKP)</span> command,
you would not specify a program name on the PGM parameter because the default
program is assumed to be the program the breakpoint is being added to. The
default program name must be specified in the list of programs to be debugged
(PGM parameter). If more than one program is listed to be debugged, you can
specify the default program on the DFTPGM parameter. If you do not, the first
program in the list on the PGM parameter on the STRDBG command is assumed
to be the default program.</p>
<p>The default program can be changed any time
during testing by using either the <span class="cmdname">Change Debug (CHGDBG)</span> or
the <span class="cmdname">Add Program (ADDPGM)</span> command. </p>
<div class="note"><span class="notetitle">Note:</span> If a program
that is in debug mode is deleted, recreated, or saved with storage freed,
references made to that program (except a <span class="cmdname">Remove Program (RMVPGM)</span> command)
may result in a function check. You must either remove the program using a
RMVPGM command or end debug mode using an <span class="cmdname">End Debug (ENDDBG)</span> command.
If you want to change the program and then debug it, you must remove it from
debug mode and after it is recreated, add it to debug mode (<span class="cmdname">Add Program
(ADDPGM)</span> command).</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="stdbg.htm" title="Debug mode is a special environment in which the testing functions can be used in addition to the normal system functions.">Start debug mode</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/addpgm.htm">Add Program (ADDPGM) command</a></div>
<div><a href="../cl/strdbg.htm">Start Debug (STRDBG) 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>