NAME phquery - returns directory information from Eastern Illinois University's
ph database to Web clients. SYNOPSIS
<A HREF='[http://www.eiu.edu]/cgi-bin/phquery[?[<username>]+[options]]'>...</a>
where <username> is a valid login name composed of
any alphanumeric characters, and where 'options' includes any order of
the characters [+$]. Brackets [] are used in this document to denote optional
values and are not used in the actual syntax. AVAILABILITY
http://www.eiu.edu
DESCRIPTION The script accepts either a query string from an external, username-appended
URL address or standard input from an internal HTML form and returns the
corresponding matches from the ph database. The form includes various
category options for the fields in the database that the script will use
for the search. Only 20 records are returned from any one query. Please
adjust the query to narrow the number of returned records or use the NEXT
and BACK links to continue viewing the entire query result. OPTIONS Any combination of options is prefixed by a single '+' and includes any
order of the following case-sensitive letters.
++ |
Display the current documentation and disable
all other actions of the script. |
+$ |
Display the expanded wildcard character documentation
on the client's query form. |
USAGE The client creates a case-insensitive query with any alphanumeric, space,
or hyphen characters. Only records with whole-word matches will be returned
unless any of the following wildcard (meta) characters are used. Only
the [brackets] may be used at the beginning of a query phrase.
[] Match a single character from a set of characters; for example [bj]ill
matches bill and jill.
* Zero or more characters; for example, wil* matches wil, will, and
william.
? Any single character; for example, w?lt matches walt and wilt.
FILES The script uses the '/var/local/bin/ph' command on the web platform.
If the executable file is not available, the script will return a critical
error message and send a warning to the webmaster. SEE ALSO
CGI Suite (Collection of General Purpose Scripts)
UNIX man pages
(<ph>);
DIAGNOSTICS phquery was developed to handle all types of user- and server-related
errors. The script will send back to the client various well-behaved error
messages that will diagnose problems in creating the query. WARNINGS Student phone numbers will not be searched from this request form. NOTES phquery has been tested without problem on Windows NT Workstations with
Netscape Communicator 4.x and Microsoft Internet Explorer 3.x web browsers.
Older versions of these and other browsers that do not support JavaScript
and Cascading Style Sheets will not display the response messages and
documentation as fully designed. This browser limitation, however, has
no effect on the function of the script. BUGS There are no known bugs in the current version. AUTHOR Gerald Charles Wagner. Version 2.0 (Release July 1998). |
