3.4.1 - Set Saved File Information

Action Option -SS (-SetSavedFile) (Alias: -SetSaved) :

creates new or updates existing Saved file records in GDEXDB for the specified dataset. Multiple records can be processed in a single run.

dsarch [-(DS|Dataset)] dNNNNNN [-](SS|SetSavedFile) [Mode Options]
[-(SF|SavedFile) SavedFileNames]
[-(ON|OrderNames) OrderNameString]
[-(OB|OrderBy) OrderByPattern]
[-(GI|GroupIndex) GroupIndices]
[-(GN|GroupName) GroupNames]
[-(TG|TopGroupIndex) TopGroupIndices]
[-(PO|PatternOffset) PatternStringOffset]
[-(ST|SavedFileType) SavedFileTypes]
[-(FS|FileStatus) SavedFileStatus]
[-(FF|FileFlag) FilesOrPaths]
[-(LC|Location) StorageLocationFlags]
[-(DF|DataFormat) DataFormats]
[-(AF|ArchiveFormat) FileArchiveFormats]
[-(DO|DisplayOrder) DisplayOrderIndices]
[-(SZ|Size) FileSizes]
[-(MC|MD5Checksum) MD5ChecksumValues]
[-(FD|FileDate) DateModified]
[-(FT|FileTime) TimeModified]
[-(DE|Description) SavedFileDescriptions]
[-(LN|LoginName) LoginAccountName]
[-(QS|QsubOptions) PBSBatchOptions]
[-(BP|BatchProcess) [BatchControlInfo]]
[-(DB|Debug) DebugModeInfo]

Available mode options:

-(BG|BackGround)

runs in background; suppresses screen output and errors

-(EM|EMailNotice)

sends an email summary (including any errors) when the action completes or aborts

-(MD|MyDataset)

allows any specialist to set GDEXDB information, regardless of dataset ownership

-(NE|NoEmail)

suppresses email notification on failure

-(NT|NoTrim)

skips trimming of spaces and comments from input values, speeding up input file processing

-(RD|RemoveDir)

removes empty directories after file changes

-(RO|ResetOrder)

resets display order indices to match the order files are given per -SF. Alternatively, use -ON (-OrderNames) to reorder all files in the dataset and affected groups

-(SC|SetChecksum)

computes MD5 checksums for files on the GDEX Server and saves them to GDEXDB

Saved file names must be provided via -SF (-SavedFile) unless -ON (-OrderNames) is used to reorder files. The number of values supplied to other Info options must match the number of file names, except for options that accept a single shared value, such as -GI (-GroupIndex), -AF (-ArchiveFormat), -DF (-DataFormat), and -ST (-SavedFileType).

If no group index is specified and -PO (-PatternOffset) is present, file names are matched against group patterns saved via -SG (-SetGroup) to determine the group index automatically.