3.2.2 - Get Version Control

Action Option -GV (-GetVersion) :

retrieves DOI/Version control records from GDEXDB for a given dataset.

dsarch [-(DS|Dataset)] dNNNNNN [-](GV|GetVersion) [Mode Option]

[-(FN|FieldNames) FieldNameString]

[-(KV|KeyValue) KeyNames]

[-(OF|OutputFile) OutputFileName]

[-(DB|Debug) DebugModeInfo]

Available mode option:

-(FO|FormatOutput)

formats each column to a uniform fixed width

Use -FN (-FieldNames) to specify which version control fields to retrieve. Defaults to ‘VIEDSJX’. Use -FN ALL to retrieve all available fields.

Valid version control field names and their corresponding Info options:

Names	Info Options	Descriptions
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

Use -OF (-OutputFile) to save the retrieved information to a file. Without it, results are displayed on screen.

EXAMPLE 4. To retrieve all version control fields for d132000 and save to a file:

dsarch d132000 GV -FN ALL -OF d132000.vrsn

Content of output file d132000.vrsn:

Dataset<=>d132000
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

Back to Table of Contents