284 lines
12 KiB
HTML
284 lines
12 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>Retrieve Cleanup (RTVCLNUP)</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="RTVCLNUP.Top_Of_Page"></a>
|
||
|
|
<h2>Retrieve Cleanup (RTVCLNUP)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#RTVCLNUP.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RTVCLNUP.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RTVCLNUP.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RTVCLNUP"></a>
|
||
|
|
<p>The Retrieve Cleanup (RTVCLNUP) command retrieves a cleanup operation value for use in a CL or REXX program. The value is returned (copied) to the specified CL variable in the program.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RTVCLNUP.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="#RTVCLNUP.ALWCLNUP"><b>ALWCLNUP</b></a></td>
|
||
|
|
<td valign="top">CL var for ALWCLNUP (4)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.STRTIME"><b>STRTIME</b></a></td>
|
||
|
|
<td valign="top">CL var for STRTIME (10)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.USRMSG"><b>USRMSG</b></a></td>
|
||
|
|
<td valign="top">CL var for USRMSG (5)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.SYSMSG"><b>SYSMSG</b></a></td>
|
||
|
|
<td valign="top">CL var for SYSMSG (5)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.CRITSYSMSG"><b>CRITSYSMSG</b></a></td>
|
||
|
|
<td valign="top">CL var for CRITSYSMSG (5)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.SYSPRT"><b>SYSPRT</b></a></td>
|
||
|
|
<td valign="top">CL var for SYSPRT (5)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.SYSLOG"><b>SYSLOG</b></a></td>
|
||
|
|
<td valign="top">CL var for SYSLOG (5)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.JOBQ"><b>JOBQ</b></a></td>
|
||
|
|
<td valign="top">CL var for JOBQ name (10)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.JOBQLIB"><b>JOBQLIB</b></a></td>
|
||
|
|
<td valign="top">CL var for JOBQ library (10)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.RUNPTY"><b>RUNPTY</b></a></td>
|
||
|
|
<td valign="top">CL var for RUNPTY (2 0)</td>
|
||
|
|
<td valign="top"><i>Decimal number</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.JRNRCVSIZ"><b>JRNRCVSIZ</b></a></td>
|
||
|
|
<td valign="top">CL var for JRNRCVSIZ (7 0)</td>
|
||
|
|
<td valign="top"><i>Decimal number</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVCLNUP.CALITM"><b>CALITM</b></a></td>
|
||
|
|
<td valign="top">CL var for CALITM (5)</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RTVCLNUP.ALWCLNUP"></a>
|
||
|
|
<h3>CL var for ALWCLNUP (4) (ALWCLNUP)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the allow cleanup value. The variable named has a minimum length of 4 characters. A '*YES' is returned if the cleanup operation is allowed to run. Otherwise, an '*NO' is returned.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.STRTIME"></a>
|
||
|
|
<h3>CL var for STRTIME (10) (STRTIME)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the time cleanup starts each day. The variable named has a minimum length of 10 characters. A special value of '*NONE' or '*SCDPWROFF,' or the start time is returned.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.USRMSG"></a>
|
||
|
|
<h3>CL var for USRMSG (5) (USRMSG)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the value for cleaning up user messages on user profile message queues. The variable named has a minimum length of 5 characters. The special value *KEEP or the number of days user messages are kept before they are deleted is returned.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.SYSMSG"></a>
|
||
|
|
<h3>CL var for SYSMSG (5) (SYSMSG)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the value for cleaning up messages on the QSYSOPR message queue and on work station message queues. The variable named has a minimum length of 5 characters. The special value *KEEP or the number of days system messages are kept before they are deleted is returned.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.CRITSYSMSG"></a>
|
||
|
|
<h3>CL var for CRITSYSMSG (5) (CRITSYSMSG)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the value for cleaning up messages on the QSYSMSG message queue. The variable named has a minimum length of 5 characters. The special value *KEEP or the number of days critical system messages are kept before they are deleted is returned.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.SYSPRT"></a>
|
||
|
|
<h3>CL var for SYSPRT (5) (SYSPRT)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the value for cleaning up job logs and other system output. The variable named has a minimum length of 5 characters. The special value *KEEP or the number of days job logs are kept before they are deleted is returned.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.SYSLOG"></a>
|
||
|
|
<h3>CL var for SYSLOG (5) (SYSLOG)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the value for cleaning up system journals, history files, problem log files, alert database, and program temporary fixes. The variable named has a minimum length of 5 characters. The special value *KEEP or the number of days system journals and system logs are kept before they are deleted is returned.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.JOBQ"></a>
|
||
|
|
<h3>CL var for JOBQ name (10) (JOBQ)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the name of the job queue to which the cleanup batch jobs are submitted. The variable named has a minimum length of 10 characters. The name of the job queue under which cleanup batch jobs are run is returned.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.JOBQLIB"></a>
|
||
|
|
<h3>CL var for JOBQ library (10) (JOBQLIB)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the library name of the job queue to which the cleanup batch jobs are submitted. The variable named has a minimum length of 10 characters.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.RUNPTY"></a>
|
||
|
|
<h3>CL var for RUNPTY (2 0) (RUNPTY)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the 2-digit value, ranging from 1 through 99, that is the run (or processing) priority for routing steps that are part of the job. For additional information on run priority, refer to this parameter description in the CHGJOB (Change Job) command. The variable must be a 2-digit decimal variable specified with no decimal positions.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.JRNRCVSIZ"></a>
|
||
|
|
<h3>CL var for JRNRCVSIZ (7 0) (JRNRCVSIZ)</h3>
|
||
|
|
<p>Specifies the name of the CL variable that receives the value for the journal receiver size ranging from 1 through 1,919,999 (KB). When the size of the space for the journal receiver is larger than the size specified by this value, Operational Assistant (OA) automatic cleanup function will detach it. The variable must be an 7-digit decimal variable specified with no decimal positions.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVCLNUP.CALITM"></a>
|
||
|
|
<h3>CL var for CALITM (5) (CALITM)</h3>
|
||
|
|
<p>In V5R1 and later releases, this parameter is not supported.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RTVCLNUP.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Retrieving Number of Days Messages are Kept</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DCL VAR(&UMSGDAYS) TYPE(*CHAR) LEN(5)
|
||
|
|
RTVCLNUP USRMSG(&UMSGDAYS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>These commands retrieve the number of days that user messages are kept before being deleted.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Retrieving Time Cleanup Operation Starts</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DCL VAR(&CLNUPTIME) TYPE(CHAR) LEN(10)
|
||
|
|
RTVCLNUP STRTIME(&CLNUPTIME)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>These commands retrieve the time that the cleanup operation starts.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Retrieving Run Priority</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DCL VAR(&RPTY) TYPE(*DEC) LEN(2 0)
|
||
|
|
RTVCLNUP RUNPTY(&RPTY)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command retrieves the run priority for the cleanup job. The run priority number is copied into the CL variable &RPTY. The variable must be a 2-digit decimal variable with no decimal positions.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Retrieving Journal Receiver Size</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DCL VAR(&JRNSIZ) TYPE(*DEC) LEN(7 0)
|
||
|
|
RTVCLNUP JRNRCVSIZ(&JRNSIZ)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command retrieves the journal receiver size for the cleanup job. The journal receiver size is copied into the CL variable &JRNSIZ. The variable must be a 7-digit decimal variable with no decimal positions.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RTVCLNUP.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF1E2B</b></dt>
|
||
|
|
<dd>Power scheduler and cleanup options not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1E33</b></dt>
|
||
|
|
<dd>Cleanup options or power schedule in use by another user.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1E99</b></dt>
|
||
|
|
<dd>Unexpected error occurred.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVCLNUP.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|