ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dspdbg.htm

122 lines
4.1 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Display Debug (DSPDBG)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="DSPDBG.Top_Of_Page"></a>
<h2>Display Debug (DSPDBG)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#DSPDBG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPDBG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPDBG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPDBG"></a>
<p>The Display Debug (DSPDBG) command shows the current status of debug mode. It shows:
</p>
<ul>
<li>The call stack, indicating which programs are currently being debugged
</li>
<li>The instruction number of the calling instruction or the instruction number of each breakpoint at which a program is stopped
</li>
<li>The program recursion level
</li>
</ul>
<p>Programs that are in debug mode but have not been called are also shown.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You can use this command only in debug mode. To start debug mode, refer to the Start Debug (STRDBG) command.
</li>
<li>You cannot use this command if you are servicing another job, and that job is on a job queue, or is being held, suspended, or ended.
</li>
</ul>
<ul>
<li>You cannot use this command to show the procedures of a bound program on the stack. Use the Display Job (DSPJOB) command to show those procedures.
</li>
<li>You cannot use this command to show bound programs that are being debugged.
</li>
<li>You cannot use this command to show unbound programs compiled with the *SRCDBG or *LSTDBG compiler option that are in debug mode initiated with the OPMSRC(*YES) option of the STRDBG command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDBG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPDBG.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#DSPDBG.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional, Positional 1</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPDBG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPDBG.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
</dd>
</dl>
<dl>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDBG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDBG.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DSPDBG
</pre>
</p>
<p>If entered interactively, this command shows the current attributes of debug mode at the display station. Also shown are the breakpoints at which any of the programs being debugged are stopped, the recursion levels of the programs that are currently active, and the names of the programs that have not been called.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDBG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDBG.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDBG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>