3.4.2 - Get Saved File Information

Action Option -GS (-GetSavedFile) (Alias: -GetSaved) :

retrieves Saved file records from GDEXDB for the specified dataset, optionally filtered by file name.

dsarch [-(DS|Dataset)] dNNNNNN -(GS|GetSavedFile) [Mode Options]

[-(FN|FieldNames) FieldNameString]

[-(ON|OrderNames) OrderNameString]

[-(OB|OrderBy) OrderByPattern]

[-(SF|SavedFile) SavedFileNames]

[-(ST|SavedFileType) SavedFileTypes]

[-(FS|FileStatus) SavedFileStatus]

[-(FF|FileFlag) FilesOrPaths]

[-(LC|Location) StorageLocationFlags]

[-(GI|GroupIndex) GroupIndices]

[-(GN|GroupName) GroupNames]

[-(TG|TopGroupIndex) TopGroupIndices]

[-(DE|Description) SavedFileDescriptions]

[-(OF|OutputFile) OutputFileName]

[-(DB|Debug) DebugModeInfo]

Available mode options:

-(FO|FormatOutput)	formats each column to a uniform fixed width
-(RG|RecursiveGroup)	gathers files in subgroups recursively for a given group index
-(RN|RelativeName)	returns file names with paths relative to the Saved path of the dataset or group

Use -FN (-FieldNames) to specify which Saved file fields to retrieve. Defaults to ‘FINMTHS’. Use -FN ALL for all available fields.

Valid Saved file field names and their corresponding Info options:

Names	Info Options	Descriptions
F	-(SF|SavedFile)	Saved file names with relative paths
T	-(ST|SavedFileType)	Saved file archiving types
C	-(MC|MD5Checksum)	Saved file MD5 Checksum
I	-(GI|GroupIndex)	group indices for Saved files
X	-(TG|TopGroupIndex)	top group indices for Saved files
V	-(VI|VersionIndex)	Version control index
N	-(DF|DataFormat)	data content formats
M	-(AF|ArchiveFormat)	file archive formats
O	-(DO|DisplayOrder)	display order indices
B	-(QF|QuasarFile)	Quasar backup file names
Q	-(QT|QuasarType)	Quasar backup file types
L	-(LC|Location)	Saved file storage location flag
H	-(FS|FileStatus)	Saved file archiving status
P	-(FF|FileFlag)	File type flag, File or Path
S	-(SZ|Size)	Saved file sizes
J	-(FD|FileDate)	date data last modified on
K	-(FT|FileTime)	time data last modified at
D	-(DE|Description)	Saved file descriptions

A dataset number is required unless Saved file names are provided. If file names match multiple datasets and no dataset number is given, an error prompts the specialist to specify one and rerun. Incomplete file paths are expanded relative to the dataset Saved Home Directory.

Results can be filtered by archive type (-ST), group (-GI or -GN), and description (-DE). The -SF, -GN, and -DE options accept the ‘%’ wildcard.

Back to Top

Back to Table of Contents