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

302 lines
10 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Work with Job Schedule Entries (WRKJOBSCDE)</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="WRKJOBSCDE.Top_Of_Page"></a>
<h2>Work with Job Schedule Entries (WRKJOBSCDE)</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="#WRKJOBSCDE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKJOBSCDE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKJOBSCDE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKJOBSCDE"></a>
<p>The Work with Job Schedule Entries (WRKJOBSCDE) command allows you to work with an entry, entries, or generic entries in the job schedule. Each job schedule entry contains the information needed to automatically submit a batch job once or at regularly scheduled intervals.
</p>
<p>This command shows the Work with Job Schedule Entries display. From the display, you can select options to add, change, remove, hold, or release entries. You can display details of an entry, or work with the last job submitted for an entry. You can also select an option to immediately submit a job using the information contained in the job schedule entry.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>To use this command, you must have:
<ul>
<li>Use (*USE) authority to object QDFTJOBSCD, type *JOBSCD, in library QUSRSYS and execute (*EXECUTE) authority to library QUSRSYS.
</li>
</ul>
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKJOBSCDE.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="#WRKJOBSCDE.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#WRKJOBSCDE.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKJOBSCDE.PRTFMT"><b>PRTFMT</b></a></td>
<td valign="top">Print format</td>
<td valign="top"><b><u>*BASIC</u></b>, *FULL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKJOBSCDE.SEQ"><b>SEQ</b></a></td>
<td valign="top">Sequence</td>
<td valign="top"><b><u>*JOB</u></b>, *DATETIME, *JOBQ</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKJOBSCDE.SCDBY"><b>SCDBY</b></a></td>
<td valign="top">Scheduled by user</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKJOBSCDE.SBMDATE"><b>SBMDATE</b></a></td>
<td valign="top">Submit date</td>
<td valign="top"><i>Date</i>, <b><u>*ALL</u></b>, *CURRENT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#WRKJOBSCDE.JOBQ"><b>JOBQ</b></a></td>
<td valign="top">Job queue</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKJOBSCDE.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the job name of the job schedule entries with which you want to work.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All job schedule entries matching this command's other parameter values are shown on the display.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the job schedule entry. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all entries with job names that begin with the generic name are displayed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete job name.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job schedule entry you want to display.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJOBSCDE.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 for interactive jobs or printed with the job's spooled output for non-interactive jobs.
</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="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJOBSCDE.PRTFMT"></a>
<h3>Print format (PRTFMT)</h3>
<p>Specifies the format used for the printed output.
</p>
<dl>
<dt><b><u>*BASIC</u></b></dt>
<dd>The entries are printed in an abbreviated list format.
</dd>
<dt><b>*FULL</b></dt>
<dd>The details of each entry are printed in an expanded format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJOBSCDE.SEQ"></a>
<h3>Sequence (SEQ)</h3>
<p>Specifies the order in which the selected entries are shown.
</p>
<dl>
<dt><b><u>*JOB</u></b></dt>
<dd>Entries are shown in alphabetical order by job name. Within a job name the entries are ordered by entry number from lowest to highest.
</dd>
<dt><b>*DATETIME</b></dt>
<dd>Entries are ordered by the date and time at which their jobs are scheduled to be submitted, with the earliest entries shown first. Entries that do not have a job scheduled to be submitted are shown last.
</dd>
<dt><b>*JOBQ</b></dt>
<dd>The entries are grouped under the name of the job queue to which their jobs are submitted. The job queues are shown in alphabetical order. Within a job queue, entries are shown in alphabetical order.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJOBSCDE.SCDBY"></a>
<h3>Scheduled by user (SCDBY)</h3>
<p>Specifies the name of the user who added the entry to be shown.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Entries added by all users are shown.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user who added the entries to be shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJOBSCDE.SBMDATE"></a>
<h3>Submit date (SBMDATE)</h3>
<p>Specifies the date on which the entries to be shown submit jobs to run.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All job schedule entries are shown, regardless of the date on which the entries are to submit a job to run.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The entries scheduled to submit jobs on the current date are shown.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the submit date for the entries to be shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKJOBSCDE.JOBQ"></a>
<h3>Job queue (JOBQ)</h3>
<p>Specifies the name of the job queue to which the jobs are submitted. This parameter is used to display all entries that submit jobs to a specified job queue.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown, regardless of the job queues.
</dd>
</dl>
<p><b>Qualifier 1: Job queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job queue.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the thread's library list are searched until a match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the job queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKJOBSCDE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
WRKJOBSCDE JOBQ(QGPL/QBATCH)
</pre>
</p>
<p>This command shows all the job schedule entries that submit a job to the job queue QBATCH in library QGPL.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKJOBSCDE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1628</b></dt>
<dd>Job schedule entry &amp;3 number &amp;4 not found.
</dd>
<dt><b>CPF1629</b></dt>
<dd>Not authorized to job schedule &amp;1.
</dd>
<dt><b>CPF1630</b></dt>
<dd>Not authorized to job schedule entry &amp;3 number &amp;4.
</dd>
<dt><b>CPF1632</b></dt>
<dd>Job schedule entry &amp;3 number &amp;4 damaged.
</dd>
<dt><b>CPF1637</b></dt>
<dd>Job schedule &amp;1 in library &amp;2 in use.
</dd>
<dt><b>CPF1638</b></dt>
<dd>Job schedule entry &amp;3 number &amp;4 in use.
</dd>
<dt><b>CPF1640</b></dt>
<dd>Job schedule &amp;1 in library &amp;2 does not exist.
</dd>
<dt><b>CPF1641</b></dt>
<dd>Job schedule &amp;1 in library &amp;2 damaged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKJOBSCDE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>