Search Input

An application that uses ICQCAL00 passes names directory search requests to ICQCAL00 through an ISPF table. Applications must define the table in advance and identify it when invoking ICQCAL00. The application can prompt users for search requests and can create the table from the users' responses.

Figure 1. Using ICQCAL00 to Access the Names Directory

The user requests information.
The application program, if necessary, prompts the user for more information.
The application program places the request into the ISPF table and then invokes ICQCAL00.
ICQCAL00 gets the requested information from the names directory and returns it to the application program. The application program then returns the information to the user.

Each row of the table provides the input for one search of the names directory, using the following types of variables:

Variables in the names directory to be searched for and returned
Variables that control the scope of the search and the results and messages displayed to the user.

Any variable or combination of variables in the names directory can be searched for, such as last name, first name, department, or user ID. For example, one row of the input table can specify a search for all directory entries with the name John Smith, or for all directory entries in a certain department. The variable QCANVARS, set by the non-display panel ICQSIECA, contains all the variables used in the names directory.

The controlling variables limit the search. For example, they can specify the names directories to be searched (master, private or both), the types of directory entries to be searched for (names, groups, or both) and the maximum number of selections allowed.

Other variables specify panels on which to display the search results to users, and messages to appear on the panels to guide the user in selecting the displayed names.