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/prtafpdta.htm

330 lines
11 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>Print AFP Data (PRTAFPDTA)</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="PRTAFPDTA.Top_Of_Page"></a>
<h2>Print AFP Data (PRTAFPDTA)</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="#PRTAFPDTA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTAFPDTA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTAFPDTA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTAFPDTA"></a>
<p>The Print Advanced Function Printer Data (PRTAFPDTA) command prints output received from a System/370 host. This command allows the user to specify the file being printed and the parameters used to control the print operation.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTAFPDTA.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" rowspan="3"><a href="#PRTAFPDTA.FILE"><b>FILE</b></a></td>
<td valign="top">File</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: File</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="#PRTAFPDTA.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTAFPDTA.DEV"><b>DEV</b></a></td>
<td valign="top">Print device</td>
<td valign="top"><i>Name</i>, <b><u>*JOB</u></b>, *SYSVAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTAFPDTA.FORMDF"><b>FORMDF</b></a></td>
<td valign="top">Form definition</td>
<td valign="top">Single values: <b><u>*DEVD</u></b>, *INLINE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Form definition</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="#PRTAFPDTA.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"><a href="#PRTAFPDTA.STRPAGE"><b>STRPAGE</b></a></td>
<td valign="top">Starting page</td>
<td valign="top"><i>Integer</i>, <b><u>1</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTAFPDTA.ENDPAGE"><b>ENDPAGE</b></a></td>
<td valign="top">Ending page</td>
<td valign="top"><i>Integer</i>, <b><u>*END</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTAFPDTA.FIDELITY"><b>FIDELITY</b></a></td>
<td valign="top">Print fidelity</td>
<td valign="top"><b><u>*ABSOLUTE</u></b>, *CONTENT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTAFPDTA.FILE"></a>
<h3>File (FILE)</h3>
<p>Specifies the Advanced Function Printing Data Stream (AFPDS) file to be printed. Only physical files are supported for this command. If you use the Override with Printer File (OVRPRTF) command with PRTAFPDTA, do not override the device type (DEVTYPE parameter).
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: File</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the AFPDS to be printed.
</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 file. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTAFPDTA.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the member that contains the data to be printed.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the database file is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the file member that contains the data to be printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTAFPDTA.DEV"></a>
<h3>Print device (DEV)</h3>
<p>Specifies the printer that prints the file.
</p>
<dl>
<dt><b><u>*JOB</u></b></dt>
<dd>The printer device specified in the job description is used.
</dd>
<dt><b>*SYSVAL</b></dt>
<dd>The value specified in the system value QPRTDEV is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the printer device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTAFPDTA.FORMDF"></a>
<h3>Form definition (FORMDF)</h3>
<p>Specifies the form definition to use when printing the file. A form definition is a resource object that defines the characteristics of the form such as: overlays, position of page data on the form, number of copies of pages, and modification to pages. The form definition is located inline with the file being printed, or in a library.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*DEVD</u></b></dt>
<dd>The device description obtains the name of the form definition being used. If no value is specified, *DEVD is assumed.
</dd>
<dt><b>*INLINE</b></dt>
<dd>The form definition that is inline with the printer file is used.
</dd>
</dl>
<p><b>Qualifier 1: Form definition</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the form definition that must exist in the library named. A maximum of 8 characters can be used.
</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 searched. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTAFPDTA.COPIES"></a>
<h3>Number of copies (COPIES)</h3>
<p>Specifies, for spooled files, the number of copies being printed.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>One copy of the output is printed.
</dd>
<dt><b><i>1-255</i></b></dt>
<dd>Specify the number of copies that are to be printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTAFPDTA.STRPAGE"></a>
<h3>Starting page (STRPAGE)</h3>
<p>Specifies the page on which printing starts. This parameter is used for partial printing of a file.
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>Printing starts on page 1. If the start page is not specified, 1 is assumed.
</dd>
<dt><b><i>integer</i></b></dt>
<dd>Specify the page number on which printing starts.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTAFPDTA.ENDPAGE"></a>
<h3>Ending page (ENDPAGE)</h3>
<p>Specifies the page on which printing ends. This parameter is used for partial printing of a file ending at a specified page number. If both the start page and the end page are specified, the end page must be greater than or equal to the start page. Specifying an end page beyond the end of the actual file does not create an error condition.
</p>
<dl>
<dt><b><u>*END</u></b></dt>
<dd>Printing concludes at the end of the file.
</dd>
<dt><b><i>integer</i></b></dt>
<dd>Specify the page number on which printing ends.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTAFPDTA.FIDELITY"></a>
<h3>Print fidelity (FIDELITY)</h3>
<p>Specifies the degree of exactness required when printing the file.
</p>
<dl>
<dt><b><u>*ABSOLUTE</u></b></dt>
<dd>The job is printed only if the file can be printed exactly as specified by the data stream and external controls.
</dd>
<dt><b>*CONTENT</b></dt>
<dd>Prints the file using all available exception handling.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTAFPDTA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Printing Specific Pages</b>
</p>
<p>
<pre>
PRTAFPDTA FILE(MYLIB/MYFILE) STRPAGE(2) ENDPAGE(6)
</pre>
</p>
<p>This command prints the first member in file MYFILE in library MYLIB starting with page 2 and ending on page 6.
</p>
<p><b>Example 2: Printing Using All Available Exception Handling</b>
</p>
<p>
<pre>
PRTAFPDTA FILE(MYLIB/MYFILE) FORMDF(F10101) FIDELITY(*CONTENT)
</pre>
</p>
<p>This command prints the first member in file MYFILE in library MYLIB using a form definition of F10101 and all available exception handling.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTAFPDTA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF511B</b></dt>
<dd>Data stream not correct for record &amp;2 in file &amp;1.
</dd>
<dt><b>PQT4001</b></dt>
<dd>Data stream not valid in structured field &amp;2 in file &amp;1.
</dd>
<dt><b>PQT4003</b></dt>
<dd>Form definition &amp;2 not found in library.
</dd>
<dt><b>PQT4004</b></dt>
<dd>Starting page number &amp;1 greater than ending page number &amp;2.
</dd>
<dt><b>PQT4006</b></dt>
<dd>Unable to process file &amp;1 because of variable length fields.
</dd>
<dt><b>PQT4007</b></dt>
<dd>Data stream not valid in file &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTAFPDTA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink