Quasar Files

Action Option -MV (-MoveFile) :

relocates archived files — across datasets, between groups, or to a new name. One or more files may be moved per execution.

When a file’s name or path changes, dsarch retains the original name in GDEXDB as a linked alias pointing to the new name.

Files can also be converted between types (Web to Saved or Saved to Web) using -TS (-ToSaved) or -TW (-ToWeb).

dsarch [-(DS|Dataset)] dNNNNNN -(MV|MoveFile) [Mode Options]

[-(OD|OriginDataset) OriginalDataset]
[-(RF|OriginFile) OriginalSavedFileNames]
-(SF|SavedFile) SavedFileNames
[-(OG|OriginGroup) OriginalGroupIndices]
[-(GI|GroupIndex) NewGroupIndices]
[-(OT|OriginType) OriginalFileTypes]
[-(ST|SavedFileType) NewSavedFileTypes]
[-(LC|Location) StorageLocationFlags]
[-(DD|DeleteDir) DeleteDirLevel]
[-(LN|LoginName) LoginAccountName]
[-(DB|Debug) DebugModeInfo]

or

dsarch [-(DS|Dataset)] dNNNNNN -(MV|MoveFile) [Mode Options]

[-(OD|OriginDataset) OriginalDataset]
[-(RF|OriginFile) OriginalWebFileNames]
-(WF|WebFile) WebFileNames
[-(OG|OriginGroup) OriginalGroupIndices]
[-(GI|GroupIndex) NewGroupIndices]
[-(OT|OriginType) OriginalFileTypes]
[-(WT|WebFileType) NewWebFileTypes]
[-(LC|Location) StorageLocationFlags]
[-(DD|DeleteDir) DeleteDirLevel]
[-(LN|LoginName) LoginAccountName]
[-(DB|Debug) DebugModeInfo]

or

dsarch [-(DS|Dataset)] dNNNNNN -(MV|MoveFile) [Mode Options]

[-(OD|OriginDataset) OriginalDataset]
[-(RF|OriginFile) OriginalHelpFileNames]
-(HF|HelpFile) HelpFileNames
[-(OT|OriginType) OriginalFileTypes]
[-(HT|HelpFileType) NewHelpFileTypes]
[-(LC|Location) StorageLocationFlags]
[-(DD|DeleteDir) DeleteDirLevel]
[-(LN|LoginName) LoginAccountName]
[-(DB|Debug) DebugModeInfo]

or

dsarch [-(DS|Dataset)] dNNNNNN -(MV|MoveFile) [Mode Options]

[-(OD|OriginDataset) OriginalDataset]
[-(RF|OriginFile) OriginalQuasarFileNames]
-(QF|QuasarFile) QuasarFileNames
[-(OT|OriginType) OriginalFileTypes]
[-(QT|QuasarFileType) NewQuasarFileTypes]
[-(LN|LoginName) LoginAccountName]
[-(DB|Debug) DebugModeInfo]

or

dsarch [-(DS|Dataset)] dNNNNNN -(MV|MoveFile) [-TS]

[-(OD|OriginDataset) OriginalDataset]
[-(OG|OriginGroup) OriginalGroupIndices]
[-(WF|WebFile) WebFileNames]
[-(SF|SavedFile) SavedFileNames]
[-(GI|GroupIndex) NewGroupIndices]
[-(WT|WebFileType) WebFileTypes]
[-(ST|SavedFileType) NewSavedFileTypes]
[-(LC|Location) StorageLocationFlags]
[-(DD|DeleteDir) DeleteDirLevel]
[-(LN|LoginName) LoginAccountName]
[-(DB|Debug) DebugModeInfo]

Available mode options:

-(MD\|MyDataset)	allows any specialist to set GDEXDB information, regardless of dataset ownership
-(NT\|NoTrim)	skips trimming of spaces and comments from input values, speeding up input file processing
-(NE\|NoEmail)	suppresses email notification on failure
-(TS\|ToSaved)	moves Web files to Saved files
-(TW\|ToWeb)	moves Saved files to Web files
-(KM\|KeepMetadata)	used with -TW to retain the metadata record after the Web file is moved to a Saved file

Provide the file names to move via -SF, -WF, -HF, or -QF. Files are physically moved only when the new path differs from the original. Dataset links are updated to the new dataset number, and group indices are updated if -GI (-GroupIndex) is specified.

If content metadata exists for the original Web file, it is automatically transferred to the new file name via rcm.

If a DOI/Version-controlled Web file is renamed or converted to a Saved file, its type is automatically set to ‘V’ (Version-controlled).

Back to Top

Back to Table of Contents