Add Search Index Entry (ADDSCHIDXE)

The Add Search Index Entry (ADDSCHIDXE) command is used to load panel group online help information into a search index.

A search index is a reference to online help information from one or more panel groups. A panel group contains online help information, which the user can access from display panels, by pressing the HELP key, or through the index search function using the Start Search Index (STRSCHIDX) command.

The sequence in which panel groups are loaded into a search index controls the sequence in which topic entries are presented when an index search is requested. The topics (ISCH tag entries) from the first-loaded panel group are presented first.

Restrictions:

• You must have change (*CHANGE) authority for the search index that is to be changed, use (*USE) authority for the panel group, and *USE authority for the library where the search index is located.
• Only user-created panel groups can be added to user-created search indexes and only IBM-supplied panel groups can be added to IBM-supplied search indexes.
• Panel group names must be unique within a search index.

Parameters

Search index (SCHIDX)

Specifies the search index into which entries are to be loaded.

This is a required parameter.

Qualifier 1: Search index

name

Specify the name of the search index.

Qualifier 2: Library

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the job is used to locate the search index. If no library is specified as the current library for the job, QGPL is used.

name

Specify the name of the library where the search index is located.

Panel group (PNLGRP)

Specifies the panel group that contains the help source for which the index entries are to be loaded into the search index.

The search index object contains the name and library of the panel group. When help information is displayed for a search index, the name and library of the panel group that is contained in the search index object is used to find the panel group.

When *LIBL is used to qualify the panel group name, *LIBL is saved in the search index object. When the panel group name is qualified with a library name or with *CURLIB, the actual name of the library containing the panel group is saved in the search index object.

The names of panel groups added to a search index must be unique.

This is a required parameter.

Qualifier 1: Panel group

name

Specify the name of the panel group.

Qualifier 2: Library

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the job is used to locate the panel group. If no library is specified as the current library for the job, QGPL is used.

name

Specify the name of the library where the panel group is located.

Examples

ADDSCHIDXE   SCHIDX(ACCOUNTING)  PNLGRP(PAYROLL)

This command adds panel group PAYROLL to search index ACCOUNTING. Both the panel group and the search index must exist in the library list.

Error messages

*ESCAPE Messages

CPF6E07

Panel group cannot be added to search index.

CPF6E08

Panel group cannot be added to search index.

CPF6E09

Panel group does not contain any synonyms or root words.

CPF6E12

Panel group not added to search index.

CPF6E47

Panel group &1 cannot be added to search index &3

CPF6E48

Panel group &1 cannot be added to search index &3

CPF6E49

Panel group &1 cannot be added to search index &3

CPF6E61

Panel group &1 cannot be added to search index &3.

CPF6E62

Panel group &1 already exists in search index &3.

CPF6E63

Error occurred while trying to recover from another error.