309 lines
13 KiB
HTML
309 lines
13 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>Work with Job Logs (WRKJOBLOG)</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="WRKJOBLOG.Top_Of_Page"></a>
|
|
<h2>Work with Job Logs (WRKJOBLOG)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#WRKJOBLOG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#WRKJOBLOG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#WRKJOBLOG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="WRKJOBLOG"></a>
|
|
<p>The Work with Job Logs (WRKJOBLOG) command displays a list of job logs that match the specified selection criteria.
|
|
</p>
|
|
<p><b>Usage notes:</b>
|
|
</p>
|
|
<ul>
|
|
<li>Pending job logs may change to spooled job logs while the Work with Job Logs panel is shown.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKJOBLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="WRKJOBLOG.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="#WRKJOBLOG.JOBLOGSTT"><b>JOBLOGSTT</b></a></td>
|
|
<td valign="top">Job log state</td>
|
|
<td valign="top">Values (up to 2 repetitions): <b><u>*PENDING</u></b>, *SPOOLED</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#WRKJOBLOG.PERIOD"><b>PERIOD</b></a></td>
|
|
<td valign="top">Time period</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="7">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Start time and date</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Beginning time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Beginning date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*CURRENT</u></b>, *BEGIN</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: End time and date</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*CURRENT</u></b>, *END</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#WRKJOBLOG.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top"><i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999, <b><u>*ALL</u></b></td>
|
|
</tr></table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKJOBLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="WRKJOBLOG.JOBLOGSTT"></a>
|
|
<h3>Job log state (JOBLOGSTT)</h3>
|
|
<p>Specifies the state of the job log for selecting which job logs are shown. A maximum of two values can be specified for this parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PENDING</u></b></dt>
|
|
<dd>Job logs for all completed jobs that have a pending job log and that meet the other selection criteria are included in the list.
|
|
</dd>
|
|
<dt><b>*SPOOLED</b></dt>
|
|
<dd>Job log spooled files that meet the other selection criteria are included in the list. This includes job logs that have been detached from the job.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKJOBLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKJOBLOG.PERIOD"></a>
|
|
<h3>Time period (PERIOD)</h3>
|
|
<p>Specifies the period of time for selecting which job logs are shown. For pending job logs and spooled job logs which are associated with a job, this is the completion time of the job. For spooled job logs that are detached from the job, this is the creation date and time of the QPJOBLOG spooled file. This parameter contains two element lists of two elements each. A value or *N must be specified for an element if a subsequent element value will be specified in order to maintain its position in the parameter value sequence.
|
|
</p>
|
|
<p><b>Element 1: Start time and date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Starting time</b>
|
|
</p>
|
|
<p>One of the following is used to specify the starting time at which or after which the job completed or the spooled file was created. Job logs for jobs that ended before the specified time and date are not shown. Detached job logs that were created before the specified time and date are not shown.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
|
<dd>Any job logs that are available for the specified starting date are shown.
|
|
</dd>
|
|
<dt><b><i>start-time</i></b></dt>
|
|
<dd>Specify the starting time for the specified starting date. The time is specified in 24-hour format and can be specified with or without a time separator:
|
|
<ul>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (<b>hhmm</b> or <b>hhmmss</b>) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Hours, minutes, and seconds must each be exactly 2 digits. Use leading zeros if necessary. Valid values for <b>hh</b> range from 00 through 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 through 59.
|
|
</li>
|
|
<li>With a time separator, specify a string of 5 or 8 digits and characters where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Starting date</b>
|
|
</p>
|
|
<p>One of the following is used to specify the starting date on which or after which the job completed or the spooled file was created. Job logs for jobs that ended before the specified time and date are not shown. Detached job logs that were created before the specified time and date are not shown.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The current day is used as the starting date.
|
|
</dd>
|
|
<dt><b>*BEGIN</b></dt>
|
|
<dd>Any job logs that meet the other selection criteria are shown. When *BEGIN is specified for the starting date, a starting time value other than *AVAIL is ignored.
|
|
</dd>
|
|
<dt><b><i>start-date</i></b></dt>
|
|
<dd>Specify the starting date with or without date separators. The date must be entered in the date format that this job uses, as specified in the date format job attribute. If date separators are used then they need to be the same as the date separator that this job uses, as specified in the date separator job attribute. If you enter this command from the command line, the starting date string must be enclosed in apostrophes if it contains separators. If a date separator other than the separator specified for your job is used, this command will fail.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: End time and date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Ending time</b>
|
|
</p>
|
|
<p>One of the following is used to specify the ending time before which the job completed or the spooled file was created. Job logs for jobs that ended after the specified time and date are not shown. Detached job logs that were created after the specified time and date are not shown.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
|
<dd>Any job logs that are available for the specified ending date are shown.
|
|
</dd>
|
|
<dt><b><i>end-time</i></b></dt>
|
|
<dd>Specify the ending time for the specified ending date. See <b>start-time</b> for the formats in which time can be entered.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Ending date</b>
|
|
</p>
|
|
<p>One of the following is used to specify the ending date before which the job completed or the spooled file was created. Job logs for jobs that ended after the specified time and date are not shown. Detached job logs that were created after the specified time and date are not shown.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The current day is used as the ending date.
|
|
</dd>
|
|
<dt><b>*END</b></dt>
|
|
<dd>The last day on which jobs completed or spooled job logs were created is used as the end date. If *END is specified, an ending time value other than *AVAIL is ignored.
|
|
</dd>
|
|
<dt><b><i>end-date</i></b></dt>
|
|
<dd>Specify the ending date with or without date separators. The date must be entered in the date format that this job uses, as specified in the date format job attribute. If date separators are used then they need to be the same as the date separator that this job uses, as specified in the date separator job attribute. If you enter this command from the command line, the ending date string must be enclosed in apostrophes if it contains separators. If a date separator other than the separator specified for your job is used, this command will fail.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKJOBLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKJOBLOG.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the qualified job names of jobs whose job logs are to be included in the list.
|
|
</p>
|
|
<p><b>Qualifier 1: Job name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Job logs for all job names with the specified job user name and job number are included.
|
|
</dd>
|
|
<dt><b><i>generic-name</i></b></dt>
|
|
<dd>Specify the generic name of the jobs whose job logs are to be included. A generic name is a character string of one or more characters followed by an asterisk (*). If a generic name is specified, all job logs for jobs with job names that have the same prefix as the generic name are included.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job whose job logs are included.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: User</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Job logs for all job user names with the specified job name and job number are included.
|
|
</dd>
|
|
<dt><b><i>generic-name</i></b></dt>
|
|
<dd>Specify the generic user name of the jobs whose job logs are included. A generic name is a character string of one or more characters followed by an asterisk (*). If a generic name is specified, all job logs for jobs with user names that have the same prefix as the generic name are included.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the user name of the job whose job logs are included.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 3: Number</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Job logs for all job numbers with the specified job name and job user name are included.
|
|
</dd>
|
|
<dt><b><i>000000-999999</i></b></dt>
|
|
<dd>Specify the job number of the job whose job logs are included.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKJOBLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKJOBLOG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Showing All Pending Job Logs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKJOBLOG
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the Work with Job Logs panel, showing a list of all pending job logs for jobs that ended on today's date.
|
|
</p>
|
|
<p><b>Example 2: Showing All Spooled Job Logs With a Generic Job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKJOBLOG JOBLOGSTT(*SPOOLED) JOB(*ALL/*ALL/QPADEV*)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the Work with Job Logs panel, showing a list of all spooled job logs created on today's date for all jobs whose simple job name starts with 'QPADEV'.
|
|
</p>
|
|
<p><b>Example 3: Showing All Pending and Spooled Job Logs For a Specified Period</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKJOBLOG JOBLOGSTT(*PENDING *SPOOLED)
|
|
PERIOD((*AVAIL 11212005) (*AVAIL 11252005))
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the Work with Job Logs panel, showing a list of all pending job logs for jobs that ended during the specified 5 day period, and all spooled job logs that were created during the specified 5 day period.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKJOBLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKJOBLOG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF9871</b></dt>
|
|
<dd>Error occurred while processing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKJOBLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|