244 lines
8.9 KiB
HTML
244 lines
8.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>Debug Session Handler Exit Program</title>
|
|
<!-- 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. -->
|
|
<!-- Begin Header Records ========================================== -->
|
|
<!-- DEBUG1 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
|
|
<!-- at RCHVMW2 on 29 Jan 1999 at 16:05:09 -->
|
|
<!--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>Debug Session Handler Exit Program</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">Reason</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">Program list</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">Number of programs</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Threadsafe: No<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The Debug Session Handler exit program is a user-written program that manages the Integrated Language Environment (ILE) debugger. It determines when the debugger starts, stops, and shows its displays.</p>
|
|
|
|
<p>The name of the program is specified in the SRCDBGPGM parameter of the Start Debug (STRDBG) command. This program is called by the STRDBG command to initialize the user-written debugger, and is called by the End Debug (ENDDBG) command to end it. It is also called by the STRDBG and the Display Module Source (DSPMODSRC) commands to show the Display Module Source display.</p>
|
|
|
|
<p>If a JAVA class file name was specified in the JAVA parameter of the STRDBG command, the Debug Session Handler exit program will be called during debug initialization with a reason of *STARTJAVA. This call will be in addition to a separate call with a *START reason if ILE or OPM programs were also specified in the STRDBG PGM parameter.</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>Reason</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The reason the program was called. Valid reasons include:</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td valign="top"><em>*START</em></td>
|
|
<td valign="top">The program-stop handler should be initialized by the Start Source Debug API if this has not been done. The program list parameter format consists of 30-character entries. See the program list parameter description below.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*STARTJAVA</em></td>
|
|
<td valign="top">The program-stop handler should be initialized by the Start Source Debug API if this has not been done. The program list parameter format consists of JAVA class file names. See the program list parameter description below.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*STOP</em></td>
|
|
<td valign="top">The program-stop handler should be removed by the End Source Debug API.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*DISPLAY</em></td>
|
|
<td valign="top">The debugger should display itself.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*RLSJOB</em></td>
|
|
<td valign="top">The batch job being debugged has been released from the job queue. This is only supported for a debug session handler running in a batch job.</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Program list</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(*)
|
|
|
|
<p>The format of this parameter depends on the value of the reason parameter. If the reason parameter is *START, the program list format is as follows:</p>
|
|
|
|
<p>The list that is to receive a list of ILE or OPM programs to add to the debugger. This list contains the number of program entries, each entry being 30 characters in length. The first 10 characters contain the name of the program. The second 10 characters contain the name of the library where the program is located. The third 10 characters contain the type of object being named and can be *PGM (a callable program) or *SRVPGM (a service program). Each name is left-justified within the field.</p>
|
|
|
|
<p>If the reason parameter is *STARTJAVA, the format is as follows:</p>
|
|
|
|
<p>A list of JAVA class file name entries. For more information see <a href="#HDRJVDSH1">Format of *STARTJAVA Program List Parameter</a>. The number of list entries is contained in the number of programs
|
|
parameter.</p>
|
|
|
|
<p>If the reason parameter is *DISPLAY, the format is as follows:</p>
|
|
|
|
<p>The eight character thread identifier of the current thread. This is valid only if threads debugging is allowed and the Number of programs parameter contains a value of 1.</p>
|
|
|
|
<p>If the reason parameter is *Stop or *RLSJOB, this parameter is not valid.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of programs</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The format of this parameter depends on the value of the reason
|
|
parameter. If the reason parameter is *START or *STARTJAVA, the format is
|
|
as follows:</p>
|
|
|
|
<p>The number of programs stored in the program list parameter.</p>
|
|
|
|
<p>If the reason parameter is *DISPLAY, the format is as follows:</p>
|
|
|
|
<p>The status of the threaded job. This is valid only if threads debugging
|
|
is allowed.</p>
|
|
|
|
<table cellpadding="3">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td valign="top"><em>0</em></td>
|
|
<td valign="top">The job is running and has not been stopped by debug (for example, breakpoint, step, watch, or unmonitored exception).</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>1</em></td>
|
|
<td valign="top">The job is stopped by debug.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>If the reason parameter is *Stop or *RLSJOB, this parameter is not valid.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
<h3><a name="HDRJVDSH1">Format of *STARTJAVA Program List Parameter</a></h3>
|
|
|
|
<p>When the reason parameter is *STARTJAVA the program list parameter contains JAVA class file names. The following table shows the format of the program list parameter for the *STARTJAVA reason. For more information on the fields, see <a href="#HDRJVDSH2">Field Descriptions</a>.</p>
|
|
|
|
<table border width="80%">
|
|
<!-- cols="10 10 20 60" -->
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> The following fields are repeated for each input class file name. The number of programs parameter contains the number of class file names.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Offset to class file name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of class file name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> Following all of the above fields is a string space containing the input class file names.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Class file names</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br><br>
|
|
<h3><a name="HDRJVDSH2">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Class file names.</strong> The class file names that are specified on the STRDBG command.</p>
|
|
|
|
<p><strong>Length of class file name.</strong> The length of the class file name.</p>
|
|
|
|
<p><strong>Offset to class file name.</strong> The offset from the start of the program list parameter to the class file name.</p>
|
|
|
|
<hr>
|
|
Exit Program Introduced: V2R3
|
|
|
|
<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>
|
|
|