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

1140 lines
39 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>Query Document Library (QRYDOCLIB)</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="QRYDOCLIB.Top_Of_Page"></a>
<h2>Query Document Library (QRYDOCLIB)</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="#QRYDOCLIB.PARAMETERS.TABLE">Parameters</a><br>
<a href="#QRYDOCLIB.COMMAND.EXAMPLES">Examples</a><br>
<a href="#QRYDOCLIB.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="QRYDOCLIB"></a>
<p>The Query Document Library (QRYDOCLIB) command allows you to search for documents within the document library. A document list is created containing the results of the search. You can also copy information about the documents that satisfy the search request into a database file for processing.
</p>
<p>When the QRYDOCLIB command is run, a document list object is created. The document list object is created regardless of whether an output file is produced unless the user specifies *NONE for the DOCL parameter. This document list object is used by the OfficeVision/400 product as well as the SAVDLO command.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>The current user of this command must have the authority to work on behalf of the specified user ID address. To work on behalf of other users, the user must have special permission granted with the Grant User Permission (GRTUSRPMN) command.
</li>
<li>The format of the output file must be the same as OSIQDL of the system file, QSYS/QAOSIQDL.
</li>
<li>If several QRYDOCLIB commands are run at the same time, the document list name (<b>Document list (DOCL)</b> parameter) and the output file name or member name (<b>File to receive output (OUTFILE)</b> parameter) must be different for each of these QRYDOCLIB commands.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="QRYDOCLIB.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="7"><a href="#QRYDOCLIB.QRYDFN"><b>QRYDFN</b></a></td>
<td valign="top">Query definition</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="7">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Start query</td>
<td valign="top">
*IF</td>
</tr>
<tr>
<td valign="top">Element 2: Search criteria</td>
<td valign="top">
Values (up to 49 repetitions): <i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Profile</td>
<td valign="top">
*ACTDATE, *ALWRPL, *ASP, *AUTHOR, *CHGDATE, *CMPDATE, *CPYLST, *CRTDATE, *DOCCLS, *DOCD, *DOCDATE, *DOCTYPE, *EXPDATE, *FILDATE, *IDXDATE, *KWD, *OWNER, *PROJECT, *REF, *REVDATE, *STATUS, *SUBJECT, *USEDATE</td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Relational operator</td>
<td valign="top">
*EQ, *GT, *LT, *NE, *GE, *NL, *LE, *NG, *CT, *BG</td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Compare value</td>
<td valign="top">
<i>Character value</i>, *YES, *NO</td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 4: Logical operator</td>
<td valign="top">
<b><u>*AND</u></b>, *OR</td>
</tr>
<tr>
<td valign="top"><a href="#QRYDOCLIB.FLR"><b>FLR</b></a></td>
<td valign="top">In folder</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 100 repetitions): <i>Character value</i>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#QRYDOCLIB.SCHSUBFLR"><b>SCHSUBFLR</b></a></td>
<td valign="top">Search subfolder</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="7"><a href="#QRYDOCLIB.QRYTXT"><b>QRYTXT</b></a></td>
<td valign="top">Query text</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="7">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Start query</td>
<td valign="top">
*IF</td>
</tr>
<tr>
<td valign="top">Element 2: Search criteria</td>
<td valign="top">
Values (up to 30 repetitions): <i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Phrase</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Type of matching</td>
<td valign="top">
<b><u>*ALL</u></b>, *EXACT</td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Allow synonyms</td>
<td valign="top">
<b><u>*NO</u></b>, *YES</td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 4: Logical operator</td>
<td valign="top">
<b><u>*OR</u></b>, *AND, *ANDNOT</td>
</tr>
<tr>
<td valign="top"><a href="#QRYDOCLIB.TXTLANGID"><b>TXTLANGID</b></a></td>
<td valign="top">Language ID</td>
<td valign="top"><i>Character value</i>, <b><u>*JOB</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#QRYDOCLIB.DOCL"><b>DOCL</b></a></td>
<td valign="top">Document list</td>
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#QRYDOCLIB.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#QRYDOCLIB.OUTFILE"><b>OUTFILE</b></a></td>
<td valign="top">File to receive output</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: File to receive output</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="#QRYDOCLIB.OUTMBR"><b>OUTMBR</b></a></td>
<td valign="top">Output member options</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Member to receive output</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Replace or add records</td>
<td valign="top">
<b><u>*REPLACE</u></b>, *ADD</td>
</tr>
<tr>
<td valign="top"><a href="#QRYDOCLIB.OUTDTATYP"><b>OUTDTATYP</b></a></td>
<td valign="top">Type of data for output</td>
<td valign="top">Single values: <b><u>*DFT</u></b>, *ALL<br>Other values (up to 21 repetitions): *ACTDATE, *AUTHOR, *CHGDATE, *CMPDATE, *CPYLST, *CRTDATE, *DOCCLS, *DOCD, *DOCDATE, *EXPDATE, *FILCAB, *FILDATE, *IDP, *IDXDATE, *KWD, *PROJECT, *REF, *REVDATE, *STATUS, *SUBJECT, *USEDATE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#QRYDOCLIB.USRID"><b>USRID</b></a></td>
<td valign="top">User identifier</td>
<td valign="top">Single values: <b><u>*CURRENT</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: User ID</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#QRYDOCLIB.TIMLMT"><b>TIMLMT</b></a></td>
<td valign="top">Time limit</td>
<td valign="top">1-9999, <b><u>*NOMAX</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#QRYDOCLIB.SELLMT"><b>SELLMT</b></a></td>
<td valign="top">Selection limit</td>
<td valign="top">1-32767, <b><u>*NOMAX</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#QRYDOCLIB.ORDER"><b>ORDER</b></a></td>
<td valign="top">Order by</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Profile</td>
<td valign="top">
*ACTDATE, *ASP, *AUTHOR, *CHGDATE, *CMPDATE, *CPYLST, *CRTDATE, *DOCCLS, *DOCD, *DOCDATE, *DOCTYPE, *EXPDATE, *FILDATE, *IDXDATE, *KWD, *OWNER, *PROJECT, *REF, *REVDATE, *STATUS, *SUBJECT, *USEDATE</td>
</tr>
<tr>
<td valign="top">Element 2: Selection order</td>
<td valign="top">
<b><u>*ASCEND</u></b>, *DESCEND</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#QRYDOCLIB.CMDCHRID"><b>CMDCHRID</b></a></td>
<td valign="top">Command character identifier</td>
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *DEVD<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Graphic character set</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top">Element 2: Code page</td>
<td valign="top">
<i>Integer</i></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="QRYDOCLIB.QRYDFN"></a>
<h3>Query definition (QRYDFN)</h3>
<p>Specifies what query definition selection values are used to select the documents. The values you specify on this parameter are used to search the document library. If values other than *NONE are specified on both the <b>Query text (QRYTXT)</b> parameter and this parameter, only documents that match both sets of values are selected. If you specify *NONE on both parameters, all documents to which you are authorized are selected.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No query definition is used to select the documents.
</dd>
</dl>
<p><b>Element 1: Start query</b>
</p>
<dl>
<dt><b>*IF</b></dt>
<dd>A query definition is used to select the documents.
</dd>
</dl>
<p><b>Element 2: Search criteria</b>
</p>
<p>To specify the conditions under which documents are selected, a set of values is specified for each condition. Each set must contain exactly four values:
</p>
<ol>
<li>The name of the document profile parameter to be compared (from the list that follows)
</li>
<li>One of the relational operator values (from the list that follows)
</li>
<li>The compare value
</li>
<li>One of the logical operators *AND, *OR, or *ANDNOT
</li>
</ol>
<p>Values 1 and 3 are compared for the relationship specified by value 2. Each QRYDFN relational set must be enclosed in parentheses. A maximum of 49 sets of values can be specified.
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Profile</b>
</p>
<p>Specifies the name of the document profile parameter to be compared.
</p>
<dl>
<dt><b>*ACTDATE</b></dt>
<dd>Action due date
</dd>
<dt><b>*ALWRPL</b></dt>
<dd>Allow document replacement
</dd>
<dt><b>*ASP</b></dt>
<dd>Auxiliary storage pool ID
</dd>
<dt><b>*AUTHOR</b></dt>
<dd>Document author
</dd>
<dt><b>*CHGDATE</b></dt>
<dd>Last change date
</dd>
<dt><b>*CMPDATE</b></dt>
<dd>Completion date
</dd>
<dt><b>*CPYLST</b></dt>
<dd>Copy list
</dd>
<dt><b>*CRTDATE</b></dt>
<dd>Create date
</dd>
<dt><b>*DOCCLS</b></dt>
<dd>Document class
</dd>
<dt><b>*DOCD</b></dt>
<dd>Document description
</dd>
<dt><b>*DOCDATE</b></dt>
<dd>Document date
</dd>
<dt><b>*DOCTYPE</b></dt>
<dd>Document type
</dd>
<dt><b>*EXPDATE</b></dt>
<dd>Expiration date
</dd>
<dt><b>*FILDATE</b></dt>
<dd>File date
</dd>
<dt><b>*IDXDATE</b></dt>
<dd>Last indexed date
</dd>
<dt><b>*KWD</b></dt>
<dd>Keyword
</dd>
<dt><b>*OWNER</b></dt>
<dd>Document owner
</dd>
<dt><b>*PROJECT</b></dt>
<dd>Document project
</dd>
<dt><b>*REF</b></dt>
<dd>Reference
</dd>
<dt><b>*REVDATE</b></dt>
<dd>Last revision date
</dd>
<dt><b>*STATUS</b></dt>
<dd>Document status
</dd>
<dt><b>*SUBJECT</b></dt>
<dd>Document subject
</dd>
<dt><b>*USEDATE</b></dt>
<dd>Last used date
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Relational operator</b>
</p>
<p>The relational operator indicates the relationship that must exist between the profile parameter contents in the document and the value specified as the compare value parameter of the query definition for the relationship to be true.
</p>
<p>The *CT operator is used to perform a context search. It asks the system to determine whether the character string specified by the compare value is contained anywhere in the profile parameter.
</p>
<p>The *BG operator is used to perform a search that compares the compare value with the beginning of the profile parameter. The profile parameter is truncated or extended as necessary to match the length of the specified value. It asks the system to determine whether the character string specified by the value is contained at the beginning of the profile parameter.
</p>
<p>Some operators are not allowed for some profile parameters. In this case, a diagnostic message followed by an escape message is sent.
</p>
<p>The following cases are not valid:
</p>
<ul>
<li>The *ALWRPL (allow document replacement) is a YES/NO switch. The *EQ operator is the only operator allowed with *ALWRPL.
</li>
<li>The *CT and *BG operators are not allowed with the *ASP value or date values such as *CRTDATE and *EXPDATE.
</li>
</ul>
<dl>
<dt><b>*EQ</b></dt>
<dd>Equal
</dd>
<dt><b>*GT</b></dt>
<dd>Greater than
</dd>
<dt><b>*LT</b></dt>
<dd>Less than
</dd>
<dt><b>*NE</b></dt>
<dd>Not equal
</dd>
<dt><b>*GE</b></dt>
<dd>Greater than or equal
</dd>
<dt><b>*NL</b></dt>
<dd>Not less than
</dd>
<dt><b>*LE</b></dt>
<dd>Less than or equal
</dd>
<dt><b>*NG</b></dt>
<dd>Not greater than
</dd>
<dt><b>*CT</b></dt>
<dd>Contains
</dd>
<dt><b>*BG</b></dt>
<dd>Begins
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 3: Compare value</b>
</p>
<p>Specifies the compare value to be used in the search.
</p>
<dl>
<dt><b><i>character</i></b></dt>
<dd>Specify the value to compare with the contents of the specified profile parameter. The parameter value must be specified in apostrophes if it contains blanks or special characters.
<p>The *ALWRPL field has two special values: *YES and *NO. When these are specified with the *ALWRPL field, they are changed to internal values for the indicator. When *YES or *NO are specified for the text field, they are used like they are.
</p>
<p>The *OWNER field is an 8-character user ID followed by its address. Trailing blanks cannot be omitted from the user ID. For example, if the user ID is JMDOE and the address is SYSTEM1, the query request would be:
</p>
<p>
<pre>
(*IF ((*OWNER *EQ 'JMDOE SYSTEM1'))).
</pre>
</p>
<p>If the user ID is JIMSMITH, the query request would be:
</p>
<p>
<pre>
(*IF ((*OWNER *EQ 'JIMSMITHSYSTEM1'))).
</pre>
</p>
<p>Dates must be entered in the system date format.
</p>
<p>
<b>Note: </b>If one of the date profile parameters is specified and the compare value is ' '(blank), then the compare value is equated to 01/01/01 or 01/001 for Julian date. '/' is changed depending on the system separator value QDATSEP.
</p>
<p>The allowable length for the search fields is limited by the Document Interchange Architecture (DIA) search database. When the length of the value is greater than the maximum, the value is truncated to the allowed length. The maximum lengths are:
</p>
<dl>
<dt><b>Value</b></dt>
<dd><b> Maximum Length
</b></dd>
<dt><b>*DOCD</b></dt>
<dd>44 characters
</dd>
<dt><b>*DOCCLS</b></dt>
<dd>16 characters
</dd>
<dt><b>*SUBJECT</b></dt>
<dd>60 characters
</dd>
<dt><b>*AUTHOR</b></dt>
<dd>20 characters
</dd>
<dt><b>*KWD</b></dt>
<dd>60 characters
</dd>
<dt><b>*CPYLST</b></dt>
<dd>60 characters
</dd>
<dt><b>*OWNER</b></dt>
<dd>16 characters
</dd>
<dt><b>*REF</b></dt>
<dd>60 characters
</dd>
<dt><b>*STATUS</b></dt>
<dd>20 characters
</dd>
<dt><b>*PROJECT</b></dt>
<dd>10 characters
</dd>
</dl>
<p>For all operators except *CT and *BG, if a value is specified that is shorter than the profile parameter value, then the specified value is extended with blanks to match the length of the profile parameter.
</p>
<p>The case (upper, lower, or mixed) that is used to enter the original parameter value or the case of the comparison value do not matter. The system changes both the entered comparison value and the original parameter value to upper case before making a comparison.
</p>
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 4: Logical operator</b>
</p>
<p>The logical operators are used to group conditions. The first <b>AND</b> operator encountered signifies that a condition group starts with the condition immediately preceding the <b>AND</b> operator. Subsequent conditions with the <b>AND</b> operator are added to the condition group. The first condition encountered containing the <b>OR</b> operator or the last condition in the query definition ends the condition group.
</p>
<dl>
<dt><b><u>*AND</u></b></dt>
<dd>The profile parameter value relational groups on both sides of the *AND value must all be satisfied before a document is selected.
</dd>
<dt><b>*OR</b></dt>
<dd>If the parameter value relational group on either side of the *OR value is satisfied, the document is selected.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.FLR"></a>
<h3>In folder (FLR)</h3>
<p>Specifies the folders to search for the documents that match the search values specified on the <b>Query definition (QRYDFN)</b> parameter and the <b>Query text (QRYTXT)</b> parameter.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All the folders on the system are searched.
</dd>
<dt><b>*NONE</b></dt>
<dd>Documents not located in any folder are searched.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the folders to search for the documents. This is the only folder searched. A folder name can consist of a series of folder names (FLR1/FLR2/etc.) if the documents being searched for are located in a folder contained in another folder. A maximum of 100 folders can be specified and each folder name can be a maximum of 63 characters in length.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.SCHSUBFLR"></a>
<h3>Search subfolder (SCHSUBFLR)</h3>
<p>Specifies whether subfolders of the folder specified on the <b>In folder (FLR)</b> parameter are searched.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Subfolders are not searched.
</dd>
<dt><b>*YES</b></dt>
<dd>Subfolders of the specified folder are searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.QRYTXT"></a>
<h3>Query text (QRYTXT)</h3>
<p>Specifies the text search values used to select documents. The values you specify on this parameter are used to search the text index. If values other than *NONE are specified on both the <b>Query definition (QRYDFN)</b> parameter and this parameter, only documents that match both sets of values are selected. If you specify *NONE on both parameters, all documents to which you are authorized are selected.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No text search values are entered.
</dd>
</dl>
<p><b>Element 1: Start query</b>
</p>
<dl>
<dt><b>*IF</b></dt>
<dd>Text search values are used in the document search.
</dd>
</dl>
<p><b>Element 2: Search criteria</b>
</p>
<p>To specify the conditions under which documents are selected, a set of values is specified for each condition. Each set contains four values:
</p>
<ol>
<li>A phrase, which the system compares to entries in the text search index
</li>
<li>One of the 'type of matching' values
</li>
<li>One of the 'allow synonyms' values
</li>
<li>One of the logical operators
</li>
</ol>
<p>A maximum of 30 sets of values can be specified. Each set must be enclosed in parentheses.
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Phrase</b>
</p>
<dl>
<p>Specifies a phrase which the system compares to entries in the text search index.
</p>
<dt><b><i>character</i></b></dt>
<dd>Specify a phrase of one or more words. Do not use any punctuation. When specifying phrases, you can:
<ul>
<li>use an asterisk (*) to mask a whole word within a phrase. For example, if you want to search for documents referring to various annual reports, you can specify the phrase:
<p>
<pre>
annual * report
</pre>
</p>
<p>The search results will include documents containing such phrases as annual budget report, annual progress report, and annual sales report. The search results will also include documents containing the phrase 'annual report' without a word in between.
</p>
<p>When using a word mask, you must specify a word before and after the asterisk. A word mask at the beginning or end of a phrase is ignored.
</p>
</li>
<li>use an asterisk (*) to mask part of a word within a phrase. The mask can be used at the beginning, middle, or end of a word. For example, if you want to search for documents referring to word processing, you can specify the phrase:
<p>
<pre>
word process*
</pre>
</p>
<p>The search results will include documents containing such phrases as word processing, word processor, and word processed.
</p>
</li>
<li>use a question mark (?) to mask one or more characters in a word. For example, if you want to search for documents referring to the various spellings of Johnson, you can specify the phrase:
<p>
<pre>
j?hns?n
</pre>
</p>
<p>The search results will include documents containing such phrases as johnson, johnsen, and jahnson.
</p>
</li>
</ul>
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Type of matching</b>
</p>
<p>Specifies a type of matching value to be used in the search.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The phrase must be contained within one sentence, but the words do not have to be in the specified order.
</dd>
<dt><b>*EXACT</b></dt>
<dd>The phrase must be contained within one sentence and the words must be in the specified order.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 3: Allow synonyms</b>
</p>
<p>Specifies whether synonyms are to be used in the search.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>No synonyms are used.
</dd>
<dt><b>*YES</b></dt>
<dd>Synonyms for each word in the phrase, if available, are also used to compare to entries in the text index.
<p>
<b>Note: </b>Using synonyms may affect the performance of the request by causing more words to be searched for, and possibly by causing more documents to be selected.
</p>
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 4: Logical operator</b>
</p>
<p>Specifies a logical operator to be used in the search.
</p>
<dl>
<dt><b><u>*OR</u></b></dt>
<dd>If the phrase on either side of the *OR value is found, the document is selected.
</dd>
<dt><b>*AND</b></dt>
<dd>If the phrases on both sides of the *AND value are found, the document is selected.
</dd>
<dt><b>*ANDNOT</b></dt>
<dd>If the phrase following the *ANDNOT value is not found, the document is selected.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.TXTLANGID"></a>
<h3>Language ID (TXTLANGID)</h3>
<p>Specifies the language identifier for the phrases in the query text. This parameter is required if the <b>Query text (QRYTXT)</b> parameter is specified; it is not allowed if the QRYTXT parameter is not specified or has a value of *NONE.
</p>
<dl>
<dt><b><u>*JOB</u></b></dt>
<dd>The language identifier specified for the job in which this command is entered is used.
</dd>
<dt><b><i>character</i></b></dt>
<dd>Specify a language identifier. Press the PF4 key when prompting the <b>Language ID (TXTLANGID)</b> parameter to see a list of valid identifiers.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.DOCL"></a>
<h3>Document list (DOCL)</h3>
<p>Specifies the name of the document list. The document list contains a pointer to each document in the document library that is qualified for search. This list is a copy of the library at the time the search was run. As documents are deleted from the library or added to the library, the document list is not updated. The document library list name is specified with the name of the user requesting the search.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>A system created name is used as the default name. The default list is the same as the user ID on the <b>User identifier (USRID)</b> parameter.
</dd>
<dt><b>*NONE</b></dt>
<dd>No document list is created.
</dd>
<dt><b><i>character</i></b></dt>
<dd>Specify the name of the document list. A maximum of 8 characters can be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.TEXT"></a>
<h3>Text (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>character</i></b></dt>
<dd>Specify a maximum of 50 characters, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.
</p>
<p><b>Qualifier 1: File to receive output</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the database file to which the command output is directed.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<p>
<b>Note: </b>If a new file is created, the system uses QAOSIQDL in QSYS with a format name of OSQDL as a model.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.OUTMBR"></a>
<h3>Output member options (OUTMBR)</h3>
<p>Specifies the name of the database file member that receives the output of the command.
</p>
<p><b>Element 1: Member to receive output</b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the file member that receives the output. If it does not exist, the system creates it.
</dd>
</dl>
<p><b>Element 2: Replace or add records</b>
</p>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The system clears the existing member and adds the new records.
</dd>
</dl>
<dl>
<dt><b>*ADD</b></dt>
<dd>The system adds the new records to the end of the existing records.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.OUTDTATYP"></a>
<h3>Type of data for output (OUTDTATYP)</h3>
<p>Specifies that certain information about the selected documents is written to the output file if a value is specified on the <b>File to receive output (OUTFILE)</b> parameter.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The document information record is written to the output file. This is the same as specifying *DOCD. The record code is 105.
</dd>
<dt><b>*ALL</b></dt>
<dd>All information records about the document are written.
</dd>
</dl>
<dl>
<dt><b>*ACTDATE</b></dt>
<dd>The action due date record is written. The record code is 135.
</dd>
<dt><b>*AUTHOR</b></dt>
<dd>The author records are written. The record code is 145.
</dd>
<dt><b>*CHGDATE</b></dt>
<dd>The date last changed record is written. The record code is 130.
</dd>
<dt><b>*CMPDATE</b></dt>
<dd>The completion date record is written. The record code is 140.
</dd>
<dt><b>*CPYLST</b></dt>
<dd>The copy list records are written. The record code is 150.
</dd>
<dt><b>*CRTDATE</b></dt>
<dd>The create date record is written. The record code is 110.
</dd>
<dt><b>*DOCCLS</b></dt>
<dd>The document class record is written. The record code is 155.
</dd>
<dt><b>*DOCD</b></dt>
<dd>The document description record is written. The record code is 105.
</dd>
<dt><b>*DOCDATE</b></dt>
<dd>The document date record is written. The record code is 120.
</dd>
<dt><b>*EXPDATE</b></dt>
<dd>The expiration date record is written. The record code is 115.
</dd>
<dt><b>*FILCAB</b></dt>
<dd>The file cabinet reference record is written. The record code is 160.
</dd>
<dt><b>*FILDATE</b></dt>
<dd>The file date record is written. The record code is 125.
</dd>
<dt><b>*IDP</b></dt>
<dd>The interchange document profile (IDP) is written. The record code is 500.
</dd>
<dt><b>*IDXDATE</b></dt>
<dd>The last indexed date record is written to the output file. OfficeVision/400 text search services must be installed if this value is specified.
</dd>
<dt><b>*KWD</b></dt>
<dd>The keyword records are written. The record code is 170.
</dd>
<dt><b>*PROJECT</b></dt>
<dd>The project record is written. The record code is 185.
</dd>
<dt><b>*REF</b></dt>
<dd>The reference record is written. The record code is 175.
</dd>
<dt><b>*REVDATE</b></dt>
<dd>The date of the last revision to the document content is written to the output file.
</dd>
<dt><b>*STATUS</b></dt>
<dd>The status record is written. The record code is 180.
</dd>
<dt><b>*SUBJECT</b></dt>
<dd>The subject records are written. The record code is 165.
</dd>
<dt><b>*USEDATE</b></dt>
<dd>The date last used record is written. The record code is 200.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.USRID"></a>
<h3>User identifier (USRID)</h3>
<p>Specifies which user ID and user ID address should be associated with the request.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>You are performing the request for yourself.
</dd>
</dl>
<p><b>Element 1: User ID</b>
</p>
<dl>
<dt><b><i>character</i></b></dt>
<dd>Specify another user's user ID or your user ID. You must have been given permission to work on behalf of another user or have all object (*ALLOBJ) special authority.
</dd>
</dl>
<p><b>Element 2: Address</b>
</p>
<dl>
<dt><b><i>character</i></b></dt>
<dd>Specify another user's address or your address. You must have been given permission to work on behalf of another user or have *ALLOBJ authority.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.TIMLMT"></a>
<h3>Time limit (TIMLMT)</h3>
<p>Specifies the amount of time allowed for the requested search to run.
</p>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>No time limit for the search is set. All qualified documents are searched.
</dd>
<dt><b><i>1-9999</i></b></dt>
<dd>Specify the maximum time limit (in minutes) that the search runs. A two-hour limit is specified as TIMLMT(120). If the search has not been completed when the time limit is reached, the search ends with an informational message followed by a completion message. The output file, and if specified the document list, will contain the documents found within the specified time limit.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.SELLMT"></a>
<h3>Selection limit (SELLMT)</h3>
<p>Specifies the allowed number of documents to select in the search.
</p>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>No document limit for the search is set. All qualified documents are selected, up to the system limit of 32,767.
</dd>
<dt><b><i>1-32,767</i></b></dt>
<dd>Specify the maximum number of documents to select. If there are more documents than the set limit, the document list and the output file contain information about the selected documents up to this limit and an informational message indicating that the limit was reached. The completion message indicates the number of documents selected.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.ORDER"></a>
<h3>Order by (ORDER)</h3>
<p>Specifies that the selected documents are to be ordered (ascending or descending) when placed in the created document list or output file. The order is defined for one or more document profile parameters specified, up to a maximum of 5.
</p>
<p>
<b>Note: </b>If a value other than *NONE is specified on the <b>Query text (QRYTXT)</b> parameter, ordering is not allowed.
</p>
<p>When a user specifies an order to the search request, the performance of the request may be affected. The request performs best if no order is specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No order is applied to the selected documents.
</dd>
</dl>
<p><b>Element 1: Profile</b>
</p>
<dl>
<dt><b>*ACTDATE</b></dt>
<dd>The returned documents are ordered by the action due date.
</dd>
<dt><b>*ASP</b></dt>
<dd>The returned documents are ordered by the auxiliary storage pool ID (ASPID) parameter.
</dd>
<dt><b>*AUTHOR</b></dt>
<dd>The returned documents are ordered by the author.
</dd>
<dt><b>*CHGDATE</b></dt>
<dd>The returned documents are ordered by the last changed date.
</dd>
<dt><b>*CMPDATE</b></dt>
<dd>The returned documents are ordered by the completion date.
</dd>
<dt><b>*CPYLST</b></dt>
<dd>The returned documents are ordered by the copy list.
</dd>
<dt><b>*CRTDATE</b></dt>
<dd>The returned documents are ordered by the create date.
</dd>
<dt><b>*DOCCLS</b></dt>
<dd>The returned documents are ordered by the document class.
</dd>
<dt><b>*DOCD</b></dt>
<dd>The returned documents are ordered by the document description.
</dd>
<dt><b>*DOCDATE</b></dt>
<dd>The returned documents are ordered by the document date.
</dd>
<dt><b>*DOCTYPE</b></dt>
<dd>The returned documents are ordered by the document type profile parameter. Valid values range from 2 through 65535.
</dd>
<dt><b>*EXPDATE</b></dt>
<dd>The returned documents are ordered by the expiration date.
</dd>
<dt><b>*FILDATE</b></dt>
<dd>The returned documents are ordered by the date the documents were filed.
</dd>
<dt><b>*IDXDATE</b></dt>
<dd>The returned documents are ordered by the last indexed date profile parameter. Text search services must be installed if this value is specified.
</dd>
<dt><b>*KWD</b></dt>
<dd>The returned documents are ordered by the keyword.
</dd>
<dt><b>*OWNER</b></dt>
<dd>The returned documents are ordered by the name of the owner user profile name.
</dd>
<dt><b>*PROJECT</b></dt>
<dd>The returned documents are ordered by the project.
</dd>
<dt><b>*REF</b></dt>
<dd>The returned documents are ordered by the reference.
</dd>
<dt><b>*REVDATE</b></dt>
<dd>The returned documents are ordered by the last content revision date.
</dd>
<dt><b>*STATUS</b></dt>
<dd>The returned documents are ordered by the status.
</dd>
<dt><b>*SUBJECT</b></dt>
<dd>The returned documents are ordered by the subject.
</dd>
<dt><b>*USEDATE</b></dt>
<dd>The returned documents are ordered by the last used date.
</dd>
</dl>
<p><b>Element 2: Selection order</b>
</p>
<dl>
<dt><b><u>*ASCEND</u></b></dt>
<dd>The returned documents are ordered in the ascending collating sequence.
</dd>
<dt><b>*DESCEND</b></dt>
<dd>The returned documents are be ordered in the descending collating sequence.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="QRYDOCLIB.CMDCHRID"></a>
<h3>Command character identifier (CMDCHRID)</h3>
<p>Specifies the character identifier (graphic character set and code page) for the data being entered as command parameter values. The character identifier is related to the display device used to enter the command.
</p>
<p>The CMDCHRID parameter applies to the following parameters and means that the data is translated to the code page and character set common to all documents in the search database. That character set and code page is '697 500', except for the <b>User identifier (USRID)</b> parameter, which is '930 500'.
</p>
<p>The following parameters are translated:
</p>
<ul>
<li><b>User identifier</b> (USRID)
</li>
<li><b>Document list</b> (DOCL)
</li>
<li><b>Query definition</b> (QRYDFN)
</li>
<li><b>Query text</b> (QRYTXT)
</li>
<li><b>Text</b> (TEXT)
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
</dd>
</dl>
<dl>
<dt><b>*DEVD</b></dt>
<dd>The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.
</dd>
</dl>
<p><b>Element 1: Graphic character set</b>
</p>
<dl>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the graphic character set to use.
</dd>
</dl>
<p><b>Element 2: Code page</b>
</p>
<dl>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the code page to use.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="QRYDOCLIB.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
QRYDOCLIB USRID(*CURRENT) OUTFILE(*NONE) DOCL(MYLIST)
QRYDFN(*IF ((*DOCD *EQ DOCDESC *AND)
(*DOCCLS *BG CLASS *OR)
(*FILDATE *LE '06/13/88')))
</pre>
</p>
<p>This command searches for documents that meet the following search conditions: document description equals DOCDESC and document class starts with Class; or the file date is on or before 06/13/88. The results of the search will be stored in the document list MYLIST.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="QRYDOCLIB.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF900B</b></dt>
<dd>User ID and address &amp;1 &amp;2 not in System Distribution Directory.
</dd>
<dt><b>CPF900C</b></dt>
<dd>Sign on and verify of user failed.
</dd>
<dt><b>CPF905C</b></dt>
<dd>Error occurred trying to find a translation table.
</dd>
<dt><b>CPF905D</b></dt>
<dd>Query of document library failed.
</dd>
<dt><b>CPF9096</b></dt>
<dd>Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
</dd>
<dt><b>CPF9860</b></dt>
<dd>Error occurred during output file processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#QRYDOCLIB.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>