A single-value Info option is used to pass one value into this application. One value, and one only, must follow a single-value option; otherwise an error message is displayed if no value or more than one value passed in.
provides a value of the maximum number of background processes for 'cp' and 'gatherxml' calls. This option is ignored for PBS batch jobs.
for setting Action and Mode options in input files. It is default to ''.
Info Option -BL (-ButtonLimit) :
controlling limit of available file count in filelist to show click buttons for download scripts. The default number is 2.
it works with Actions -DL (-Delete) or -MV (-MoveFile) for removing how many level of empty directories after all files inside are deleted or moved. It works with Mode option -CL too for Actions -AS and -AW to remove empty local directories after the local files inside of them are all cleaned.
for a dataset number, or called dataset ID or dataset name. It is mandatory for most actions.
delimiter for separating columns of multi-value Info options in input files. It is default to '<:>'.
Info Option -ES (-EqualSign) :
for an equal sign of assigning one value to either a single-value option or multi-value option in input files. It is defaulted to '<=>'.
sets limit for how many files can be displayed on a single web page of static filelists. Files from multiple groups may be displayed on a single page if the total file count is lower than this limit, while files from a single group may be split into sub-filelists if the file count is beyond this limit. It defaults to 2000 and specialists can reset it to a different value for a specified dataset via Action -SD (-SetDataset).
Info Option -FN (-FieldNames) :
for a string of single letter field names. Values of the selected fields are retrieved per actions -GD (-GetDataset), -GG (-GetGroup), -GS (-GetSavedFile), -GW (-GetWebFile), -GH (-GetHelpFile), and -GQ (-GetQuasarFile). Values of default fields are retrieved according to what GET action is specified. Valid field names are listed in corresponding Get action sections.
Info Option -LD (-LocalDirectory) :
provides a single local directory, file names under the directory, and the sub-directories recursively if any, are all collected as local files
provides a single file name and the file holds a list of file names, one file name on each line. These file names are used as the local file names
Info Option -LN (-LoginName) :
login name of the current user; it defaults to the current login DECS specialist who starts execution of 'dsarch'. Set this option if you try to run this utility for a specialist other than yourself. Normally this is set when this application is started by a daemon or as a cron job. Be careful of using this option since it might override the currently information of dataset/groups/files saved by other specialists in RDADB.
Info Option -OF (-OutputFile) :
leading an output file name into which the output result of this application is dumped. Output file format is similar to the format of the input files. If this option is not given, the result is displayed on screen.
Info Option -ON (-OrderNames) :
for a string of single letter field names use to order the results of GET actions, -GG (-GetGroup), -GS (-GetSavedFile), -GW (-GetWebFile), -GH (-GetHelpFile), and -GQ (-GetQuasarFile). Upper case is for Ascending order while lower case is for Descending order. This option also force reordering of files in individual groups if any file information is modified per Action options -AS (-ArchiveSavedFile), -AW (-ARchiveWebFile), -SS (-SetSavedFile), -SW (-SetWebFile), -DL (-DeleteFile) and -MV (MoveFile).
Web filelists of specified dataset and groups can also be accomplished per Action -SW (-SetWebFile) with presenting option -ON, as
dsarch | dsnnn.n -SW -ON OrderNameString [-GI GroupIndices] |
Without specified group indices, all the files within or without groups will all be reordered.
Info Option -PO (-PatternOffset) :
given for string offset of pattern matches while assigning group indices to given Saved or Web files by matches the file names to given group wildcard patterns for file set/archive actions. This is a mandatory Info option for matching group indices of files recorded in RDADB already. A binary search is used for pattern matching if an value of >= 0 is provided; while a simple linear search is used if a value of -1 is provided. Value of -1 is defaulted if this option is not provided for matching group index for a file that is not recorded in RDADB yet.
(Alias: -PBSOptions), specifies options to execute dsarch as a batch job via qsub on PBS nodes. The qsub options must be quoted when prsented on command line, such as, -QS '-l walltime=12:00:00'.
for setting Action and Mode options in input files. It is default to ''.
for flag of using DSARCH to control the given dataset. A value out of 'N', 'Y', 'I', 'P', or 'W' is saved in RDADB for a given dataset per action -SD (-SetDataset). A value other than 'N', at least 'Y', must be set for a dataset before it can manipulated by 'dsarch'. 'Y' means the the dataset is ready to be modified by 'dsarch'. 'I', 'P', and 'W' mean that the dataset/group/file information of the specified dataset is ready to be published to web server for internal only, publicly, and Web file list only, correspondingly.
Info Option -VS (-ValidSize) :
a minimal size for a file to be valid for archiving process. It defaults to 100 bytes and can be reset on command line with the update actions.
Info Option -WI (-WaitInternval) :
it works for the background processes. When the number of background processes reaches the process limit, this option value tells 'dsarch' to wait this period of time before checking if any background process is finish, so that a new background process can be started for next waiting one.
It can be provided to set a different wait interval, such as Second, Minute, Hour or Day. For example, '-WI 5M' is for 5 minutes. A digital value only assumes a unit of Second, and '-WI 300' means 300S, for example.