% @(#)executtabl.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:34 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      executtabl.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, EXECUTE/TABLE
%.PURPOSE    On-line help file for the command: EXECUTE/TABLE
%.VERSION    1.0  23-DEC-1993 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./TABL
\es\co
EXECUTE/TABLE						23-DEC-1993  KB
\oc\su
EXECUTE/TABLE table command-string
	execute command on all rows of table
\us\pu
Purpose:   
	  Execute a MIDAS command with operands in columns of a MIDAS
          table looping over all rows of the table.
\up\sy
Syntax:    
          EXECUTE/TABLE table command-string
\ys\pa
          table = name of MIDAS table
\ap\pa
          command-string = any MIDAS command using operands which are stored
                 in columns of the table;
\\
                 they are indicated by the column label enclosed in square
                 brackets [ and ], e.g. [:X_COORD]
\ap\sa
See also:
          EXECUTE/CATALOG
\as\no
Note:      
          The command creates a Midas procedure `midtabXY.prg' (with 
          XY = Midas unit) which loops over all rows of the table. 
          This procedure is then executed.
\on\exs
Examples:
\ex
          EXECUTE/TABLE incahuasi compute/image [:image1] = [:image2]+1.234
           Execute the COMPUTE/IMAGE command with result frame names stored
           in column labeled :IMAGE1 and input image names stored in column
           labeled :IMAGE2.
           Execute the command for all rows of the table `incahuasi.tbl'.
\xe\ex
          EXECUTE/TABLE coquimbo write/out [:Ident]
           Write out the contents of column :IDENT of table `coquimbo.tbl'.
\xe \sxe