% @(#)searchfcat.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:55 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      searchfcat.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, SEARCH/FCAT
%.PURPOSE    On-line help file for the command: SEARCH/FCAT
%.VERSION    1.0  24-JUN-1991 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./FCAT
\es\co
SEARCH/FCAT	 	                            24-JUN-1991  KB
\oc\su
SEARCH/FCAT [cat_name] search_string [options]
	search in fit file catalog for frame with matching descriptor IDENT
\us\pu
Purpose: 
          Search in fit file catalog for frame with matching descriptor IDENT.
\up\sy
Syntax:
          SEARCH/FCAT [cat_name] search_string [options]
\ys\pa
          cat_name = name of Fit File Catalog;
\\
              defaulted to the currently active Fit File 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/ICAT
\\
          SET/FCAT, CREATE/FCAT, READ/FCAT, ADD/FCAT, SUBTRACT/FCAT
\as\no
Note:  
          The search is done from the beginning or from the end of the catalog
          and the first frame with a matching IDENT descriptor is returned in
          keyword OUT_A.
\\
          If no match, 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/FCAT lolly FF1024
          Search in Fit File Catalog lolly.cat for a frame with an IDENT
          descriptor containing the string "FF1024". If found, display relevant
          message.
\xe\ex
          SEARCH/FCAT 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/FCAT ? "aa bb" NB
          Search in the currently active Fit File Catalog for a frame with an
          IDENT descriptor containing the string "aa bb".
          No message is displayed.
\xe \sxe