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

353 lines
11 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>Print Report for OnDemand (PRTRPTRDAR)</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="PRTRPTRDAR.Top_Of_Page"></a>
<h2>Print Report for OnDemand (PRTRPTRDAR)</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="#PRTRPTRDAR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTRPTRDAR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTRPTRDAR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTRPTRDAR"></a>
<p>The Print Report for OnDemand (PRTRPTRDAR) command prints the specified report in its entirety.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTRPTRDAR.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="#PRTRPTRDAR.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="#PRTRPTRDAR.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="#PRTRPTRDAR.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="#PRTRPTRDAR.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="#PRTRPTRDAR.PRINTER"><b>PRINTER</b></a></td>
<td valign="top">Printer</td>
<td valign="top"><i>Name</i>, *OUTQ</td>
<td valign="top">Required, Positional 5</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTRPTRDAR.OUTQ"><b>OUTQ</b></a></td>
<td valign="top">Output queue</td>
<td valign="top">Single values: <b><u>*JOB</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Output queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#PRTRPTRDAR.COPIES"><b>COPIES</b></a></td>
<td valign="top">Number of copies</td>
<td valign="top">1-255, <b><u>1</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTRPTRDAR.PAGERANGE"><b>PAGERANGE</b></a></td>
<td valign="top">Page range to print</td>
<td valign="top">Single values: *ENDPAGE<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Starting page</td>
<td valign="top">
<i>Integer</i>, <b><u>1</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Ending page</td>
<td valign="top">
<i>Integer</i>, <b><u>*END</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#PRTRPTRDAR.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="#PRTRPTRDAR.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="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTRPTRDAR.REPORT"></a>
<h3>Report name (REPORT)</h3>
<p>Specifies the name of the report to print.
</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="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.VERSION"></a>
<h3>Version (VERSION)</h3>
<p>Specifies which version of the report should be printed. 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="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.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="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.RPTSEQ"></a>
<h3>Sequence number (RPTSEQ)</h3>
<p>Specifies the report sequence number for the report to be printed. 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="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.PRINTER"></a>
<h3>Printer (PRINTER)</h3>
<p>Specifies where the report should be printed.
</p>
<dl>
<dt><b><u>*OUTQ</u></b></dt>
<dd>The report is spooled to the output queue specified on the OUTQ parameter.
</dd>
<dt><b><i>device-name</i></b></dt>
<dd>Specify the name of the device that is used to print the report.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.OUTQ"></a>
<h3>Output queue (OUTQ)</h3>
<p>Specify the qualified name of the output queue that is used to receive the spooled report.
</p>
<p><b>Qualifier 1: Output queue</b>
</p>
<dl>
<dt><b><u>*JOB</u></b></dt>
<dd>The output queue associated with this job receives the spooled report.
</dd>
<dt><b><i>output-queue-name</i></b></dt>
<dd>Specify the name of the output queue to use.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b>*LIBL</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 where the output queue is located. 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 output queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.COPIES"></a>
<h3>Number of copies (COPIES)</h3>
<p>Specifies the number of copies to print or fax.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.PAGERANGE"></a>
<h3>Page range to print (PAGERANGE)</h3>
<p>Specifies the starting and ending pages to print.
</p>
<p><b>Element 1: Starting page</b>
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>Start at page 1 of the report.
</dd>
<dt><b>*ENDPAGE</b></dt>
<dd>Prints only the last page.
</dd>
<dt><b><i>starting-page-number</i></b></dt>
<dd>Specify the starting page to print.
</dd>
</dl>
<p><b>Element 2: Ending page</b>
</p>
<dl>
<dt><b><u>*END</u></b></dt>
<dd>Printing continues until the last page is printed.
</dd>
<dt><b><i>ending-page-number</i></b></dt>
<dd>Specify the last page to print.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specify if you want to print 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="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTRDAR.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="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTRPTRDAR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
PRTRPTRDAR REPORT(CHECKSTMTS) VERSION(01) RPTDATE(20020101)
RPTSEQ(001)PRINTER(*OUTQ) OUTQ(QGPL/PRT01)
</pre>
</p>
<p>This command submits a job to batch to reprint a spooled file from the OnDemand Spool File Archive report definition called CHECKSTMTS with a Version, Date, and Sequence number as shown. The reprinted output is directed to the PRT01 output queue. Note that the output queue specified must be defined as a printer within the OnDemand instance.
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
PRTRPTRDAR REPORT(CHECKSTMTS) VERSION(01) RPTDATE(20020101)
RPTSEQ(001)PRINTER(*OUTQ) OUTQ(QGPL/PRT01)
SBMJOB(*NO)
</pre>
</p>
<p>This command is similar to Example 1 but runs interactively.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTRPTRDAR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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="#PRTRPTRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>