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

172 lines
6.4 KiB
HTML
Raw 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>Remove History using JS (RMVHSTJS)</title>
</head>
<body bgcolor="white">
<a name="RMVHSTJS.Top_Of_Page"></a>
<h2>Remove History using JS (RMVHSTJS)</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="#RMVHSTJS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVHSTJS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVHSTJS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVHSTJS"></a>
<p>The Remove History using Job Scheduler (RMVHSTJS) command allows you to remove history from the Advanced Job Scheduler job history file by specifying the amount of history you want to keep or remove. You can specify whether you want to keep a number of job history occurrences or you can remove history entries based on a date range you specify.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVHSTJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVHSTJS.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="#RMVHSTJS.RMVTYPE"><b>RMVTYPE</b></a></td>
<td valign="top">Remove type</td>
<td valign="top"><b><u>*OCCUR</u></b>, *DAYS</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RMVHSTJS.NBROCCUR"><b>NBROCCUR</b></a></td>
<td valign="top">Number of occurrences</td>
<td valign="top">1-999, <b><u>180</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RMVHSTJS.SLTDATE"><b>SLTDATE</b></a></td>
<td valign="top">Select dates</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: From date</td>
<td valign="top">
<i>Character value</i>, *CURRENT, <b><u>*BEGIN</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: To date</td>
<td valign="top">
<i>Character value</i>, <b><u>180</u></b>, *CURRENT, *END</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVHSTJS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVHSTJS.RMVTYPE"></a>
<h3>Remove type (RMVTYPE)</h3>
<p>Specifies how entries are to be selected from the Advanced Job Scheduler log.
</p>
<dl>
<dt><b><u>*OCCUR</u></b></dt>
<dd>History file entries are kept based on the number of occurrences specified for the <b>Number of occurrences (NBROCCUR)</b> parameter.
</dd>
<dt><b>*DAYS</b></dt>
<dd>History file entries are removed based on a date range specified in the <b>From date</b>and <b>To date</b>fields.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVHSTJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVHSTJS.NBROCCUR"></a>
<h3>Number of occurrences (NBROCCUR)</h3>
<p>Specifies how many occurrences for a job are to be kept in the history file. The number of occurrences begins with the oldest (earliest date) occurrence and progresses to the most recent. Occurrences can range from 1 to 999.
</p>
<dl>
<dt><b><u>180</u></b></dt>
<dd>The number of occurrences for a job to be kept in the file is 180.
</dd>
<dt><b><i>1-999</i></b></dt>
<dd>Specify the number of occurrences for a job that are to be kept in the file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVHSTJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVHSTJS.SLTDATE"></a>
<h3>Select dates (SLTDATE)</h3>
<p>Specifies the range of dates that you want to use when removing Advanced Job Scheduler job history. The <b>From date</b> is the beginning point in the Advanced Job Scheduler history that is removed and the <b>To date</b> is the ending point.
</p>
<p><b>Element 1: From date</b>
</p>
<dl>
<dt><b><u>*BEGIN</u></b></dt>
<dd>Uses the earliest Advanced Job Scheduler history file date in the file as the beginning date in the date range.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>Uses the current date as the beginning date in the date range.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the date in system format with or without date separators, such as 12/01/01 or 120101, that you want to be the beginning date of the date range.
</dd>
<dt><b><i>number</i></b></dt>
<dd>Specify a number to represent the number of days before the current day that you want to be the beginning date of the date range. An example would be 10. If today's date were 3/22/01, the From date for the Advanced Job Scheduler log would be 3/12/01.
</dd>
</dl>
<p><b>Element 2: To date</b>
</p>
<dl>
<dt><b><u>180</u></b></dt>
<dd>The number of days of history that is retained is 180.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The current date is the ending date of the date range.
</dd>
<dt><b>*END</b></dt>
<dd>The latest date in the Advanced Job Scheduler history file is used as the ending date in the date range.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the date in system format with or without date separators, such as 12/01/01 or 120101, that you want to be the ending date of the date range.
</dd>
<dt><b><i>number</i></b></dt>
<dd>Specify a number to represent the number of days before the current day that you want to be the ending date of a date range. An example would be 10. If today's date were 3/22/01, the To date for the Advanced Job Scheduler log would be 3/12/01.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVHSTJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVHSTJS.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RMVHSTJS RMVTYPE(*DAYS) SLTDATE(*BEGIN 60)
</pre>
</p>
<p>This command removes history information that is older than 60 days. The most recent 60 days of history information is kept.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVHSTJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVHSTJS.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVHSTJS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>