% @(#)store_fram.hlq	19.1 (ESO-IPG) 02/25/03 14:03:47 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      store_fram.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, STORE/FRAM
%.PURPOSE    On-line help file for the command: STORE/FRAM
%.VERSION    1.0  16-JAN-1990 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./FRAM
\es\co
STORE/FRAME	                               16-JAN-1990   KB
\oc\su
STORE/FRAME key frame [indx] [exit_label]
	store frame or entries of catalog into key
\us\pu
Purpose:
          Store frame or entries of a catalog into keyword.
\up\sy
Syntax:
          STORE/FRAME key frame [indx] [exit_label]
\ys\pa
          key = name of keyword where frame or catalog entry will be stored in
\ap\pa
          frame = name of frame (syntax = nnnnn) (a) 
\\
                  or
\\
                  name of catalog (syntax = nnnnn.cat) (b)
\ap\pa
          indx = index into local keyword CATAL, only used with option (b);
\\
                 defaulted to 1, i.e. use CATAL(1)
\ap\pa
          exit_label = label to jump to on termination of catalog processing,
                 only used with option (b)
\ap\sa
See also:
          WRITE/KEYWORD, WRITE/SETUP, CREATE/ICAT, CREATE/TCAT, EXECUTE/CATALOG
\as\no
Note:   
          for (a) :
\\
             the command is the same as:  WRITE/KEYWORD key frame
\\
          for (b) :
\\
             the command has to be imbedded into a loop, e.g.:
\\ 
             (1)    DEFINE/LOCAL CATAL/I/1/1 0
\\
             (2)    CAT_LOOP:
\\
             (3)    STORE/FRAME IN_A astro.cat 1 FINITO
\\
             (4)    ....  commands using frames stored in key IN_A  ....
\\
             (5)    GOTO CAT_LOOP
\\
             (6)    FINITO:
\\
             (7)    ....  any other commands  ....
\\
             The local key CATAL is defined in line (1), it must be initialized
             to zero to indicate the start of the loop. In line (3) the next 
             entry in the specified catalog will be stored into IN_A. 
             This entry no. will be put into CATAL(1) and will be set to -1
              upon termination of the loop.
\\
             The type of the catalog will determine if images, tables or fit 
             files are stored in the keyword IN_A.
\\
             As long as you do not create output frames when processing the
             different entries of a catalog, looping over a catalog is very 
             simple.
             However, if you do create new frames you also need a scheme for
             naming these result frames. Then you should use the command
             "WRITE/SETUP catalog" to specify such a naming scheme as well as
             some other flags you can toggle. The command "INFO/SETUP catalog"
             gives the detailed information about how to do this.
\\
             If the stuff above seems too complicated, look into the command
             EXECUTE/CATALOG which loops over catalogs.
\on\exs
Examples:
\ex
          see above
\xe \sxe
