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

93 lines
5.8 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="reference" />
<meta name="DC.Title" content="Parameter values used for testing and debugging" />
<meta name="abstract" content="The operating system includes functions that let a programmer observe operations performed as a program runs." />
<meta name="description" content="The operating system includes functions that let a programmer observe operations performed as a program runs." />
<meta name="DC.subject" content="testing function, description, function, testing" />
<meta name="keywords" content="testing function, description, function, testing" />
<meta name="DC.Relation" scheme="URI" content="parameters.htm" />
<meta name="DC.Relation" scheme="URI" content="rbam6progvardes.htm" />
<meta name="DC.Relation" scheme="URI" content="rbam6basingpointerdes.htm" />
<meta name="DC.Relation" scheme="URI" content="rbam6subscriptdes.htm" />
<meta name="DC.Relation" scheme="URI" content="rbam6qualnamedes.htm" />
<meta name="DC.Relation" scheme="URI" content="dbgile.htm" />
<meta name="DC.Relation" scheme="URI" content="opm.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="rbam6probas" />
<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>Parameter values used for testing and debugging</title>
</head>
<body id="rbam6probas"><a name="rbam6probas"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Parameter values used for testing and debugging</h1>
<div><p>The operating system includes functions that let a programmer observe
operations performed as a program runs. </p>
<div class="section"><p>Testing functions can be used to locate operations that are not
performing as intended. These functions can be used in either batch or interactive
jobs from a workstation. In either case, the program being observed must
be in the testing environment, called <em>debug mode</em>.</p>
<p>The testing
functions narrow the search for errors that are difficult to find in the procedure's
source statements. Often, an error is apparent only because the output produced
is not what is expected. To find those errors, you need to be able to stop
the program at a given point (called a <em>breakpoint</em>) and examine variable
information in the program to see if it is correct. You might want to make
changes to those variables before letting the program continue running.</p>
<p>You
do not need to know machine language instructions, nor is there a need to
include special instructions in the program to use the testing functions.
The i5/OS™ testing
functions let you: </p>
<ul><li>Stop a running program at any named point in the program's source statements.</li>
<li>Display information about procedure variables at any point where the program
can be stopped. You can also change the variable information before continuing
procedure processing.</li>
</ul>
<p>This section contains expanded descriptions of the program variable,
basing pointer, subscript, and qualified-name parameter values. These values
can be specified on the <span class="cmdname">Add Breakpoint (ADDBKP)</span>, <span class="cmdname">Add
Trace (ADDTRC)</span>, <span class="cmdname">Change High-Level Language Pointer (CHGHLLPTR)</span>, <span class="cmdname">Change
Program Variable (CHGPGMVAR)</span>, and <span class="cmdname">Display Program Variable
(DSPPGMVAR)</span> commands.</p>
<p>See the appropriate ILE guide for debugging
information with other ILE languages.</p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rbam6progvardes.htm">Program-variable description</a></strong><br />
The topic describes the program-variable description.</li>
<li class="ulchildlink"><strong><a href="rbam6basingpointerdes.htm">Basing-pointer description</a></strong><br />
The topic describes the basing-pointer description.</li>
<li class="ulchildlink"><strong><a href="rbam6subscriptdes.htm">Subscript description</a></strong><br />
The topic describes the subscript description.</li>
<li class="ulchildlink"><strong><a href="rbam6qualnamedes.htm">Qualified-name description</a></strong><br />
The topic describes the qualified-name description.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="parameters.htm" title="A parameter is a value that is passed to a command or program to provide user input or control the actions of the command or program.">Parameters</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><a href="opm.htm" title="You can debug your OPM programs by using testing functions.">Debug OPM programs</a></div>
</div>
</div>
</body>
</html>