3.2.2 - Get Version Control

      Action Option -GV (-GetVersion) :

      retrieves DOI/Version control information from RDADB for a given dataset number.

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

      Mode option that can be specified for getting DOI/Version control Action:

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

      Valid version control field names and their corresponding Info options:

      -(FO|FormatOutput)format the column output with a same width for all values of a given field
      NamesInfo OptionsDescriptions
      V-(VI|VersionIndex)version control index
      I-(IV|InternalVersion)Internal version number
      E-(EV|ExternalVersion)External version number to publish
      D-(DN|DOINumber)DOI number created for the version control
      S-(VT|VersionStatus)version control status, A-Active, P-Pending and H-History
      J-(BD|BeginDate)date the version control starts at
      K-(BT|BeginTime)time the version control starts at
      X-(ED|EndDate)date the terminated version control ends by
      Y-(ET|EndTime)time the terminated version control ends by
      N-(DE|Description)note for the version control record

      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 4.

      Get Version Control Information Of Ds132.0 For All Fields And Dump The output into file 'ds132.0.vrsn'

      dsarch132.0 GV -FN ALL -OF ds132.0.vrsn

      Content of output file ds132.0.vrn:

      Dataset<=>ds132.0
      VersionIndex<:>InternalVersion<:>ExternalVersion<:>DOINumber<:>VersionStatus<:>BeginDate<:>BeginTime<:>EndDate<:>EndTime<:>Description<:>
      9<:>1<:><:>10.5065/D6SQ8XDW<:>A<:>2013-03-04<:>14:38:44<:><:><:><:>



      Back to Top