3.2.6 - Get Request File information

      Action Option -GF (-GetFile) :

      retrieves data file information for specified requests or partitions.

      dsrqst-(GF|GetFile) [Mode Options]
        [-(FN|FieldNames) FieldNameString]
        [-(RI|RequestIndex) RequestIndices]
        [-(RN|RequestName) RequestNames]
        [-(PI|PartitionIndex) PartitionIndices]
        [-(TI|TarfileIndex) TarFileIndices]
        [-(DS|Dataset) dsnnn.n]
        [-(GI|GroupIndex) GroupIndices]
        [-(OT|SourceType) SourceDataType]
        [-(WF|WebFile) DataFileNames]
        [-(WT|WebType) DataFileTypes]
        [-(FS|FileStatus) DataFileStatus]
        [-(SZ|Size) DataFileSize]
        [-(DF|DataFormat) DataFormat]
        [-(AF|ArchiveFormat) DataArchiveFormat]
        [-(FD|FileDate) DateReadyOnline]
        [-(FT|FileTime) TimeReadyOnline]
        [-(OF|OutputFile) OutputFileName]
        [-(DB|Debug) DebugModeInfo]

      Mode options that can be specified for getting request Action:

      Use Info option -FN (-FieldNames) to specify what data file fields to be retrieved. It defaults to 'FRPTYSNMA' if option -FN is not provided. Data File information of all available fields is retrieved if -FN ALL is given.

      Valid field names of data files and their corresponding Info option names:

      -(WD|WithDataset)show Dataset ID for each request file
      -(WD|WithDataset)show Dataset ID for each request file
      NamesInfo OptionsDescriptions
      R-(RI|ReuqstIndex)data request index
      Q-(RN|RequestName)request name/ID
      P-(PI|ParitionIndex)request partition index
      T-(TI|TarfileIndex)tarfile index for this small file is tarred
      I-(GI|GroupIndex)group index
      B-(DS|Dataset)dataset name/ID, dsnnn.n
      L-(SL|SourceLink)source file name
      Z-(OT|SourceType)source data type, M - HPSS, W - Web
      Y-(WT|WebFileType)file type, Data, dOcument, Software
      F-(WF|WebFile)file name online
      A-(FS|FileStatus)file status, R - requested, O - online
      S-(SZ|Size)data file size
      C-(PC|ProcessCommand)command to process this reuqest file
      M-(DF|DataFormat)data format, i.e. GRIB, NetCDF
      N-(AF|ArchiveFormat)archive format, i.e. TAR, GZ
      O-(DO|DisplayOrder)order the file shown on webpage
      J-(TR|TimeReady)time request processed
      K-(FD|FileDate)date data file ready online
      Y-(FT|FileTime)time data file ready online
      D-(DE|Description)description of this file

      Data file information can be retrieved for specified request indices per option -RI (-RequestIndex) or partition indices per option -PI (-PartitionIndex).

      Status of a data file record is initially set to 'R' as requested at the time a request is submitted. It is changed to 'O' as online after the request is processed and the data file is staged online for download. If a copy of the same data file is online already for another request, this data file is shared instead of a new copy is staged.


      EXAMPLE 7.

      To Get The Data File Information Of Partition Index 42 For Default fields

      dsrqstGF -PI 13

      Content of the output:

      WebFile<:>RequestIndex<:>PartitionIndex<:>Size<:>ArchiveFormat<:>DataFormat<:>FileStatus<:>
      godas.P.198306.tar<:>61160<:>13<:>196544000<:>GZ.TAR<:>GRIB1<:>O<:>
      ...



      Back to Top