% @(#)searchtcat.hlq	19.1 (ESO-IPG) 02/25/03 14:03:42 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      searchtcat.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, SEARCH/TCAT
%.PURPOSE    On-line help file for the command: SEARCH/TCAT
%.VERSION    1.0  24-JUN-1991 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./TCAT
\es\co
SEARCH/TCAT	 	                            24-JUN-1991  KB
\oc\su
SEARCH/TCAT [cat_name] search_string [options]
	search in table catalog for table with matching Ident field
\us\pu
Purpose: 
          Search in table catalog for table with matching Ident field.
\up\sy
Syntax:
          SEARCH/TCAT [cat_name] search_string [options]
\ys\pa
          cat_name = name of Table Catalog;
\\
              defaulted to the currently active Table 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
              table 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/ICAT, SEARCH/FCAT
\\
          SET/TCAT, CREATE/TCAT, READ/TCAT, ADD/TCAT, SUBTRACT/TCAT
\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
          table file 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/TCAT lolly FF1024
            Search in Table 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/TCAT 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/TCAT ? "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
