% @(#)executcata.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:34 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      executcata.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, EXECUTE/CATALOG
%.PURPOSE    On-line help file for the command: EXECUTE/CATALOG
%.VERSION    1.0  17-SEP-1987 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./CATA
\es\co
EXECUTE/CATALOG						28-JAN-1994  KB
\oc\su
EXECUTE/CATALOG com_string parm1 ... parm7
	execute a MIDAS procedure or command for all entries in a catalog
\us\pu
Purpose:   
          Execute a MIDAS procedure or MIDAS command for all entries in
          a catalog.
\up\sy
Syntax:    
          EXECUTE/CATALOG com_string parm1 ... parm7
\ys\pa
          com_string = name of MIDAS procedure, with type (.prg), or a 
                       MIDAS command.
\ap\pa
          parm1 ... parm7 = up to 7 parameters,
\\
                       passed to the procedure or MIDAS command
\ap\sa
See also:
          WRITE/SETUP, READ/SETUP, INFO/SETUP, INITIALIZE/SETUP
\\
          CREATE/ICAT, READ/ICAT, STORE/FRAME
\as\no
Note:      
          At least one of the parameters P2, ..., P8 of EXECUTE/CATALOG
          has to be of the form `xyz.cat' to indicate an input catalog.
\\
          If output images are created, put a catalog name (with .cat)
          as the relevant parameter and specify that parameter no. via the
          "WRITE/SETUP catalog" command. Note, that only a single output
          catalog is supported by EXECUTE/CATALOG. If that is not suitable,
          you have to edit your own MIDAS procedure using STORE/FRAME to
          obtain that functionality.
\\
          There are different ways to construct the name of the output frames
          from the input frame names, also an interval of entry numbers for
          the first input catalog may be set up. Finally, input frames may be
          automatically deleted after having been processed.
\\
          All that is controlled via the Setup mechanism in MIDAS.
\\
          The name of the setup for EXECUTE/CATALOG is `catalog'.
\\
          WRITE/SETUP CATALOG modifies all control variables, 
\\
          INIT/SETUP CATALOG sets all variables to their default value,
\\
          READ/SETUP CATALOG displays the current status and
\\
          INFO/SETUP CATALOG explains the syntax of the WRITE/SETUP command
          for the catalog Setup in detail.
\\
          Currently, EXECUTE/CATALOG operates only on image catalogs!
\on\exs
Examples:
\ex
          INFO/SETUP CATALOG
            Get a detailed explanation of all the variables involved.
\xe\ex
          WRITE/SETUP catalog 1,4 1 no 1,100 2 zz
            Setup the control variables for all subsequent EXECUTE/CATALOG
            commands (for explanation use INFO/SETUP CATALOG).
\xe\ex
          EXECUTE/CATALOG compute/ima res.cat = aguila.cat + 12.345
            Execute the command COMPUTE/IMAGE for all images with entries in
            catalog `aguila.cat'. Add entries for all result images to catalog
            `res.cat'.
\\
            Note, that parameter no. 6 of the WRITE/SETUP command above was 2,
            indicating that parameter no. 2 of the EXECUTE/CATALOG command
            holds the name of the output catalog.
\xe\ex
          WRITE/SETUP catalog 1,4 1 no 1,100 0
            Setup the control variables such that no output catalog is
            expected in a following EXECUTE/CATALOG command.
\xe\ex
          EXECUTE/CATALOG READ/DESCR tortuga.cat npix
            Read the descriptor NPIX of all image frames with entries in the
            catalog `tortuga.cat'. Note, that the READ/DESCR command does not
            create an output image.
\xe \sxe