Source Files

Release Notes

LSTGOOD (Jul95)              ftools.caltools             LSTGOOD (Jul95)



NAME
    LSTGOOD -- List "good" files found in a Calibration Index File
    
    
USAGE
    lstgood (ciffile)
    
    
DESCRIPTION
    This  task  will  run through a specified Calibration Index File and
    list (to  outfile)  the  full  pathname  of  each  calibration  file
    EXTENSION  which  is flagged as ONLINE and of good quality.  The CIF
    can be named on the command line (eg, ciffile=mycif)  otherwise  the
    user will be prompted for the desired mission and instrument.
    
    
PARAMETERS
    
    mission [string]
        The  name  of  the mission for which selected datasets should be
        valid.  Only prompted for if ciffile not equal to "CALDB".
    
    instrument [string]
        The name of the  instrument  for  which  the  selected  datasets
        should  be  valid.   Only  prompted  for if ciffile not equal to
        "CALDB".
    
    outfile = STDOUT [string]
        The name of the output ASCII file.  If outfile =  'STDOUT'  then
        the  output  will  be  written  to  the  standard  output device
        (usually the users terminal) rather than  to  a  file.   If  the
        first  character  of  outfile is !, an existing file of the same
        name will be overwritten.
    
    (ciffile = CALDB) [string]
        The name of the CIF to be used.  This parameter is set to  CALDB
        by  default,  whereupon  the  environment variables/VMS logicals
        are used to locate the caldb.config file (and  the  mission  and
        instrument parameters are ignored).
    
    (page = no) [boolean]
        If  true,  and  if the output is sent to STDOUT, the output will
        be paged, so that user is prompted after every 24 lines.
    
    (clobber = no) [boolean]
        Whether to overwrite an existing output file. Can be  overridden
        by using !filename.
    
    (more = yes) [boolean]
        Whether  to  continue  paging, or just quit at this point.  This
        parameter should not be entered on  the  command  line,  and  is
        only used for output to the screen.
    
    
EXAMPLES
    1.  List good files for a CIF listed in the caldb.config file
    
     ca> lstgood mission=asca instrument=sis0 outfile=asca.good
    
    2.  List good files from a CIF called cif.temp
    
     ca> lstgood ciffile=cif.temp outfile=tmp.out
    
    
BUGS
    
    
LOG OF SIGNIFICANT CHANGES
    
    
    
    v1.0.0 (1995 Jul)
            original  version  (Mike  Tripicco)      v1.1.0  (1997  Jan) 
            adapted to account for file extensions (Lorraine Breedon)
    
    
    
SEE ALSO
    chkcif, crcif, quzcif