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

88 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="task" />
<meta name="DC.Title" content="Debug batch jobs submitted to a job queue" />
<meta name="abstract" content="Using a separate job to debug another batch job submitted to the job queue allows you to put the batch job into debug mode and to set breakpoints and traces before the job starts to process." />
<meta name="description" content="Using a separate job to debug another batch job submitted to the job queue allows you to put the batch job into debug mode and to set breakpoints and traces before the job starts to process." />
<meta name="DC.subject" content="debugging, batch job submitted to a job queue, batch job, submitted to a job queue, debugging, job queue, debugging batch job submitted to" />
<meta name="keywords" content="debugging, batch job submitted to a job queue, batch job, submitted to a job queue, debugging, job queue, debugging batch job submitted to" />
<meta name="DC.Relation" scheme="URI" content="usejobdg.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/addbkp.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/addtrc.htm" />
<meta name="DC.Relation" scheme="URI" content="../clfinder/finder.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="debugbatch" />
<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>Debug batch jobs submitted to a job queue</title>
</head>
<body id="debugbatch"><a name="debugbatch"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Debug batch jobs submitted to a job queue</h1>
<div><p>Using a separate job to debug another batch job submitted to the
job queue allows you to put the batch job into debug mode and to set breakpoints
and traces before the job starts to process.</p>
<div class="section"> <p> Use the following steps to debug batch jobs to be submitted
to a job queue: </p>
<ol><li>Submit the batch job using the <span class="cmdname">Submit Job (SBMJOB)</span> command
or a program that automatically submits the job with HOLD(*YES). <pre>SBMJOB HOLD(*YES)</pre>
</li>
<li>Determine the qualified job name (number/user/name) that is assigned to
the job using the <span class="cmdname">Work with Submitted Jobs (WRKSBMJOB)</span> command
or the <span class="cmdname">Work with Job Queues (WRKJOBQ)</span> command.
The <span class="cmdname">Submit Job (SBMJOB)</span> command also displays the name
in a completion message when the command finishes processing. <p>The <span class="cmdname">WRKJOBQ
(Work With Job Queue)</span> command displays all the jobs waiting to start
in a particular job queue. You can show the job name from this display by
selecting option 5 for the job.</p>
</li>
<li>Enter the <span class="cmdname">Start Service Job (STRSRVJOB)</span> command from
the display you plan to use to debug the batch job as follows: <pre>STRSRVJOB JOB(qualified-job-name)</pre>
</li>
<li>Enter the STRDBG command and provide the names of all programs to be debugged.
No other debug commands can be entered while the job is waiting on the job
queue.</li>
<li>Use the <span class="cmdname">Release Job Queue (RLSJOBQ)</span> command to release
the job queue. A display appears when the job is ready to start, indicating
that you may begin debugging the job. Press F10 to show the Command Entry
display.</li>
<li>Use the Command Entry display to enter any debug commands, such as the <span class="cmdname">Add
Breakpoint (ADDBKP)</span> or <span class="cmdname">Add Trace (ADDTRC)</span> commands.</li>
<li>Press F3 to leave the Command Entry display, and then press Enter to start
the batch job.</li>
<li>When the job stops at a breakpoint, you see the normal breakpoint display.
When the job finishes, you cannot add breakpoints and traces, or display
or change variables. However, you can display any trace data using the <span class="cmdname">Display
Trace Data (DSPTRCDTA)</span> command.</li>
<li>If you wish to debug another batch job, first end debugging using the <span class="cmdname">End
Debug (ENDDBG)</span> command and then end servicing the job using the <span class="cmdname">End
Servicing Job (ENDSRVJOB)</span> command.</li>
</ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="usejobdg.htm" title="You may want to use a separate job to debug programs running in another job.">Use a job to debug another job</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/addbkp.htm">Add Breakpoint (ADDBKP) command</a></div>
<div><a href="../cl/addtrc.htm">Add Trace (ADDTRC) command</a></div>
<div><a href="../clfinder/finder.htm">CL command finder</a></div>
</div>
</div>
</body>
</html>