INGEST(1)

NAME

     ingest -  ingest a directory into the DSDS

SYNOPSIS

     ingest -pa in=... out=... [option= value]

DESCRIPTION

     ingest is simply a shell  front-end  to  the  (undocumented)
     ingest_svc module.

OPTIONS

     in=Dataset_Name     NO DEFAULT - should be a directory  name
                         terminated by "/".

     out=Dataset_Name    NO  DEFAULT  -  should  be  a  parseable
                         dataset name

     type=type_name      DEFAULT "misc" is probably the only  one
                         that ever makes sense

     T_FIRST=date_time   can be used to set  the  value  in  DSDS
                         only if the corresponding keyword cannot
                         be  found  in  an  overview.fits   file;
                         DEFAULT "unknown"

     T_LAST=date_time    can be used to set  the  value  in  DSDS
                         only if the corresponding keyword cannot
                         be  found  in  an  overview.fits   file;
                         DEFAULT "unknown"

     alloc=n             DEFAULT 100; space in MB required to  be
                         allocated in DSDS

     archive_hold=n      DEFAULT  -5;  number  of  days  to  hold
                         dataset  online; negative values inhibit
                         permanent archiving.

EXAMPLES

     ingest -pa out= prog:myprog,series:myser[0] in= /tmp/

     will recursively copy the contents of  /tmp  into  the  DSDS
     under  the  specified  dataset  name.   The dataset will (by
     default) be held online for 5 days and then purged.

FILES

SEE ALSO

     module (1)

DIAGNOSTICS

BUGS

     Files   named   history   and   ds.rdb   (and    conceivably
     ingest.XXX.map)  on  the root of the ingested directory tree
     will be overwritten by the ingest pe.

     When ingested, all files will be owned by user "production",
     with umask 644.  To preserve ownerships and protections (and
     root files named history), the  directory  should  first  be
     tar'd, and then the tar file can be ingested.

     Since the module makes no sense  outside  the  DSDS  archive
     services,  it would be better to have pa module flags set by
     default; the shell processor prevents this.

     A warning should be issued when  the  requested  archive  is
     temporary, which is the default.

AUTHOR

     Rick Bogart

HISTORY

     1997-09-09     SOI Version 3.4