3.4.9 - Archive Saved Files

Action Option -AS (-ArchiveSavedFile) (Aliases: -ArchiveSaved, -ArchSaved, -ArchSavedFile) :

(Alias: -ArchiveSaved|-ArchSaved|-ArchSavedFile), copies local files to the GDEX Server as Saved files and registers them in GDEXDB. One or more files may be archived per execution.

dsarch [-(DS|dataset)] dNNNNNN -(AS|ArchiveSavedFile) [Mode Options]

[-(LF|LocalFile) LocalFileNames]

[-(LD|LocalDirectory) LocalDirectoryName]

[-(LL|LocalFileList) LocalFileListName]

[-(SF|SavedFile) SavedFileNames]

[-(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) DataFormat]

[-(AF|ArchiveFormat) FileArchiveFormat]

[-(DO|DisplayOrder) DisplayOrderIndices]

[-(SZ|Size) FileSizes]

[-(MC|MD5Checksum) MD5ChecksumValues]

[-(DE|Description) SavedFileDescriptions]

[-(VS|ValidSize) MinSizeForValidFile]

[-(LN|LoginName) LoginAccountName]

[-(AL|AsyncLimit) AsyncProcessLimit]

[-(QS|QsubOptions) PBSBatchOptions]

[-(BP|BatchProcess) [BatchControlInfo]]

[-(DD|DeleteDir) DeleteLocalDirLevel]

[-(DB|Debug) DebugModeInfo]

Available mode options:

-(BG|BackGround)	runs in background; suppresses screen output and errors
-(CL|CleanLocal)	removes local files after all are successfully archived
-(EM|EMailNotice)	sends an email summary (including any errors) when the action completes or aborts
-(GZ|GMTZone)	uses GMT rather than local time for archiving timestamps
-(KP|KeepLocalPath)	uses local file paths as relative paths on the GDEX Server
-(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
-(OE|OverrideExist)	overwrites existing Saved files
-(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
-(UZ|UnzipData)	decompresses files using ‘gunzip’, ‘uncompress’, ‘unzip’, or ‘bunzip’ according to the extension: ‘.gz’, ‘.Z’, ‘.zip’, or ‘.bz2’, respectively
-(XC|CrossCopy)	copies files from existing Saved/Object storage to fill missing Object/Saved copies, using GDEXDB records for guidance
-(XM|CrossMove)	moves files from existing Saved/Object storage to fill missing Object/Saved copies (originals are removed)
-(ZD|ZipData)	compresses files using ‘gzip’, ‘compress’, ‘zip’, or ‘bzip’ according to the archive format (‘GZ’, ‘Z’, ‘ZIP’, or ‘BZ2’) given via -AF (-ArchiveFormat)

Local file names are provided via -LF (-LocalFile). On the command line, ‘*’ and ‘?’ wildcards are supported. Files not in the current directory must include relative or absolute paths. If a directory is given via -LD (-LocalDirectory), files are gathered recursively from that tree.

Local file names are used as Saved file names by default unless -SF (-SavedFile) is given explicitly. Files are archived under the dataset home directory; use -SP (-SavedPath) or the path stored in GDEXDB to override. When -KP (-KeepLocalPath) is specified, local file paths are used as-is on the GDEX Server and -SP is not permitted.

Assign files to a group via -GI (-GroupIndex) or -GN (-GroupName). If no group is specified, pattern matching against group patterns saved via -SG is attempted when -PO (-PatternOffset) is present or the file is not yet in GDEXDB. Unmatched files default to group index 0 (no group).

The number of values supplied to Info options must match the number of local file names, except for options that accept a single shared value: -GI, -DF, -AF, -ST (-SavedFileType), and -SP.

The storage location is set via -LC (-Location). Defaults to ‘G’ (Glade Disk only).

Back to Top

Back to Table of Contents