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

474 lines
16 KiB
HTML

<!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 PFD Data (PRTPFDDTA)</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="PRTPFDDTA.Top_Of_Page"></a>
<h2>Print PFD Data (PRTPFDDTA)</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="#PRTPFDDTA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTPFDDTA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTPFDDTA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTPFDDTA"></a>
<p>This command allows you to print a database file member according to the design of a PFD definition.
</p>
<h3>Error messages for PRTPFDDTA</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>AFP0010</b></dt>
<dd>An error occurred.
</dd>
<dt><b>AFP0040</b></dt>
<dd>Database file &amp;2 in library &amp;1 cannot be allocated.
</dd>
<dt><b>AFP22A0</b></dt>
<dd>Print request canceled.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTPFDDTA.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="#PRTPFDDTA.PFDFILE"><b>PFDFILE</b></a></td>
<td valign="top">PFD 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: PFD 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="#PRTPFDDTA.PFDMBR"><b>PFDMBR</b></a></td>
<td valign="top">PFD definition</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTPFDDTA.FILE"><b>FILE</b></a></td>
<td valign="top">Database file</td>
<td valign="top">Single values: <b><u>*PFD</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Database 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="#PRTPFDDTA.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, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPFDDTA.GRID"><b>GRID</b></a></td>
<td valign="top">Include grid</td>
<td valign="top">*YES, <b><u>*NO</u></b>, *YES, <b><u>*NO</u></b></td>
<td valign="top">Optional, Positional 5</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPFDDTA.RCDSLT"><b>RCDSLT</b></a></td>
<td valign="top">Record selection</td>
<td valign="top"><b><u>*YES</u></b>, *NO, <b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional, Positional 6</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPFDDTA.ENDPAGE"><b>ENDPAGE</b></a></td>
<td valign="top">Ending page</td>
<td valign="top">1-9999, <b><u>*END</u></b></td>
<td valign="top">Optional, Positional 7</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPFDDTA.DRAWER"><b>DRAWER</b></a></td>
<td valign="top">Source drawer</td>
<td valign="top">1-255, <b><u>*PFD</u></b>, *E1, *CUT</td>
<td valign="top">Optional, Positional 8</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPFDDTA.OUTBIN"><b>OUTBIN</b></a></td>
<td valign="top">Output bin</td>
<td valign="top">1-65535, <b><u>*DEVD</u></b></td>
<td valign="top">Optional, Positional 9</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPFDDTA.COPIES"><b>COPIES</b></a></td>
<td valign="top">Copies</td>
<td valign="top">1-255, <b><u>*PFD</u></b></td>
<td valign="top">Optional, Positional 10</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#PRTPFDDTA.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, Positional 11</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" rowspan="3"><a href="#PRTPFDDTA.FORMDF"><b>FORMDF</b></a></td>
<td valign="top">Form definition</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 12</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Form definition</td>
<td valign="top"><i>Name</i>, <b><u>*PFD</u></b>, *DEVD, *INLINE</td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTPFDDTA.PFDFILE"></a>
<h3>PFD file (PFDFILE)</h3>
<p>Specifies the PFD definition file and library that contain the PFD definition to be used.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><i>PFD-definition-file-name</i></b></dt>
<dd>Type the name of an existing PFD definition file to be used. If you specify the PFD-definition-file-name and a library name, print format utility searches the specified library for the PFD definition file. If you do not specify a library name, *LIBL is used.
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the file.
</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, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the file resides.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.PFDMBR"></a>
<h3>PFD definition (PFDMBR)</h3>
<p>Specifies the name of the PFD definition to be used to print a database file member.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>This is the default value. The first PFD definition in the PFD definition file is used.
</dd>
<dt><b><i>PFD-definition-name</i></b></dt>
<dd>Type the name of the PFD-definition you want to use.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.FILE"></a>
<h3>Database file (FILE)</h3>
<p>Specifies the database file and library that contain the member to be printed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*PFD</u></b></dt>
<dd>Specifies that the database file and library that are specified in the PFD definition are used to print the member.
</dd>
<dt><b><i>file-name</i></b></dt>
<dd>Type the name of an existing database file to be used. If you specify the file-name and a library name, print format utility searches the specified library for the database file. If you do not specify a library name, *LIBL is used.
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the file.
</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, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the file resides.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the name of the member to be printed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>This is the default value. The first member in the database file is printed.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Type the name of the member you want to print.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.GRID"></a>
<h3>Include grid (GRID)</h3>
<p>Specifies whether a grid is included in the printout or not. A Grid consists of horizontal lines and vertical lines, and the distance between horizontal lines and that between vertical lines are specified in the PFD specifications.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>This is the default value. A grid is not included in the printout.
</dd>
<dt><b>*YES</b></dt>
<dd>A grid is included in the printout.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.RCDSLT"></a>
<h3>Record selection (RCDSLT)</h3>
<p>Specifies whether the records are selected according to the selection conditions specified in the PFD definition or not.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Type *YES if you want to select and print only those records that match the selection conditions specified in the PFD definition.
<p>All records are printed if no conditions are specified in the PFD definition.
</p>
</dd>
<dt><b>*NO</b></dt>
<dd>Type *NO if you want to print all records regardless of the selection conditions specified in the PFD definition.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.ENDPAGE"></a>
<h3>Ending page (ENDPAGE)</h3>
<p>Specifies whether printing should stop at a certain page or continue until all records are processed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*END</u></b></dt>
<dd>Specifies to print until all records are processed.
</dd>
<dt><b><i>page-number</i></b></dt>
<dd>Specifies the last page number to be printed. Print format utility stops printing when the last page specified by this parameter is printed. If all records have been processed before the last page is printed, print format utility will stop printing.
<p>The possible value range is 1 - 9999.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.DRAWER"></a>
<h3>Drawer (DRAWER)</h3>
<p>Specifies the source drawer used when single-cut sheets are fed into the printer.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*PFD</u></b></dt>
<dd>The value specified in <u> the Printout specifications</u> is used. *PFD is the default.
</dd>
<dt><b>*E1</b></dt>
<dd>Envelopes are fed from the envelope drawer on the sheet-feed paper handler.
</dd>
<dt><b>*CUT</b></dt>
<dd>For printers with manual feed, cut sheets are fed manually through the manual feeder.
</dd>
<dt><b><i>source-drawer</i></b></dt>
<dd>Specify the drawer from which the paper is fed. Valid values range from 1 through 255. For printers with manual feed, specifying 100 is the same as specifying *CUT.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.OUTBIN"></a>
<h3>Output bin (OUTBIN)</h3>
<p>Specifies the destination of the output on printers capable of multiple output bins.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*DEVD</u></b></dt>
<dd>The value specified in <u> the Device description</u> is used. *DEVD is the default.
</dd>
<dt><b><i>output-bin</i></b></dt>
<dd>Specify the output bin for the destination of the output. Valid values range from 1 through 65535.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.COPIES"></a>
<h3>Copies (COPIES)</h3>
<p>Specifies the number of copies to be printed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*PFD</u></b></dt>
<dd>Specifies that the number specified in the PFD definition is used.
<p>This is the default value.
</p>
</dd>
<dt><b><i>number-of-copies</i></b></dt>
<dd>Specifies the number of copies to be printed.
<p>The possible value range is 1 - 255.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.OUTQ"></a>
<h3>Output queue (OUTQ)</h3>
<p>Specifies the qualified name of the output queue in which the spooled file will be created.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*JOB</u></b></dt>
<dd>Specifies the output queue specified in the job description associated with this job is used.
<p>This is the default value.
</p>
</dd>
<dt><b><i>output-queue-name</i></b></dt>
<dd>Specifies the name of the output queue to be used.
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the output queue.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the output queue. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the output queue resides.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPFDDTA.FORMDF"></a>
<h3>Form definition (FORMDF)</h3>
<p>Specifies the qualified name of the form definition to use when printing the spooled file.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*PFD</u></b></dt>
<dd>Specifies that the form definition and library that are specified in the PFD definition will be used to print the member.
</dd>
<dt><b>*DEVD</b></dt>
<dd>Specifies that the form definition specified in the device description for the printer will be used.
</dd>
<dt><b>*INLINE</b></dt>
<dd>Specifies that the print format utility will create an inline form definition with the name F1AFPU and use that form definition when printing the data. The page width and length specified in the printout format definition will be placed in the created form definition for page control with continuous form printers. These values will be used when the page size control value for the printer is set to *YES. Use the Work with PSF Configurations (WRKPSFCFG) command to set the page size control value.
</dd>
<dt><b><i>form-definition-name</i></b></dt>
<dd>Specifies the name of the form definition to be used.
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the form definition.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the form definition. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the form definition resides.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTPFDDTA.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTPFDDTA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>AFP0010</b></dt>
<dd>An error occurred.
</dd>
<dt><b>AFP0040</b></dt>
<dd>Database file &amp;2 in library &amp;1 cannot be allocated.
</dd>
<dt><b>AFP22A0</b></dt>
<dd>Print request canceled.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPFDDTA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>