264 lines
9.6 KiB
HTML
264 lines
9.6 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>Create Search Index (CRTSCHIDX)</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="CRTSCHIDX.Top_Of_Page"></a>
|
||
|
<h2>Create Search Index (CRTSCHIDX)</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="#CRTSCHIDX.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
<a href="#CRTSCHIDX.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
<a href="#CRTSCHIDX.ERROR.MESSAGES">Error messages</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<div> <a name="CRTSCHIDX"></a>
|
||
|
<p>The Create Search Index (CRTSCHIDX) command creates a search index. A search index is used to refer to the help information contained in one or more panel groups.
|
||
|
</p>
|
||
|
<p>You can access a search index through data description specifications (DDS) by pressing the HELP key, or through the index search function using the Start Search Index (STRSCHIDX) command.
|
||
|
</p>
|
||
|
<p>A search index created by the CRTSCHIDX command does not contain any data. Add data using the Add Search Index Entry (ADDSCHIDXE) command.
|
||
|
</p>
|
||
|
<p><b>Restrictions:</b>
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>You must have add (*ADD) authority for the library where the search index is to be located.
|
||
|
</li>
|
||
|
<li>IBM-supplied panel groups cannot be added to a search index created with the CRTSCHIDX command; only panel groups created with the Create Panel Group (CRTPNLGRP) command can be added to a search index created with the CRTSCHIDX command.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
|
||
|
<div>
|
||
|
<h3><a name="CRTSCHIDX.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="#CRTSCHIDX.SCHIDX"><b>SCHIDX</b></a></td>
|
||
|
<td valign="top">Search index</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: Search index</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>*CURLIB</u></b></td>
|
||
|
</tr><tr>
|
||
|
<td valign="top"><a href="#CRTSCHIDX.TITLE"><b>TITLE</b></a></td>
|
||
|
<td valign="top">Display title</td>
|
||
|
<td valign="top"><i>Character value</i></td>
|
||
|
<td valign="top">Required, Positional 2</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTSCHIDX.TEXT"><b>TEXT</b></a></td>
|
||
|
<td valign="top">Text 'description'</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*TITLE</u></b>, *BLANK</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="3"><a href="#CRTSCHIDX.CHRID"><b>CHRID</b></a></td>
|
||
|
<td valign="top">Character identifier</td>
|
||
|
<td valign="top">Single values: <b><u>*SYSVAL</u></b><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>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTSCHIDX.AUT"><b>AUT</b></a></td>
|
||
|
<td valign="top">Authority</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<div> <a name="CRTSCHIDX.SCHIDX"></a>
|
||
|
<h3>Search index (SCHIDX)</h3>
|
||
|
<p>Specifies the search index to be created.
|
||
|
</p>
|
||
|
<p>This is a required parameter.
|
||
|
</p>
|
||
|
<p><b>Qualifier 1: Search index</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the search index.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Qualifier 2: Library</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*CURLIB</u></b></dt>
|
||
|
<dd>The current library for the job is used to create the search index. If no library is specified as the current library for the job, QGPL is used.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the library where the search index is to be created.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTSCHIDX.TITLE"></a>
|
||
|
<h3>Display title (TITLE)</h3>
|
||
|
<p>Specifies the title you want to appear at the top of the selected topics display when the search information is presented.
|
||
|
</p>
|
||
|
<p>This is a required parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specify no more than 55 characters, enclosed in apostrophes.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTSCHIDX.TEXT"></a>
|
||
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
<p>Specifies the text that briefly describes the object.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*TITLE</u></b></dt>
|
||
|
<dd>The first 50 characters of the title are used as the text.
|
||
|
</dd>
|
||
|
<dt><b>*BLANK</b></dt>
|
||
|
<dd>No text is specified.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTSCHIDX.CHRID"></a>
|
||
|
<h3>Character identifier (CHRID)</h3>
|
||
|
<p>Specifies the graphic character set and code page values used for the search index. The value specified for this parameter must match the TXTCHRID parameter value of panel groups added to this search index.
|
||
|
</p>
|
||
|
<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>
|
||
|
<p><b>Element 1: Graphic character set</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>integer</i></b></dt>
|
||
|
<dd>Specify the graphic character set value that matches the character set of the synonyms that will be used in the search index.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 2: Code page</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>integer</i></b></dt>
|
||
|
<dd>Specify the code page value that matches the code page of the synonyms that will be used in the search index.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTSCHIDX.AUT"></a>
|
||
|
<h3>Authority (AUT)</h3>
|
||
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
||
|
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*CHANGE</b></dt>
|
||
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*ALL</b></dt>
|
||
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*USE</b></dt>
|
||
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
<dd>The user cannot access the object.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="CRTSCHIDX.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
<p>
|
||
|
<pre>
|
||
|
CRTSCHIDX SCHIDX(ACCOUNTING) TITLE('Accounting Help Index')
|
||
|
TEXT('Accounting Help Index')
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command creates a search index named ACCOUNTING in the current library.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="CRTSCHIDX.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>CPF6E11</b></dt>
|
||
|
<dd>Search index &2 not created in library &3.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTSCHIDX.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</body>
|
||
|
</html>
|