Use proper Mode options to modify behaviors of Action options. Mode options are all optional. No value is allowed to be passed in following any Mode option.
background process. When it presents screen display is turned off for both standard outputs and errors.
when present for archiving actions -AS, or -AW, cleans the local files after they are all archived successfully. If local files are staged temporarily in sub-directories, the sub-directories can be removed too after all the local files are cleaned inside them. Add Info option -DD DirectoryLevel to tell how many level of the local empty directories to be removed.
Mode Option -DX (-DeleteXML) :
if present, calls 'dcm' to delete file content metadata of given Web files for actions -SW (-SetWebFile). This is the default Mode for action -DL (-Delete) of Web files provided via -WF (-WebFile).
Mode Option -EM (-EmailNotice) :
sends an email notice to the specialist who executes the dsarch for certain actions after a action is finished successfully or aborts abnormally. The Actions working with this Mode option include -AS, -AW,, -AH, -AQ, -SS, -SW, -SH, -SQ, -RQ, -MV and -DL. An email notice includes errors happening during the action and a brief summary to show the action progress. This option is ignored if option -d is present.
Specialists need to be cautious of adding this Mode option to run dsarch. If you run dsarch to archive many files with one at a time, you will receive one email for each file. To make it work better, you include all the files you want to process into a single input file and run dsarch with option -EM against the input file. This way you receive a single email notice instead.
Mode Option -FO (-FormatOutput) :
if present, formats column output results for get actions. A same width, evaluated dynamically, is applied for all values of a given field.
if present, Action -AW (-ArchiveWebFile) will allow existing Web files being overridden although the data files are under DOI/Version control already. Normally an archived data file can not changed if it is linked to a version control record. This Mode option indicates that the data file is a growing one and needs to be updated. If Action -AW of 'dsarch' is controlled by configuration of 'dsupdt', a growing file is automatically detected and this Mode option is added to the 'dsarch' command as needed.
if present, calls 'gatherxml' to evaluate file content metadata of archived Web files. This is the default Mode for action -MV (-MoveFile) for Web files, to call 'rcm' to move the file content metadata too.
uses GMT dates/times as controlling times for archiving actions, instead of mountain time.
for actions -MV (-MoveFile) with option -TS (-ToSaved) to keep the metadata record for later use after the web file is moved to savefile.
-AW (-ArchiveWebFile) and -AH (-ArchiveHelpFile) to archive Saved/Web/Help files with the same file names as the local ones specified by -LF (-LocalFile). A relative path is reta8ined if it is part of a local file name. Options -SP (-SavedPath) and -WP (-WebPath) are ignored if -KP is given. This Mode option is ignored if Save/Web/Help file names are specified per options -SF (-SavedFile), -WF (-WebFile), and -HF (-HelpFile), respectively.
Mode Option -MD (-MyDataset) :
allows a specialist to update dataset/group/file
does not send email notice to the specialist for failed action.
skips trimming of spaces and comments from input values to speed up reading input file(s).
Mode Option -NV (-NewVersion) :
adds a new version control record for a specified dataset if this Mode option is present for Action -SV (-SetVersion).
Mode Option -OE (-OverrideExist) :
if present, overrides an existing file.
Mode Option -PE (-ShowPeriod) :
shows period information for dataset, and groups if provided, for action -SD (-SetDataset).
Mode Option -RA (-RetryArchive) :
deprecated, does not do anything.
it works with Actions -DL, -SS and -SW to remove empty directories for a specified dataset, and groups if specified.
If empty directories are not cleaned after deleting files. Use Actions -SS or -SW with this Mode option, without Saved or Web file names specified, to clean the empty Web or HPSS directories, respectively for a given dataset, and groups if specified.
when present, gathers subgroups and file information in subgroups recursively for actions -GG (-GetGroup) and -GS/GW (-GetSavedFile/GetWebfile), respectively. Group index must be provided explicitly via Info option -GI (-GroupIndex) for this Mode option to work.
for action -GS (-GetSavedFile) and -GW (-GetWebFile) to show a file name with path relative to the Saved and Web paths set for the dataset or group, respectively.
when present, resets the display orders of the given Saved/Web/Help/Quasar file lists as the orders the data files are given for actions -SS (-SetSavedFile), -SW (-SetWebFile), -SH (-SetHelpFile), and -SQ (-SetQuasarFile), respectively. Another way of reordering the data files is to provide explicitly order index values per Info option -DO (-DisplayOrder).
Specify what fields to order on per option -ON (-OrderNames) to order the files accord for the whole datasets or individual groups. Check option -ON for examples of ordering Files.
Mode Option -RS (-GXRSOptions) :
works with Mode option -GX (-GatherXML) to pass option R and S to command gatherxml for speeding up.
for setting actions to reset the top group index for Saved or Web files for dataset, and groups if specified.
Mode Option -SC (-SetChecksum) :
if presents, evaluates the md5 checksum values for data files on RDA Servers and saves them into RDADB
works with Action -AQ (-ArchiveQuasarFile) to tar the given Saved and/or Web files only, without physically backing up the Quasar file onto the Globus Quasar Server.
when present for Action -MV to move Web files to Saved files.
Mode Option -TT (-TotalSummary) :
when present, gets the statistic summary information for Action options -GS (-GetSavedFile) and -GW (-GetWebFile).
when present for Action -MV to move Saved files to Web files.
uncompresses online data with one of the uncompressing utilities, 'gunzip', 'uncompress', 'unzip' or 'bunzip', according to the file name extensions of ".gz', '.Z', '.zip' or '.bz2', respectively
when present, checks the MD5 checksums in addition to the data file sizes for online data files on RDA Server.
for setting actions to reset the dataset/group level content metadata for action -SD/SG (-SetDataset/SetGroup).
for setting actions to reevaluate and reset the Saved or Web file counts for dataset, and groups if specified. These file counts can also be viewed for action -GD (-GetDataset) if this Mode option is preset.
Mode Option -XC (-CrossCopy) :
works with action -AW/-AS to cross copy data files between Web/Saved files on Glade disk and Object files on Object store.
Mode Option -XM (-CrossMove) :
works with action -AW/-AS to cross move data files between Web/Saved files on Glade disk and Object files on Object store. This Mode option is different from -XC that the original files are removed.
when present, Actions -AS (-ArchiveSavedFile) and -AW (-ArchiveWebFile) compress online data with one of the compressing utilities, 'gzip', 'compress', 'zip' and 'bzip', according to the archiving format 'GZ', 'Z', 'ZIP' or 'BZ2' provided per option -AF (-ARchiveFormat), respectively. If the original data files are compressed already, this Mode option is ignored if the same compression, and the files are uncompressed, before compressing, with one of the uncompressing utilities, 'gunzip', 'uncompress', 'unzip' or 'bunzip', according to the file name extensions of ".gz', '.Z', '.zip' or '.bz2', respectively.