store_dir [-cvGEN_FLAGS] series=<series_name> dirname=<prefix>/<subdir> sel=<sel_text> [note=<note_text>]
If the series series_name does not exist, store_dir - store a directory of files to SUMS will first create that series, provided that the user supplies the -c flag. store_dir - store a directory of files to SUMS then creates a record in the series series_name and creates a subdirectory, subdir, in the record's SUMS directory (for each record there is a single SUMS directory). store_dir - store a directory of files to SUMS copies all files from prefix/subdir to subdir in the record's SUMS directory. It also stores prefix/subdir in the record's dirname keyword value so that retrieve_dir - retrieve a directory from SUMS can locate the subdirectory within the SUMS directory that contains the files.
sel=sel_text and note=note_text allow the user to link additional information to the record to facilitate the subsequent search for files in the series. They set the record's sel and note keywords to have the values sel_text and note_text, respectively. In particular, sel can be used to differentiate between multiple calls to store_dir - store a directory of files to SUMS with the same value for prefix/subdir. series_name must contain prime keywords dirname and sel, and it should contain the keyword note.
If a keyword named DATE is present, the current date will be stored as a standard DRMS time. The template for automatic series generation includes DATE as a time keyword. NOTE that DATE is not included as a prime key so the records must still be distinguised by sel and dirname
-c: Silently create the series series_name if it does not exist.
-v: Run in verbose mode.
|series_name||Specifies the series, series_name, to which the file-referring record will be added. Should a record-set specifier be provided, it will be ignored.|
|prefix/subdir||The local full path that contains the files to be stored in SUMS. The record created will contain a prime keyword named dirname whose value will be prefix/subdir.|
|sel_text||Contains a string that will be the keyword value for the sel prime keyword of the record created. This extra prime keyword facilitates selection between multiple records containing equivalent values for the dirname (it may be desirable to save files in the same directly repeatedly, or save the same file over time).|
|note_text||An optional string that will be the keyword value for the note keyword of the record created.|
store_dir series=su_arta.TestStoreDir dirname=/auto/home2/arta/savedFilesJanuary sel=January note="All my January work"