140 lines
5.3 KiB
HTML
140 lines
5.3 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>Delete Expired Spooled files (DLTEXPSPLF)</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="DLTEXPSPLF.Top_Of_Page"></a>
|
|
<h2>Delete Expired Spooled files (DLTEXPSPLF)</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="#DLTEXPSPLF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DLTEXPSPLF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DLTEXPSPLF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DLTEXPSPLF"></a>
|
|
<p>The Delete Expired Spooled Files (DLTEXPSPLF) command removes expired spooled files on the system or the auxiliary storage pool (ASP) group specified by the user. A spooled file expires at 23:59:59, system local time on the date specified in the <b>Expiration date for file (EXPDATE)</b> spooled file attribute. To automate the removal of expired spooled files, you can create a job schedule entry that runs the DLTEXPSPLF command once a day. See the <b>Examples</b> section for an example using the Add Job Schedule Entry (ADDJOBSCDE) command.
|
|
</p>
|
|
<p><b>Restriction:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You need spool control (*SPLCTL) special authority to use this command. If *ALL or a specific <b>ASP group (ASPGRP)</b> is specified, the user must be authorized to the ASP group and the status of the ASP group must be AVAILABLE.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTEXPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DLTEXPSPLF.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="#DLTEXPSPLF.ASPGRP"><b>ASPGRP</b></a></td>
|
|
<td valign="top">ASP group</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *SYSBAS</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTEXPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DLTEXPSPLF.ASPGRP"></a>
|
|
<h3>ASP group (ASPGRP)</h3>
|
|
<p>Specifies the auxiliary storage pool (ASP) group from which expired spooled files are to be removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Expired spooled files which are found in the system ASP (ASP 1), all defined basic user ASPs (ASPs 2-32) and all primary and secondary ASPs are deleted.
|
|
</dd>
|
|
<dt><b>*SYSBAS</b></dt>
|
|
<dd>Expired spooled files which are found in the system ASP (ASP 1) and all defined basic user ASPs (ASPs 2-32) are deleted.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of a primary ASP group. Expired spooled files which are found in the primary and secondary ASPs of the specified ASP group are deleted.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTEXPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DLTEXPSPLF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Deleting All Expired Spooled Files</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DLTEXPSPLF ASPGRP(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes all expired spooled files on the system.
|
|
</p>
|
|
<p><b>Example 2: Deleting All Expired Spooled Files in the System ASP (ASP 1) and All Defined Basic User ASPs (ASPs 2-32)</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DLTEXPSPLF ASPGRP(*SYSBAS)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes all expired spooled files in the system ASP (ASP 1) and all defined basic user ASPs (ASPs 2-32).
|
|
</p>
|
|
<p><b>Example 3: Creating a Job Schedule Entry to Remove Expired Spooled Files</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDJOBSCDE JOB(DLTEXPSPLF) CMD(DLTEXPSPLF ASPGRP(*ALL))
|
|
FRQ(*WEEKLY) SCDDATE(*NONE) SCDDAY(*ALL)
|
|
SCDTIME(010000) JOBQ(QSYS/QSYSNOMAX)
|
|
TEXT('DELETE EXPIRED SPOOLED FILES SCHEDULE ENTRY')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a job schedule entry which causes the DLTEXPSPLF command to run daily at the time specified in the SCDTIME parameter in the job queue specified in the JOBQ parameter. Using the FRQ(*WEEKLY) and SCDDAY(*ALL) parameters will schedule the job to run every day of the week.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTEXPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DLTEXPSPLF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF3330</b></dt>
|
|
<dd>Necessary resource not available.
|
|
</dd>
|
|
<dt><b>CPF334F</b></dt>
|
|
<dd>Not authorized to command Delete Expired Spooled files (DLTEXPSPLF).
|
|
</dd>
|
|
<dt><b>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
<dt><b>CPFB8E9</b></dt>
|
|
<dd>ASP group &1 not set for thread &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTEXPSPLF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|