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

454 lines
16 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>Reclaim Report for OnDemand (RCLRPTRDAR)</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="RCLRPTRDAR.Top_Of_Page"></a>
<h2>Reclaim Report for OnDemand (RCLRPTRDAR)</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="#RCLRPTRDAR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RCLRPTRDAR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RCLRPTRDAR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RCLRPTRDAR"></a>
<p>The Reclaim Report for OnDemand (RCLRPTRDAR) command reclaims (recovers) the specified report from disk, tape, or optical and optionally re-runs STRCDSRDAR. The reclaimed report is placed in the job's output queue. The RCLRPTRDAR command is only used to recover lost OnDemand reports and should only be used with caution or with assistance from the support center.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RCLRPTRDAR.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="#RCLRPTRDAR.REPORT"><b>REPORT</b></a></td>
<td valign="top">Report name</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.VERSION"><b>VERSION</b></a></td>
<td valign="top">Version</td>
<td valign="top">1-99</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.RPTDATE"><b>RPTDATE</b></a></td>
<td valign="top">Report date</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.RPTSEQ"><b>RPTSEQ</b></a></td>
<td valign="top">Report sequence number</td>
<td valign="top">1-999</td>
<td valign="top">Required, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.FROM"><b>FROM</b></a></td>
<td valign="top">Reclaim report from</td>
<td valign="top">*DASD, *OPTICAL, *TAPE, *TAPEMGR</td>
<td valign="top">Required, Positional 5</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.ACCTYPE"><b>ACCTYPE</b></a></td>
<td valign="top">Default optical volume type</td>
<td valign="top"><b><u>*HFS</u></b>, *RDARLAN</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#RCLRPTRDAR.OPTVOL"><b>OPTVOL</b></a></td>
<td valign="top">Optical volume</td>
<td valign="top">Values (up to 10 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Name</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Library</td>
<td valign="top">
<i>Name</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Type</td>
<td valign="top">
<b><u>*ACCTYPE</u></b>, *HFS, *RDARLAN</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.TAPDEV"><b>TAPDEV</b></a></td>
<td valign="top">Tape device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.MLB"><b>MLB</b></a></td>
<td valign="top">Media device library</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">Tape sequence number</td>
<td valign="top">1-9999, <b><u>*SEARCH</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.TAPVOL"><b>TAPVOL</b></a></td>
<td valign="top">Tape volume</td>
<td valign="top">Values (up to 10 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.ENDOPT"><b>ENDOPT</b></a></td>
<td valign="top">End of tape option</td>
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.AUTOSTORE"><b>AUTOSTORE</b></a></td>
<td valign="top">Automatically store reports</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RCLRPTRDAR.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="#RCLRPTRDAR.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="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RCLRPTRDAR.REPORT"></a>
<h3>Report name (REPORT)</h3>
<p>Specifies the name of the report to reclaim.
</p>
<p>This is a required parameter.
</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>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.VERSION"></a>
<h3>Version (VERSION)</h3>
<p>Specifies which version of the report should be reclaimed. This value must be between 01 and 99.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.RPTDATE"></a>
<h3>Report date (RPTDATE)</h3>
<p>The report date can be found in the QPRLRCDS printer file from STRCDSRDAR or on the OnDemand displays which show the report date for a given report.
</p>
<p>Specify a date using the format YYYYMMDD where YYYY represents the year, MM the month, and DD the day. Do not use any type of special characters to separate year, month, and day values.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.RPTSEQ"></a>
<h3>Sequence number (RPTSEQ)</h3>
<p>Specifies the report sequence number for the report to be reclaimed. This value must be between 001 and 999.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.FROM"></a>
<h3>Reclaim report from (FROM)</h3>
<p>Specifies where the report should be reclaimed from.
</p>
<dl>
<dt><b>*DASD</b></dt>
<dd>The report is reclaimed from disk.
</dd>
<dt><b>*OPTICAL</b></dt>
<dd>The report is reclaimed from the optical volumes specified in the OPTVOL parameter.
</dd>
<dt><b>*TAPE</b></dt>
<dd>The report is reclaimed from the tape volumes specified in the TAPVOL parameter.
</dd>
<dt><b>*TAPEMGR</b></dt>
<dd>The report is reclaimed from tape using an external tape manager such as BRMS.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.ACCTYPE"></a>
<h3>Default optical volume type (ACCTYPE)</h3>
<p>Specify the optical volume type to use as the default.
</p>
<dl>
<dt><b><u>*HFS</u></b></dt>
<dd>Use the operating system's optical support. Specify this for all optical libraries (direct or LAN attached) unless it is known that OnDemand LAN optical support was used to archive the report to optical.
</dd>
<dt><b>*RDARLAN</b></dt>
<dd>Use the OnDemand LAN optical support. Use this only if it is known that OnDemand LAN optical support was used to archive the report to optical.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.OPTVOL"></a>
<h3>Optical volume (OPTVOL)</h3>
<p>Specifies the identifiers of up to ten optical volumes containing the report to be reclaimed.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p><b>Element 1: Name</b>
</p>
<dl>
<dt><b><i>identifier</i></b></dt>
<dd>Specify the volume identifier of the optical volume.
</dd>
</dl>
<p><b>Element 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the optical library name that contains the optical volume. This parameter is only needed when the ACCTYPE parameter is *RDARLAN or when the <b>Type</b> element is *RDARLAN.
</dd>
</dl>
<p><b>Element 3: Type</b> Specify the type of optical volume.
</p>
<dl>
<dt><b><u>*ACCTYPE</u></b></dt>
<dd>Use the value specified in the ACCTYPE parameter.
</dd>
<dt><b>*HFS</b></dt>
<dd>Use the operating system's optical support. Specify this for all optical libraries unless it is known that OnDemand LAN optical support was used to archive the report to optical.
</dd>
<dt><b>*RDARLAN</b></dt>
<dd>Use the OnDemand LAN optical support. Use this only if it is known that OnDemand LAN optical support was used to archive the report to optical.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.TAPDEV"></a>
<h3>Tape device (TAPDEV)</h3>
<p>Specifies the name of the tape device used for the reclaim.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.MLB"></a>
<h3>Media device library (MLB)</h3>
<p>Specifies the name of the media device library that the tape device specified for the <b>Tape device (TAPDEV)</b> parameter is located in. This parameter should only be used when the tape device is located in a media device library.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.SEQNBR"></a>
<h3>Tape sequence number (SEQNBR)</h3>
<p>Specifies the tape sequence number of the report to reclaim.
</p>
<dl>
<dt><b><u>*SEARCH</u></b></dt>
<dd>The tape is searched for the report, when a match is found, the report is reclaimed. If the last operation on the tape unit specified *LEAVE for the <b>End of tape (ENDOPT)</b>parameter, indicating that the tape is positioned at the location where the last operation ended, the file search starts with the first report beyond the current tape position. If *LEAVE was not used for the End of tape option prompt (ENDOPT parameter) of the last operation or if the tape was manually rewound since the operation, the search starts with the first report on the volume.
</dd>
<dt><b><i>file-sequence-number</i></b></dt>
<dd>Specify the sequence number of the file used for the reclaim report operation.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.TAPVOL"></a>
<h3>Tape volume (TAPVOL)</h3>
<p>Specify the volume names of one to ten volumes in the order in which they are to be mounted in the tape device and used to reclaim the report.
</p>
<p>You can enter multiple values for this parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.ENDOPT"></a>
<h3>End of tape option (ENDOPT)</h3>
<p>Specifies, when tape is used, what positioning operation is automatically done on the tape volume after the reclaim operation ends. If more that one tape volume is included, this parameter applies only to the last tape volume used; all other tape volumes are rewound and unloaded when the end of the tape is reached.
</p>
<dl>
<dt><b><u>*REWIND</u></b></dt>
<dd>The tape is automatically rewound, but not unloaded, after the operation has ended.
</dd>
<dt><b>*LEAVE</b></dt>
<dd>The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
</dd>
<dt><b>*UNLOAD</b></dt>
<dd>The tape is automatically rewound and unloaded after the operation ends.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.AUTOSTORE"></a>
<h3>Automatically store reports (AUTOSTORE)</h3>
<p>Specifies if the reclaimed report should also be stored using the Start Coded Data Store (STRCDSRDAR) command.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The reclaimed report is not automatically stored.
</dd>
<dt><b>*YES</b></dt>
<dd>The reclaimed report is stored again using the STRCDSRDAR command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specify if you want to reclaim this report in this current job or in a batch job.
</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="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCLRPTRDAR.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="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RCLRPTRDAR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
RCLRPTRDAR REPORT(CHECKSTMTS) VERSION(01) RPTDATE(20020101)
RPTSEQ(001)FROM(*OPTICAL) OPTVOL((OD0000000012))
</pre>
</p>
<p>This command submits a job to batch to respool a particular OnDemand Spool File Archive archived report named CHECKSTMTS from optical volume OD0000000012. The reclaimed spooled file is placed in the job's output queue. This command is most often used when a problem is encountered with an archived report and the spooled file needs to be rearchived.
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
RCLRPTRDAR REPORT(CHECKSTMTS) VERSION(01) RPTDATE(20020101)
RPTSEQ(001)FROM(*OPTICAL) OPTVOL((OD0000000012))
AUTOSTORE(*YES)SBMJOB(*NO)
</pre>
</p>
<p>This command is similar to Example 1 but runs interactively and automatically stores the reclaimed spooled file back into OnDemand Spool File Archive.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RCLRPTRDAR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1338</b></dt>
<dd>Errors occurred on SBMJOB command.
</dd>
<dt><b>RDR0101</b></dt>
<dd>Processing of STRCDSRDAR failed for &amp;1. Rerun STRCDSRDAR and specify RESTART(&amp;2).
</dd>
<dt><b>RDR0168</b></dt>
<dd>Error was detected for Report &amp;1/&amp;2/&amp;3.&amp;4. The report was not printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCLRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>