M_PUT Name
      
       M_PUT Purpose
      
       Save a value by a tag name in a global area.
Category
Calling Sequence
      
       m_put, tag, val Inputs
             tag = Tag name for value.   in
                  (spaces converted to _)
              val = Value to save.        in
        
         Any IDL data item, scalars, arrays, structures,
                  even objects.
Keyword Parameters
Keywords
        
         AREA=aname Name of area to use (def="DEFAULT").
          
           Limit of 9 named areas (plus default area).
                      (spaces converted to _)
        
         DEFAULT=area Name of area to default to instead
          
           of "DEFAULT".  Later calls to m_put, m_list, or
          
           m_get will use this default area instead of "DEFAULT".
          
           To clear back to the normal default, call with
          
           DEFAULT="DEFAULT".  The default keyword will work on
                      any of the m_* routines.
                  /CLEAR clear an area or a tag.
          
           If a tag name is given that tag wil be cleared in
          
           the default or specified area.  If tag name is not
          
           given then the specified area will be cleared.
                  ERROR=err Error flag: 0=ok.
                  /QUIET inhibit error messages.
Outputs
Common Blocks
      
       m_put_common Notes
      
       Notes: This routine is used to save values under given
      
       names to be retrieved later using m_get.  m_get may be
      
       used in another routine, no values need be passed to it.
      
       Values are saved in areas, there are 10 such areas, one
      
       default area and 9 which are specified by an area name.
      
       If an area name is not given the default area is used.
      
       The name "default" (case ignored) will use the default area.
               
      
       Use m_get or m_fun to retrieve items from a global area,
        
         m_list to list items in the global areas.
Modification History
      
       R. Sterner, 2004 May 05 
  
 Copyright (C) 2004, Johns Hopkins University/Applied Physics Laboratory
  
 This software may be used, copied, or redistributed as long as it is not
  
 sold and this copyright notice is reproduced on each copy made.  This
  
 routine is provided as is without any express or implied warranties
  
 whatsoever.  Other limitations apply as described in the file disclaimer.txt.