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

149 lines
4.8 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>Analyze Query (ANZQRY)</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="ANZQRY.Top_Of_Page"></a>
<h2>Analyze Query (ANZQRY)</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="#ANZQRY.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ANZQRY.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ANZQRY.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ANZQRY"></a>
<p>The Analyze Query (ANZQRY) command allows you to analyze a query definition (QRYDFN) object for query management conversion problems. Output from this command includes diagnostic messages about potential differences between Query/400 and query management use of query and form information derived from the analyzed QRYDFN object. A completion message shows the highest severity of potential problems found.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZQRY.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ANZQRY.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="#ANZQRY.QRY"><b>QRY</b></a></td>
<td valign="top">Query</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</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="#ANZQRY.SEV"><b>SEV</b></a></td>
<td valign="top">Severity code filter</td>
<td valign="top">0-99, <b><u>0</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ANZQRY.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ANZQRY.QRY"></a>
<h3>Query (QRY)</h3>
<p>Specifies the query definition (QRYDFN) to be analyzed.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Query</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the QRYDFN to be analyzed.
</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="#ANZQRY.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ANZQRY.SEV"></a>
<h3>Severity code filter (SEV)</h3>
<p>Specifies the severity code of the message. The severity code indicates the severity level of the condition that causes the message to be sent.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>All diagnostic messages about differences are logged.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify a severity code filter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZQRY.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ANZQRY.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Displaying All Messages</b>
</p>
<p>
<pre>
ANZQRY QRY(QRY2)
</pre>
</p>
<p>This command analyzes the first QRYDFN named QRY2 in the user's library list. Messages about conversion problems, for example, text that is too long, are sent to the job log. The messages are displayed when the analysis has completed.
</p>
<p><b>Example 2: Displaying Specific Messages</b>
</p>
<p>
<pre>
ANZQRY QRY(QRY2) SEV(99)
</pre>
</p>
<p>This command analyzes the first query named QRY2 in the user's library list. Only the completion message and messages diagnosing conditions which need to be investigated before a run is attempted are shown and logged.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZQRY.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ANZQRY.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ANZQRY.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>