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

533 lines
17 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>Merge Form Description (MRGFORMD)</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="MRGFORMD.Top_Of_Page"></a>
<h2>Merge Form Description (MRGFORMD)</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="#MRGFORMD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#MRGFORMD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#MRGFORMD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="MRGFORMD"></a>
<p>The Merge Form Description (MRGFORMD) command merges a spooled output file with a database file containing a form description, which is designed with the Start Advanced Printer Function (STRAPF) command. The output can be spooled for later printing, or can be directed immediately to a printer.
</p>
<p>The Merge Form Description (MRGFORMD) command is part of the IBM Application Development Tools Program, 5722-WDS. For more information on the advanced printer function (APF) tool, refer to the Advanced Printer Function Guide, SC09-1361.
</p>
<p>
<b>Note: </b>Do not precede an entry with an asterisk unless that entry is a "special value" that is shown (on the display itself or in the help information) with an asterisk.
</p>
<h3>Error messages for MRGFORMD</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>APF5101</b></dt>
<dd>Not able to open printer file &amp;1.
</dd>
<dt><b>APF5102</b></dt>
<dd>Error occurred accessing spooled file.
</dd>
<dt><b>APF5104</b></dt>
<dd>Form description not available.
</dd>
<dt><b>APF5105</b></dt>
<dd>Form description not valid.
</dd>
<dt><b>APF5106</b></dt>
<dd>Not authorized to perform requested function.
</dd>
<dt><b>APF5107</b></dt>
<dd>Error occurred on device &amp;3.
</dd>
<dt><b>APF5121</b></dt>
<dd>File &amp;1 in &amp;2 not correct for APF Utility.
</dd>
<dt><b>APF9901</b></dt>
<dd>Error in APF utility.
</dd>
<dt><b>APF9910</b></dt>
<dd>Not able to complete display file I/O operation.
</dd>
<dt><b>APF9911</b></dt>
<dd>Not able to complete data base file I/O operation.
</dd>
<dt><b>APF9912</b></dt>
<dd>Not able to open advanced printer function file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="MRGFORMD.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="#MRGFORMD.FORMD"><b>FORMD</b></a></td>
<td valign="top">Form description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#MRGFORMD.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 2</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="#MRGFORMD.SPLF"><b>SPLF</b></a></td>
<td valign="top">Spool file</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#MRGFORMD.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job name</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: User</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 3: Number</td>
<td valign="top">000000-999999</td>
</tr><tr>
<td valign="top"><a href="#MRGFORMD.SPLNBR"><b>SPLNBR</b></a></td>
<td valign="top">Spooled file number</td>
<td valign="top">1-999999, *ONLY, <b><u>*LAST</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#MRGFORMD.COPIES"><b>COPIES</b></a></td>
<td valign="top">Copies</td>
<td valign="top">1-255, <b><u>*FILE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#MRGFORMD.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Name</i>, <b><u>*FILE</u></b>, *JOB, *SYSVAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#MRGFORMD.SPOOL"><b>SPOOL</b></a></td>
<td valign="top">Spool the data</td>
<td valign="top">*YES, *NO, <b><u>*FILE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#MRGFORMD.OUTQ"><b>OUTQ</b></a></td>
<td valign="top">Output queue</td>
<td valign="top">Single values: <b><u>*FILE</u></b>, *JOB, *DEV<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="#MRGFORMD.FORMTYPE"><b>FORMTYPE</b></a></td>
<td valign="top">Form type</td>
<td valign="top"><i>Character value</i>, <b><u>*FILE</u></b>, *STD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#MRGFORMD.OUTSPLF"><b>OUTSPLF</b></a></td>
<td valign="top">Output spool file</td>
<td valign="top"><i>Name</i>, <b><u>*FRMD</u></b>, '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#MRGFORMD.SCHEDULE"><b>SCHEDULE</b></a></td>
<td valign="top">Spooled output schedule</td>
<td valign="top"><b><u>*FILE</u></b>, *IMMED, *JOBEND, *FILEEND</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#MRGFORMD.JOBD"><b>JOBD</b></a></td>
<td valign="top">Job description</td>
<td valign="top">Single values: *NONE<br>Other values: <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>QBATCH</u></b></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="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="MRGFORMD.FORMD"></a>
<h3>Form description (FORMD)</h3>
<p>Specifies the name of the form description to be used to print a form or to be used in the merge operation.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.FILE"></a>
<h3>File (FILE)</h3>
<p>Specifies the name and library of the file that contains the form description.
</p>
<p>This is a required parameter.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to find the file.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to find the file. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library in which the file will be located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.SPLF"></a>
<h3>Spool file (SPLF)</h3>
<p>Specifies name of the spooled output file that contains the data to be merged with the form description.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No spooled output file is to be specified.
</dd>
<dt><b><i>spool-file-name</i></b></dt>
<dd>Specify the name of the spooled output file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the name of the job that contains the spooled output file to be merged with the form description.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>Specifies that the current job contains the spooled file.
</dd>
<dt><b><i>job name</i></b></dt>
<dd>Specify the name of the job that created the spooled file to be merged. If no job name is given, all jobs currently in the system are searched for the simple job name.
<dl>
<dt><b><i>user</i></b></dt>
<dd>The user name identifies the user profile under which the job is run.
</dd>
<dt><b><i>number</i></b></dt>
<dd>The system assigned job number.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.SPLNBR"></a>
<h3>Spooled file number (SPLNBR)</h3>
<p>Specifies the number of the spooled output file to be merged with the form description.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LAST</u></b></dt>
<dd>Specifies that the last spooled file with the specified name is to be merged with the forms description.
</dd>
<dt><b>*ONLY</b></dt>
<dd>Specifies that only one spooled file has the name specified on the Spool file prompt (SPLF parameter).
</dd>
<dt><b><i>spooled-file-number</i></b></dt>
<dd>Enter the number of the spooled output file to be merged with the form description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.COPIES"></a>
<h3>Copies (COPIES)</h3>
<p>Specifies the number of copies of the merged spooled output file that are to be printed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FILE</u></b></dt>
<dd>The number of copies to print is to be taken from the COPIES value specified for the printer device file (QPAPFPRT).
</dd>
<dt><b><i>number-of-copies</i></b></dt>
<dd>Enter the number of copies of the merged spooled output file to be printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the name of the printer device to be used to print the form or merged output.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FILE</u></b></dt>
<dd>The device used as the printer is to be the same as that specified in the DEV parameter in the printer device file (QPAPFPRT).
</dd>
<dt><b>*SYSVAL</b></dt>
<dd>The device used as the printer is specified through system value QPRTDEV.
</dd>
<dt><b>*JOB</b></dt>
<dd>The device used as the printer is specified through the job's device file.
</dd>
<dt><b><i>device-name</i></b></dt>
<dd>Specify the name of the printer device to be used to print the form or merged output.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.SPOOL"></a>
<h3>Spool the data (SPOOL)</h3>
<p>Specifies whether or not the data is to be spooled.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FILE</u></b></dt>
<dd>The spooled file attribute is to be the same as that used in the printer device file (QPAPFPRT).
</dd>
<dt><b>*YES</b></dt>
<dd>The data is to be spooled.
</dd>
<dt><b>*NO</b></dt>
<dd>The data is not to be spooled.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.OUTQ"></a>
<h3>Output queue (OUTQ)</h3>
<p>Specifies the output queue on which the merged spooled output file is to be placed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u> *FILE</u></b></dt>
<dd>The output queue name is to be the same as that specified in the printer device file (QPAPFPRT).
</dd>
<dt><b>*DEV</b></dt>
<dd>Use the default output queue value associated with the printer specified on the Device prompt (DEV parameter).
</dd>
<dt><b>*JOB</b></dt>
<dd>Use the output queue specified in the job description associated with the job for the spooled output.
</dd>
<dt><b><i>output-queue-name</i></b></dt>
<dd>Enter the name and library of the output queue that is to contain the spooled database output file. The possible library name values are:
</dd>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to find the output queue.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to find the output queue. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library in which the output queue will be located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.FORMTYPE"></a>
<h3>Form type (FORMTYPE)</h3>
<p>Specifies the type of form on which to print the merged spooled output file.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FILE</u></b></dt>
<dd>The merged spooled output file is to be printed on the form type specified in the printer device file (QPAPFPRT).
</dd>
<dt><b>*STD</b></dt>
<dd>The merged spooled output file is to be printed on the standard form type used at your installation.
</dd>
<dt><b><i>form-type</i></b></dt>
<dd>Enter the name of the form type on which the spooled output file is to be printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.OUTSPLF"></a>
<h3>Output spool file (OUTSPLF)</h3>
<p>Specifies the name of the the merged spooled output file on the output queue.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FRMD</u></b></dt>
<dd>The forms description name is to be used as the name of the the merged spooled output file on the output queue.
</dd>
<dt><b><i>output-spool-file-name</i></b></dt>
<dd>Enter the name (10 characters maximum) of the merged spooled output file on the output queue.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.SCHEDULE"></a>
<h3>Spooled output schedule (SCHEDULE)</h3>
<p>Specifies when the merged spooled output file is to be made available to a spool writer.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FILE</u></b></dt>
<dd>The merged spooled output file is to be made available to a spool writer as specified on the Spooled output schedule prompt (SCHEDULE parameter). in the printer device file (QPAPFPRT).
</dd>
<dt><b>*IMMED</b></dt>
<dd>The merged spooled output file is to be made available to a spool writer immediately.
</dd>
<dt><b>*JOBEND</b></dt>
<dd>The merged spooled output file is to be made available to a spool writer when the current job finishes.
</dd>
<dt><b>*FILEEND</b></dt>
<dd>The merged spooled output file is to be made available to a spool writer when the end of the current file is reached.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGFORMD.JOBD"></a>
<h3>Job description (JOBD)</h3>
<p>Specifies the name of the job description to be used to submit the job.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The printing is to be done under the current job description.
</dd>
<dt><b><i>job-description-name</i></b></dt>
<dd>Specify the name and library of the job description to be used to submit the job. The possible library name values are:
</dd>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the job description.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to find the job description. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library in which the job description will be located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="MRGFORMD.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="MRGFORMD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>APF5101</b></dt>
<dd>Not able to open printer file &amp;1.
</dd>
<dt><b>APF5102</b></dt>
<dd>Error occurred accessing spooled file.
</dd>
<dt><b>APF5104</b></dt>
<dd>Form description not available.
</dd>
<dt><b>APF5105</b></dt>
<dd>Form description not valid.
</dd>
<dt><b>APF5106</b></dt>
<dd>Not authorized to perform requested function.
</dd>
<dt><b>APF5107</b></dt>
<dd>Error occurred on device &amp;3.
</dd>
<dt><b>APF5121</b></dt>
<dd>File &amp;1 in &amp;2 not correct for APF Utility.
</dd>
<dt><b>APF9901</b></dt>
<dd>Error in APF utility.
</dd>
<dt><b>APF9910</b></dt>
<dd>Not able to complete display file I/O operation.
</dd>
<dt><b>APF9911</b></dt>
<dd>Not able to complete data base file I/O operation.
</dd>
<dt><b>APF9912</b></dt>
<dd>Not able to open advanced printer function file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGFORMD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>