3.2.6 - Get Request File information

Action Option -GF (-GetFile) :

retrieves data file information for specified requests or partitions.

dsrqst -(GF|GetFile) [Mode Options]

[-(FN|FieldNames) FieldNameString]

[-(RI|RequestIndex) RequestIndices]

[-(RN|RequestName) RequestNames]

[-(PI|PartitionIndex) PartitionIndices]

[-(TI|TarfileIndex) TarFileIndices]

[-(DS|Dataset) dNNNNNN]

[-(GI|GroupIndex) GroupIndices]

[-(OT|SourceType) SourceDataType]

[-(WF|WebFile) DataFileNames]

[-(WT|WebType) DataFileTypes]

[-(FS|FileStatus) DataFileStatus]

[-(SZ|Size) DataFileSize]

[-(DF|DataFormat) DataFormat]

[-(AF|ArchiveFormat) DataArchiveFormat]

[-(FD|FileDate) DateReadyOnline]

[-(FT|FileTime) TimeReadyOnline]

[-(OF|OutputFile) OutputFileName]

[-(DB|Debug) DebugModeInfo]

Available mode options:

-(FO|FormatOutput)	format the column output with a fixed width for all values of a given field
-(WD|WithDataset)	show Dataset ID for each request file

Use Info option -FN (-FieldNames) to choose which data file fields to retrieve. If -FN is not provided, it defaults to ‘FRPTYSNMA’. Use -FN ALL to retrieve every available field.

Valid data file field names and their corresponding Info option names:

Names	Info Options	Descriptions
R	-(RI|RequestIndex)	data request index
Q	-(RN|RequestName)	request name/ID
P	-(PI|PartitionIndex)	request partition index
T	-(TI|TarfileIndex)	tarfile index when this small file is tarred
I	-(GI|GroupIndex)	group index
B	-(DS|Dataset)	dataset name/ID, dNNNNNN
L	-(SL|SourceLink)	source file name
Z	-(OT|SourceType)	source data type, W - Web
Y	-(WT|WebFileType)	file type, Data, dOcument, Software
F	-(WF|WebFile)	file name online
A	-(FS|FileStatus)	file status, R - requested, O - online
S	-(SZ|Size)	data file size
C	-(PC|ProcessCommand)	command to process this request file
M	-(DF|DataFormat)	data format, i.e. GRIB, NetCDF
N	-(AF|ArchiveFormat)	archive format, i.e. TAR, GZ
O	-(DO|DisplayOrder)	order the file shown on webpage
J	-(TR|TimeReady)	time request processed
K	-(FD|FileDate)	date data file ready online
Y	-(FT|FileTime)	time data file ready online
D	-(DE|Description)	description of this file

Data file information can be retrieved for the request indices given via option -RI (-RequestIndex), or the partition indices given via option -PI (-PartitionIndex).

A data file record’s status is initially ‘R’ (requested) when a request is submitted. It changes to ‘O’ (online) after the request is processed and the data file has been staged online for download. If a copy of the same data file is already online for another request, that copy is shared rather than staging a new one.

EXAMPLE 7. To get the default-field data file information for partition index 13:

dsrqst GF -PI 13

Content of the output:

WebFile<:>RequestIndex<:>PartitionIndex<:>Size<:>ArchiveFormat<:>DataFormat<:>FileStatus<:>
godas.P.198306.tar<:>61160<:>13<:>196544000<:>GZ.TAR<:>GRIB1<:>O<:>
...

Back to Top

Back to Table of Contents