3.1.2 - Get Dataset Information

      Action Option -GD (-GetDataset) :

      retrieves dataset information from RDADB for a given dataset number.

      dsarch[-(DS|Dataset)] dsnnn.n [-](GD|GetDataset) [Mode Options]
        [-(FN|FieldNames) FieldNameString]
        [-(KV|KeyValue) KeyNames]
        [-(OF|OutputFile) OutputFileName]
        [-(DB|Debug) DebugModeInfo]

      Mode options that can be specified for getting dataset Action:

      Use Info option -FN (-FieldNames) to specify what dataset fields to retrieve. It defaults to 'SWFULQ' if option -FN is omitted. Information of all available fields is retrieved if -FN ALL is given.

      Valid dataset field names and their corresponding Info options:

      -(PE|ShowPeriod)show associated period information for dataset, and
      -(WN|WithFileNumber)gathers and displays Saved/Web file counts
      -(WN|WithFileNumber)gathers and displays Saved/Web file counts
      NamesInfo OptionsDescriptions
      T-(TI|Title)dataset title
      S-(SP|SavedPath)path relative to Saved home directory
      H-(WH|WebHome)path for the web data home directory
      W-(WP|WebPath)path relative to web home directory
      F-(DF|DataFormat)default data content format
      U-(UD|UseDSARCH)use DSARCH flag
      L-(LC|Location)Online web file access location flags
      Q-(BF|BackupFlag)Quasar Backup flags
      V-(GL|GroupLevel)number of group levels to display
      C-(FL|FileLimit)file count limit for separate group filelists
      B-(BL|ButtonLimit)file count limit for showing script buttons
      A-(ML|MetaLink)a link to content meta at the dataset level
      W-(NW|NoteWeb)web data description
      I-(NI|NoteInternal)internal data description
      D-(ND|NoteDocument)document description
      N-(NS|NoteSoftware)software description
      G-(GI|GroupIndex)Group Indices to identify groups for periods
      J-(BD|BeginDate)date data begin for dataset/group
      K-(BT|BeginTime)time data begin for dataset/group
      X-(ED|EndDate)date data end for dataset/group
      Y-(ET|EndTime)time data end for dataset/group

      Info option -OF (-OutputFile) is used to specify a file name to save the retrieved information for later usage. Result of this action is displayed on screen if no output file is provided.


      EXAMPLE 2.

      Get Dataset Information Of Ds260.1 For All Fields And Dump The output into file 'ds260.1.ds'

      dsarch260.1 GD -FN ALL -PE -OF ds260.1.ds

      Content of output file ds260.1.ds:

      Dataset<=>ds260.1
      Title<=>Objectively Analyzed Air-Sea Fluxes (OAFlux) For Global Oceans, By Lisan Yu et al.
      SavedPath<=>
      WebPath<=>
      Location<=>G
      DataFormat<=>
      UseDSARCH<=>P
      GroupLevel<=>3
      FileLimit<=>500
      ButtonLimit<=>2
      DescWeb<=>
      DescInternal<=>
      GroupIndex<:>BeginDate<:>EndDate<:>BeginTime<:>EndTime<:>
      1<:>1985-01-01<:>2006-12-31<:>00:00:00<:>00:00:59<:>
      2<:>1958-01-01<:>2006-12-31<:>00:00:00<:>00:00:59<:>



      Back to Top