3.4.2 - Get Saved File Information

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

      gets information of data files on Saved Server for a given dataset and/or specified Saved file names. The list of data files can be further specified for given group indices, file archive types, and other conditions.

      dsarch[-(DS|Dataset)] dsnnn.n -(GS|GetSavedFile) [Mode Options]
        [-(FN|FieldNames) FieldNameString]
        [-(ON|OrderNames) OrderNameString]
        [-(OB|OrderBy) OrderByPattern]
        [-(SF|SavedFile) SavedFileNames]
        [-(ST|SavedFileType) SavedFileTypes]
        [-(FS|FileStatus) SavedFileStatus]
        [-(LC|Location) StorageLocationFlags]
        [-(GI|GroupIndex) GroupIndices]
        [-(GN|GroupName) GroupNames]
        [-(TG|TopGroupIndex) TopGroupIndices]
        [-(DE|Description) SavedFileDescriptions]
        [(-OF|-OutputFile) OutputFileName]
        [-(DB|Debug) DebugModeInfo]

      Mode options that can be specified for getting Saved file action:

      Use Info option -FN (-FieldNames) to specify what fields of file on Saved Server to retrieve. It defaults to 'FINMTHS' if option -FN is not provided; information of all available fields is retrieved if -FN ALL is given.

      Valid Saved file field names and their corresponding Info options:

      -(RG|REcursiveGroup)gather files in subgroups recursively for given group index
      -(RN|RelativeName)retrieves Saved file names with paths relative to
      -(RN|RelativeName)retrieves Saved file names with paths relative to saved paths for groups or dataset
      NamesInfo OptionsDescriptions
      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 backyp file types
      L-(LC|Location)Saved file storage location flag
      H-(FS|FileStatus)Saved file archiving status
      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

      The dataset number per option -DS (-Dataset) is mandatory unless Saved file names are provided. An error message is prompted for specialist to pick one dataset number and rerun 'dsarch' if multiple datasets are identified for given Saved file information without specified dataset number. Saved file names are expanded automatically to include full paths relative to the dataset Saved Home Directories if the file names are given without or with incomplete paths.

      Saved file information can be retrieved for further specified file archive types per option -ST (-SavedFileType), groups per option -GI (-GroupIndex) or -GN (-GroupName), and Saved file descriptions per -DE (-Description). Info options -SF, -GN and -DE accept wildcard inputs of '%' for matching any number of characters.



      Back to Top