3.1.2 - Get Dataset Information

Action Option -GD (-GetDataset) :

reads and displays dataset record fields from GDEXDB for the specified dataset.

dsarch [-(DS|Dataset)] dNNNNNN [-](GD|GetDataset) [Mode Options]

[-(FN|FieldNames) FieldNameString]
[-(KV|KeyValue) KeyNames]
[-(OF|OutputFile) OutputFileName]
[-(DB|Debug) DebugModeInfo]

Available mode options:

-(FO\|FormatOutput)	formats each column to a uniform fixed width
-(PE\|ShowPeriod)	includes associated period information for the dataset and any groups
-(WN\|WithFileNumber)	gathers and displays Saved/Web file counts

Use -FN (-FieldNames) to select which dataset fields to include. Defaults to ‘SWFULQ’. Use -FN ALL to retrieve every available field.

Valid dataset field names and their corresponding Info options:

Names	Info Options	Descriptions
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
A	-(DA\|DataAccessFlag)	dataset data file list access 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
M	-(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

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

EXAMPLE 2. To retrieve all dataset fields for d260001 and save to a file:

dsarch d260001 GD -FN ALL -PE -OF d260001.ds

Content of output file d260001.ds:

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

Back to Table of Contents