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

363 lines
12 KiB
HTML
Raw Permalink 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 from OnDemand (PRTRPTOND)</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="PRTRPTOND.Top_Of_Page"></a>
<h2>Print Report from OnDemand (PRTRPTOND)</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="#PRTRPTOND.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTRPTOND.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTRPTOND.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTRPTOND"></a>
<p>The Print Report from OnDemand (PRTRPTOND) command prints the specified report in its entirety.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTRPTOND.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="#PRTRPTOND.APPGRP"><b>APPGRP</b></a></td>
<td valign="top">Application group</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#PRTRPTOND.RPTID"><b>RPTID</b></a></td>
<td valign="top">Report ID</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#PRTRPTOND.PRINTER"><b>PRINTER</b></a></td>
<td valign="top">Printer</td>
<td valign="top"><i>Name</i>, *OUTQ</td>
<td valign="top">Required, Positional 3</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTRPTOND.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="#PRTRPTOND.INSTANCE"><b>INSTANCE</b></a></td>
<td valign="top">Instance</td>
<td valign="top"><i>Character value</i>, <b><u>QUSROND</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTRPTOND.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="#PRTRPTOND.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="#PRTRPTOND.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="#PRTRPTOND.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>QOND400</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>QRDARS</u></b>, *LIBL, *CURLIB</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTRPTOND.APPGRP"></a>
<h3>Application group (APPGRP)</h3>
<p>Specifies the name of the application group that contains the report to be printed.
</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 the valid entries is presented to you. The entries listed may not be valid if the parameter INSTANCE is not QUSROND.
</p>
<p>If the value to be entered contains lower case letters, blanks, or special characters, it must be enclosed in apostrophes.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTOND.RPTID"></a>
<h3>Report ID (RPTID)</h3>
<p>Specifies the report ID of the report to be printed.
</p>
<p>The report ID is in the form of "1220-1-0-8FAA-9939-9345", where the "1220" is the internal application group identifier, "1" is the primary storage node, "0" is the secondary storage node, "8FAA" is a counter, "9339" is the first (internal) date in the report file and "9345" is the last (internal) date in the report file. The report ID is also known as the load ID.
</p>
<p>
<b>Note: </b>The report id can be found in the system log file.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTOND.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="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTOND.OUTQ"></a>
<h3>Output queue (OUTQ)</h3>
<p>Specify the qualified name of the output queue that is used to receive the spooled report. This output queue must be defined as a printer within the OnDemand instance.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*JOB</u></b></dt>
<dd>The output queue associated with this job receives the spooled report.
</dd>
</dl>
<p><b>Qualifier 1: Output queue</b>
</p>
<dl>
<dt><b><i>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="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTOND.INSTANCE"></a>
<h3>Instance (INSTANCE)</h3>
<p>Specifies the name of the instance to use.
</p>
<dl>
<dt><b><u>QUSROND</u></b></dt>
<dd>The default OnDemand instance is used.
</dd>
<dt><b><i>instance-name</i></b></dt>
<dd>Specify the name of the instance that is to be used. By definition, the instance must be on the system that the command is run.
</dd>
<dt><b><i>library-server-name</i></b></dt>
<dd>Specify the TCP/IP host name of the library server. The name can also be specified as a TCP/IP dotted decimal address in the form of nnn.nnn.nnn.nnn.
<p>When a server name or TCP/IP address is entered, OnDemand uses the instance on that server that is using the default port. In most cases, this will also use the default instance.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTOND.COPIES"></a>
<h3>Number of copies (COPIES)</h3>
<p>Specifies the number of copies to print.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTOND.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="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTOND.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="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTRPTOND.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>QOND400</u></b></dt>
<dd>The QOND400 job description is used as the job description for the submitted job.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name (name/name) of the job description used for the job.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>QRDARS</u></b></dt>
<dd>Library QRDARS is used as the job description's library.
</dd>
<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 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="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTRPTOND.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
PRTRPTOND APPGRP(CHECKSTMTS) RPTID('1220-1-0-8FAA-9939-9345')
PRINTER(*OUTQ) OUTQ(QGPL/PRT01)
</pre>
</p>
<p>This command submits a job to batch to reprint a spooled file from the OnDemand Common Server application group called CHECKSTMTS with a load id (also known as report id) as shown. The command assumes the archived data is stored in the QUSROND instance since no instance name was specified. The reprinted output is directed to the PRT01 output queue.
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
PRTRPTOND APPGRP(CHECKSTMTS) RPTID('1220-1-0-8FAA-9939-9345')
PRINTER(*OUTQ)OUTQ(QGPL/PRT01) INSTANCE(ACCTING)
SBMJOB(*NO)
</pre>
</p>
<p>This command is similar to Example 1 but runs interactively and specifies an instance name.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTRPTOND.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>OND0251</b></dt>
<dd>PRTRPTOND ended in error. The report was not printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>