235 lines
8.3 KiB
HTML
235 lines
8.3 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>Retrieve Query Management Form (RTVQMFORM)</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="RTVQMFORM.Top_Of_Page"></a>
|
|
<h2>Retrieve Query Management Form (RTVQMFORM)</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="#RTVQMFORM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RTVQMFORM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RTVQMFORM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RTVQMFORM"></a>
|
|
<p>The Retrieve Query Management Form (RTVQMFORM) command allows you to retrieve encoded form source records from a query management form (QMFORM) object. The source records are placed into a source file member that can be edited.
|
|
</p>
|
|
<p>Form source can also be retrieved from a query definition (QRYDFN) object when the specified QMFORM does not exist.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVQMFORM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RTVQMFORM.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="#RTVQMFORM.QMFORM"><b>QMFORM</b></a></td>
|
|
<td valign="top">Query management report form</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: Query management report form</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="#RTVQMFORM.SRCFILE"><b>SRCFILE</b></a></td>
|
|
<td valign="top">Source 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: Source 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="#RTVQMFORM.SRCMBR"><b>SRCMBR</b></a></td>
|
|
<td valign="top">Source member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*QMFORM</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RTVQMFORM.ALWQRYDFN"><b>ALWQRYDFN</b></a></td>
|
|
<td valign="top">Allow information from QRYDFN</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES, *ONLY</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVQMFORM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RTVQMFORM.QMFORM"></a>
|
|
<h3>Query management report form (QMFORM)</h3>
|
|
<p>Specifies the query management form object whose source is being retrieved.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Query management report form</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the form being retrieved.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the form. 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="#RTVQMFORM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVQMFORM.SRCFILE"></a>
|
|
<h3>Source file (SRCFILE)</h3>
|
|
<p>Specifies the previously-created source physical file into which the encoded form source records are to be written.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Source file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the source file that is to receive the form source.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<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="#RTVQMFORM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVQMFORM.SRCMBR"></a>
|
|
<h3>Source member (SRCMBR)</h3>
|
|
<p>Specifies the source physical file member into which the encoded form source records are to be written. If a source file member name is not specified, then the form name specified on the QMFORM parameter is used.
|
|
</p>
|
|
<p>If the member existed before running this command, it is cleared before any source statements are written into it. If the member does not exist, it is created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*QMFORM</u></b></dt>
|
|
<dd>The member name is the same as the form name specified on the QMFORM parameter.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the member to receive the form source.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVQMFORM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVQMFORM.ALWQRYDFN"></a>
|
|
<h3>Allow information from QRYDFN (ALWQRYDFN)</h3>
|
|
<p>Specifies whether form information is taken from a QRYDFN object when a query management form (QMFORM) object cannot be found using the specified object name. Any information that has to be derived in this way is discarded when the command has completed processing. No query management object is created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Information is not taken from a QRYDFN object.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Information is taken from a QRYDFN object when the specified QMQRY object is not found.
|
|
</dd>
|
|
<dt><b>*ONLY</b></dt>
|
|
<dd>Information is taken only from a QRYDFN. Query management objects are ignored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVQMFORM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RTVQMFORM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Retrieving Encoded Form Source</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RTVQMFORM QMFORM(RPTLIB/SALFORM) SRCFILE(FORMS)
|
|
SRCMBR(EMPFORM)
|
|
</pre>
|
|
</p>
|
|
<p>This command retrieves the encoded form source from the form named SALFORM located in the RPTLIB library. The encoded form source records that are retrieved are placed into the newly created or cleared member EMPFORM in the first file named FORMS in the user's library list.
|
|
</p>
|
|
<p><b>Example 2: Retrieving Source From Either the QMFORM or the QRYDFN</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RTVQMFORM QMFORM(RPTLIB/SALFORM) SRCFILE(FORMS)
|
|
SRCMBR(EMPFORM) ALWQRYDFN(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command retrieves the encoded form source from the query management form (QMFORM) named SALFORM located in the RPTLIB library. If there is no QMFORM object named SALFORM in the RPTLIB library, then the form source is retrieved from the query definition (QRYDFN) named SALFORM in the RPTLIB library. The encoded form source records that are retrieved are placed into the first file named FORMS in the user's library list.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVQMFORM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RTVQMFORM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>QWM2701</b></dt>
|
|
<dd>&1 command failed.
|
|
</dd>
|
|
<dt><b>QWM2703</b></dt>
|
|
<dd>&1 command ended.
|
|
</dd>
|
|
<dt><b>QWM2705</b></dt>
|
|
<dd>Source file &1 in &2 not available.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVQMFORM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|