friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/strrmcrdar.htm

268 lines
9.9 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Start Report Management Cycle (STRRMCRDAR)</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="STRRMCRDAR.Top_Of_Page"></a>
<h2>Start Report Management Cycle (STRRMCRDAR)</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="#STRRMCRDAR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRRMCRDAR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRRMCRDAR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRRMCRDAR"></a>
<p>The Start Report Management Cycle (STRRMCRDAR) command starts the Report Management Cycle (RMC) which manages the movement of report data between disk and optical or tape. This function can be canceled with a controlled cancel option if enough time is allowed to end what it is currently processing.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRRMCRDAR.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="#STRRMCRDAR.PROCESS"><b>PROCESS</b></a></td>
<td valign="top">Process to run</td>
<td valign="top"><b><u>*ALL</u></b>, *MIGRATION, *EXPIRATION</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#STRRMCRDAR.RPTCOL"><b>RPTCOL</b></a></td>
<td valign="top">Report policy</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRRMCRDAR.LOGSTS"><b>LOGSTS</b></a></td>
<td valign="top">Log migration status</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRRMCRDAR.SNDFAILMSG"><b>SNDFAILMSG</b></a></td>
<td valign="top">Send failure message</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRRMCRDAR.USER"><b>USER</b></a></td>
<td valign="top">User to send failure message</td>
<td valign="top"><i>Name</i>, <b><u>QSYSOPR</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRRMCRDAR.SBMJOB"><b>SBMJOB</b></a></td>
<td valign="top">Submit to batch</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRRMCRDAR.JOBD"><b>JOBD</b></a></td>
<td valign="top">Job description</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job description</td>
<td valign="top"><i>Name</i>, <b><u>QRDARS400</u></b></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="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRRMCRDAR.PROCESS"></a>
<h3>Process to run (PROCESS)</h3>
<p>Specifies if the Report Management Cycle (RMC) does migration processing, expiration processing, or both. You may want to separate these functions if you are concerned with how long RMC processing takes. Migration processing only looks at reports or indexes that are on DASD, while expiration processing looks at all reports and indexes. By separating these processes, you can run the expiration process less frequently than the migration process.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Both migration and expiration processing is done.
</dd>
<dt><b>*MIGRATION</b></dt>
<dd>Only migration processing is done.
</dd>
<dt><b>*EXPIRATION</b></dt>
<dd>Only expiration processing is done.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRMCRDAR.RPTCOL"></a>
<h3>Report policy (RPTCOL)</h3>
<p>Specifies the name of the Report Policy to use when the Report Management Cycle is run.
</p>
<p>
<b>Note: </b>If you press the F4 key for this parameter while prompting the command, a list of all the valid entries is presented to you.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All report policies are used. This causes all eligible reports to be managed.
</dd>
<dt><b><i>generic*-policy-name</i></b></dt>
<dd>Specify the generic name of the report policies that RMC should process.
</dd>
<dt><b><i>policy-name</i></b></dt>
<dd>Specify the name of the report policy that RMC is to process. This causes only the eligible reports that specify the named policy to be managed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRMCRDAR.LOGSTS"></a>
<h3>Log migration status (LOGSTS)</h3>
<p>Specifies if RMC should log the status of processes that it is performing.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Log only failures in the job log.
</dd>
<dt><b>*YES</b></dt>
<dd>Log the start and the final status of each process performed in the job log.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRMCRDAR.SNDFAILMSG"></a>
<h3>Send failure message (SNDFAILMSG)</h3>
<p>Specifies if RMC should send a message to notify someone that a migration failure has occurred during RMC processing. This message is only sent on the first failure during the run. Processing does not stop but continues on to the next report. If RMC needs to be ended because of this message, issue a controlled cancel on the RMC job allowing at least 30 minutes. This gives RMC time to finish the report it is migrating before it ends.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Do not send a message.
</dd>
<dt><b>*YES</b></dt>
<dd>Send a message to the user named in the USER parameter when there is a migration or expiration failure.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRMCRDAR.USER"></a>
<h3>User to send failure message (USER)</h3>
<p>Specifies the user who should be notified when SNDFAILMSG is *YES.
</p>
<dl>
<dt><b><u>QSYSOPR</u></b></dt>
<dd>Send the message to the system operator.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user that should receive the message.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRMCRDAR.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specifies if RMC should run in batch or interactively.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>This command should be submitted to run in a different job.
</dd>
<dt><b>*NO</b></dt>
<dd>This command should be run within the current job. If you are entering this command from a terminal, this will prevent you from doing any other work from this terminal session until this command completes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRMCRDAR.JOBD"></a>
<h3>Job description (JOBD)</h3>
<p>Specifies the name of the job description used for the submitted job.
</p>
<p><b>Qualifier 1: Job description</b>
</p>
<dl>
<dt><b><u>QRDARS400</u></b></dt>
<dd>The QRDARS400 job description is used as the job description for the submitted job.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job description used for the job.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the job description name. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the job description name is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRRMCRDAR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
STRRMCRDAR
</pre>
</p>
<p>This command submits a job to batch that starts the Report Management Cycle (RMC), which manages the movement of OnDemand Spool File Archive and AnyStore data between disk and optical or tape. This command example runs both migration and expiration processing for all report migration policies. It logs only failures in the job log and sends no failure messages to any message queues.
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
STRRMCRDAR PROCESS(*MIGRATION) LOGSTS(*YES) SNDFAILMSG(*YES)
USER(QSYSOPR)
</pre>
</p>
<p>This command submits a job to batch that starts Report Management Cycle (RMC) migration processing only. No expiration processing will occur. Both successful and failure status messages will be written to the job log, and if any failure occurs, a failure message will be sent to the QSYSOPR message queue.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRRMCRDAR.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRMCRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink