3.2.1 - Set Version Control

      Action Option -SV (-SetVersion) :

      adds and modifies DOI/Version controls for a given dataset number.

      dsarch[-(DS|Dataset)] dsnnn.n [-](SV|SetVersion) [Mode Options]
        [-(VI|VersionIndex) VersionIndex]
        [-(IV|InternalVersion) InternalVersionIndex]
        [-(EV|ExternalVersion) AssignedVersionNumber]
        [-(DN|DOINumber) DOInumber]
        [-(VT|VersionStatus) VersionRecordStatus]
        [-(BD|BeginDate) VersionStartdate]
        [-(BT|BeginTime) VersionStartTime]
        [-(ED|EndDate) VersionEnddate]
        [-(ET|EndTime) VersionEndTime]
        [-(DE|Description) VersionNote]

      Mode options that can be specified for setting DOI/Version control action:

      If a version index is given and it is in RDADB already, its record is modified. A new version control record is added if version control index is not given or it is 0 and Mode option -NV (-NewVersion) is present.

      When a version control record is first added into RDADB without DOI number specified, it is in status of Pending. It can only be changed to Active if a DOI number is provided. An active version control record is added with a new DOI number and a version control index is auto-generated.


      EXAMPLE 3.

      Put Dataset Ds999.9 Under Doi/Version Control

      -(NT|NoTrim)skips trimming of spaces and comments from input
      -(NV|NewVersion)adds a new version control record into RDADB
      -(NV|NewVersion)adds a new version control record into RDADB
      dsarchds999.9 SV -NV -DN DOINumber

      If the data of ds999.9 are updated mostly or completely to a newer version (set of files) a new DOI number is needed. You may execute the same 'dsarch' command to add another new active version control record with a new DOI number. The previous version control record is changed automatically to status of History and its DOI number is superseded now by the current DOI number. Only one active version control record can exist for a give dataset.

      If the data of ds999.9 are modified minimally a new internal version index is needed with the same DOI number, you may execute the same 'dsarch' command to add another new version control record with a new internal version index but the same existing DOI number. The previous version control record is also changed to status of History.

      One case of the minimal data change is to replace one or multiple erroneous Web files under version control. The files are first moved to different filenames via dsarch Action -MV. The file type is autmatically set to 'V' as Version controlled type. A new internal version can be optionally added at this time. Then new Web files are added as replacements.

      Usage Note: Various RDA use cases are described here. It is recommended that you review and know these use cases, so that the DOIs in the RDA are handled consistently.



      Back to Top