% @(#)searchicat.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:55 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      searchicat.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, SEARCH/ICAT
%.PURPOSE    On-line help file for the command: SEARCH/ICAT
%.VERSION    1.0  24-JUN-1991 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./ICAT
\es\co
SEARCH/ICAT	 	                            24-JUN-1991  KB
\oc\su
SEARCH/ICAT [cat_name] search_string [options]
	search in image catalog for frame with matching Ident field
\us\pu
Purpose: 
          Search in image catalog for frame with matching Ident field.
\up\sy
Syntax:
          SEARCH/ICAT [cat_name] search_string [options]
\ys\pa
          cat_name = name of Image Catalog;
\\
              defaulted to the currently active Image Catalog
\ap\pa
          search_string = text pattern for which to search
\ap\pa
          options = display + searchflag (2 chars.),
\\
              1. char. = D or N, for D a message is displayed if a matching
              frame has been found, else not;
\\
              2. char. = B or E, for B search is done from the beginning, else
              from the end of the catalog.
\\
              defaulted to DB
\ap\sa
See also:
          SEARCH/TCAT, SEARCH/FCAT
\\
          SET/ICAT, CREATE/ICAT, READ/ICAT, ADD/ICAT, SUBTRACT/ICAT
\as\no
Note:  
          The search is done from the beginning or from the end of the catalog
          and for the first entry with a matching Ident field the corresponding
          frame name is returned in keyword OUT_A.
\\
          If no match, keyword OUT_A is set to all blanks.
\\
          If the search_string contains blanks, it has to be enclosed in double
          quotes (").
\on\exs
Examples:
\ex
          SEARCH/ICAT lolly FF1024
            Search in Image Catalog `lolly.cat' for an entry with an Ident
            field containing the string "FF1024". If found, display relevant
            message and fill keyword OUT_A accordingly.
\xe\ex
          SEARCH/ICAT lolly FF1024 de
            As above but we start searching with the last entry in the catalog
            and work our way down to the first entry.
\xe\ex
          SEARCH/ICAT ? "aa bb" NB
            Search in the currently active Image Catalog for an entry with an
            Ident field containing the string "aa bb". No message is displayed.
\xe \sxe