5.1 - Single-Value Info Options
A single-value Info option accepts exactly one value. Providing no value or more than one causes an error.
Info Option -AL (-AsyncLimit) (Alias: -AsynchronousLimit) :
caps the number of simultaneous background processes spawned for ‘cp’ and gatherxml calls. Has no effect when running as a PBS batch job.
Info Option -AO (-ActionOption) (Alias: -ActOption) :
the token that marks Action and Mode options in input files. Defaults to ‘<!>’. Change this if your input data contains the default token.
Info Option -DD (-DeleteDir) (Aliases: -DeleteDirLevel, -DeleteEmptyDir) :
how many levels of empty parent directories to prune after files are deleted or moved. Applies to -DL, -MV, and -CL (when used with -AS or -AW).
Info Option -DS (-Dataset) (Aliases: -Dsid, -DatasetID) :
the target dataset ID (format: [a-z]NNNNNN). Required by almost all actions.
Info Option -DV (-Divider) (Aliases: -Delimiter, -Separater) :
the column separator used for multi-value Info options in input files. Defaults to ‘<:>’.
Info Option -ES (-EqualSign) :
the token used to assign a value to an option in input files (e.g., ‘Dataset<=>d123456’). Defaults to ‘<=>’.
Info Option -FL (-FileLimit) (Alias: -FileCountLimit) :
the file count threshold for static file list pages. Groups whose combined count falls below this limit are shown together on one page; a group whose count exceeds it is split across multiple sub-pages. Defaults to 2000.
Info Option -FN (-FieldNames) :
a compact string of single-letter codes that selects which fields to include in GET action output. Default codes are listed in each action’s section; use ALL to retrieve every available field.
Info Option -LD (-LocalDirectory) :
a local directory to source files from. All files within it and any sub-directories are collected recursively.
Info Option -LL (-LocalFileList) (Alias: -LocalList) :
a plain-text file listing local file names to process, one name per line.
Info Option -LN (-LoginName) :
the login name to attribute the action to. Defaults to the current user. Use this when running on behalf of another specialist or from an automated process (daemon or cron job). Use with care — it affects which records are updated under that specialist’s name.
Info Option -OF (-OutputFile) :
redirects output to a file instead of the screen. The file format is compatible with dsarch input files.
Info Option -ON (-OrderNames) :
a string of single-letter field codes controlling the sort order of GET action results (-GG, -GS, -GW, -GH, -GQ). Uppercase means ascending; lowercase means descending. When file records are modified via -AS, -AW, -SS, -SW, -DL, or -MV, files in affected groups are reordered too.
EXAMPLE 11. To reorder an existing file list without other changes, use -SW with -ON:
dsarch dNNNNNN -SW -ON OrderNameString [-GI GroupIndices]
Without group indices, reordering applies to all files in the dataset.
Info Option -PO (-PatternOffset) :
controls how dsarch matches file names against group patterns to auto-assign group indices. A value >= 0 uses binary search (faster, for large sorted lists); -1 uses linear search. Required when matching files already registered in GDEXDB; defaults to -1 for new files.
Info Option -QS (-QsubOptions) (Alias: -PBSOptions) :
passes options to qsub when running dsarch as a PBS batch job. Quote the value on the command line, e.g., -QS ‘-l walltime=12:00:00’.
Info Option -UD (-UseDSARCH) (Alias: -UseRDADB) :
the gating flag that controls dsarch access to a dataset. Set via -SD (-SetDataset). Values:
‘N’ |
disabled (default; blocks all dsarch writes) |
‘Y’ |
enabled for modification |
‘I’ |
enabled for internal users only |
‘P’ |
enabled and file lists are published publicly |
‘W’ |
file list publication only |
Any value except ‘N’ must be set before dsarch can write to GDEXDB.
Info Option -VS (-ValidSize) :
the minimum acceptable file size (in bytes) for archiving. Files smaller than this threshold are rejected. Defaults to 100.
Info Option -WI (-WaitInternval) :
how long dsarch waits before rechecking whether a background process slot has freed up (see -AL). Units: