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

76 lines
4.6 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="Equate a name with a variable, expression, or command" />
<meta name="abstract" content="You can use the EQUATE debug command to equate a name with a variable, expression or debug command for shorthand use." />
<meta name="description" content="You can use the EQUATE debug command to equate a name with a variable, expression or debug command for shorthand use." />
<meta name="DC.subject" content="variable, equating a name, expression, command, equating a name" />
<meta name="keywords" content="variable, equating a name, expression, command, equating a name" />
<meta name="DC.Relation" scheme="URI" content="dbgile.htm" />
<meta name="DC.Relation" scheme="URI" content="dbpgm.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="equat" />
<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>Equate a name with a variable, expression, or command</title>
</head>
<body id="equat"><a name="equat"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Equate a name with a variable, expression, or command</h1>
<div><p>You can use the EQUATE debug command to equate a name with a variable,
expression or debug command for shorthand use. </p>
<div class="section"> <p>You can then use that name alone or within another expression.
If you use it within another expression, the value of the name is
determined before the expression is evaluated. These names stay active until
a debug session ends or a name is removed.</p>
<p>To equate a name with a variable,
expression or debug command, type the following on the debug command line:
</p>
<pre>EQUATE shorthand-name definition</pre>
<p><span class="synph"><span class="var">shorthand-name</span></span> is the name that you
want to equate with a variable, expression, or debug command, and <span class="synph"><span class="var">definition</span></span> is
the variable, expression, or debug command that you are equating with the
name.</p>
<p>For example, to define a shorthand name called <span class="synph"><span class="var">DC</span></span> that
displays the contents of a variable called <span class="synph"><span class="var">&amp;COUNTER</span></span>,
type the following on the debug command line: </p>
<pre>EQUATE DC EVAL &amp;COUNTER</pre>
<p>Now, each time <span class="synph"><span class="var">DC</span></span> is typed on the
debug command line, the command EVAL <span class="synph"><span class="var">&amp;COUNTER</span></span> is
performed.</p>
<p>The maximum number of characters that can be typed in an
EQUATE command is 144. If a definition is not supplied and a previous EQUATE
command defined the name, the previous definition is removed. If the name
was not previously defined, an error message is shown.</p>
<p>To see the names
that have been defined with the EQUATE debug command for a debug session,
type the following on the debug command line: </p>
<pre>DISPLAY EQUATE</pre>
<p>A list of the active names is shown on the Evaluate Expression
display.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <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="relconcepts"><strong>Related concepts</strong><br />
<div><a href="dbpgm.htm" title="Many debug commands are available for use with the ILE source debugger.">Debug commands</a></div>
</div>
</div>
</body>
</html>