236 lines
7.9 KiB
HTML
236 lines
7.9 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">
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
|
<title>Set Debug Attribute (QteSetDebugAttribute) API</title>
|
|
<!-- Begin Header Records ========================================== -->
|
|
<!-- 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. -->
|
|
<!-- DEBUG1 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
|
|
<!-- at RCHVMW2 on 29 Jan 1999 at 16:05:09 -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!--File Edited November 2001 -->
|
|
<!--End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<a name="top_Of_Page"></a>
|
|
<!-- Java sync-link -->
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
|
</script>
|
|
|
|
<h2>Set Debug Attribute (QteSetDebugAttribute) API</h2>
|
|
|
|
<div class="box" style="width: 60%;">
|
|
<br>
|
|
Required Parameter Group:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
<tr>
|
|
<td align="center" valign="top">1</td>
|
|
<td align="left" valign="top">Debug attribute</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">Attribute value</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">Error code</td>
|
|
<td align="left" valign="top">I/O</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Service Program: QTEDBGS<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: No<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The Set Debug Attribute (QteSetDebugAttribute) API is used to set the attributes of the source debug session.</p>
|
|
|
|
<p>The attributes of the debug session cannot be set unless the job is currently in debug mode. The job is put in debug mode by a call to the Start Source Debug (QteStartSourceDebug) API.</p>
|
|
|
|
<p>The *UPDPROD value on the debug attribute parameter sets the update production files attribute of the debug session.</p>
|
|
|
|
<p>You can use files in production libraries while you are in debug mode. To prevent database files in production libraries from being changed unintentionally, you can specify a value of *NO. Then, only files in test libraries can be opened for updating or adding new records. If you want to open database files in production libraries for updating or adding new libraries, or if you want to delete members from production physical files, you can specify *YES. The initial setting when the Start Source Debug API is issued is *NO. However, this value can be changed at any time while in debug mode.</p>
|
|
|
|
<p>You can use this function with the library list. In the library list for your debug job, you can place a test library before a production library. In the test library, you should have copies of the production files that might be updated by the program being debugged. Then, when the program runs, it uses the files in the test library. Therefore, production files cannot be unintentionally updated.</p>
|
|
|
|
<p>The *OPMSRC value on the debug attribute parameter sets the OPM source debug attribute of the debug session. It is used to enable or disable the OPM source debug support. When this support is enabled, OPM RPG, OPM COBOL, and OPM CL programs can be debugged by using the ILE debug APIs if they were compiled with the *SRCDBG or *LSTDBG option on the following CL commands:</p>
|
|
|
|
<ul>
|
|
<li>Create RPG/400 Program (CRTRPGPGM)<br><br></li>
|
|
|
|
<li>Create COBOL Program (CRTCBLPGM)<br><br></li>
|
|
|
|
<li>Create Control language Program (CRTCLPGM)<br><br></li>
|
|
|
|
<li>Create SQL RPG Program (CRTSQLRPG)<br><br></li>
|
|
|
|
<li>Create SQL COBOL Program (CRTSQLCBL)<br><br></li>
|
|
|
|
<li>Create Auto Report RPG Program (CRTRPTPGM)</li>
|
|
</ul>
|
|
|
|
<p>The initial value of the *OPMSRC attribute is set by the Start Debug (STRDBG) command, and can also be changed by the Change Debug (CHGDBG) command. Changing the *OPMSRC value has no effect on programs that are already under debug. They remain in the debug environment (ILE or OPM) that they are currently added to.</p>
|
|
|
|
<br>
|
|
<!-- Please NOTE: DO NOT DELETE THIS SECTION if this API has no authorities and locks. -->
|
|
<!-- Instead, use the commented out coding below to indicate NONE. -->
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<!-- Use this if there are no authorities and locks. -->
|
|
<p>None.</p>
|
|
|
|
<br>
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Debug attribute</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The name of the debug session that is to be set. The value of the debug attribute must be:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td valign="top"><em>*UPDPROD</em></td>
|
|
<td valign="top">Set the value of the update production files attribute.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*OPMSRC</em></td>
|
|
<td valign="top">Set the value of the OPM source debug attribute.</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Attribute value</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The value of the attribute specified in the debug attribute parameter.</p>
|
|
|
|
<p>When the debug attribute parameter specifies *UPDPROD, the attribute value parameter can have one of the following values:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td valign="top"><em>*YES</em></td>
|
|
<td valign="top">Allow the updating of production files while in debug mode.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*NO</em></td>
|
|
<td valign="top">Do not allow the updating of production files while in debug mode.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>When the debug attribute parameter specifies *OPMSRC, the attribute value parameter can have one of the following values:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td valign="top"><em>*YES</em></td>
|
|
<td valign="top">Allow OPM programs that have source debug data to be debugged by using the ILE debug APIs.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*NO</em></td>
|
|
<td valign="top">Do not allow OPM programs to be debugged by using the ILE debug APIs.</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Error code</strong></dt>
|
|
|
|
<dd>I/O; CHAR(*)
|
|
|
|
<p>The structure in which to return error information. For the format of the structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
<h3>Error Messages</h3>
|
|
|
|
<table width="100%" cellpadding="3">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<th align="left" valign="top">Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3CF1 E</td>
|
|
<td valign="top">Error code parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3CF2 E</td>
|
|
<td valign="top">Error(s) occurred during running of &1 API.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9541 E</td>
|
|
<td valign="top">Not in debug mode.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9549 E</td>
|
|
<td valign="top">Error addressing API parameter.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9550 E</td>
|
|
<td valign="top">Value for debug attribute not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9559 E</td>
|
|
<td valign="top">Debug attribute parameter not valid.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<hr>
|
|
API introduced: V3R1
|
|
|
|
<hr>
|
|
<center>
|
|
<table cellpadding="2" cellspacing="2">
|
|
<tr align="center">
|
|
<td valign="middle" align="center">
|
|
<a href="#top_Of_Page">Top</a> |
|
|
<a href="debug1.htm">Debugger APIs</a> |
|
|
<a href="aplist.htm">APIs by category</a></td>
|
|
</tr>
|
|
</table>
|
|
</center>
|
|
|
|
<br>
|
|
</body>
|
|
</html>
|
|
|