3.2.1 - Get Request Information

Action Option -GR (-GetRequest) :

retrieves request information for the requests whose indices are provided. If no condition is given, the requests owned by the specialist running this action are returned.

dsrqst -(GR|GetRequest) [Mode Options]

[-(FN|FieldNames) FieldNameString]

[-(RI|RequestIndex) RequestIndices]

[-(RN|RequestName) RequestNames]

[-(DS|Dataset) dNNNNNN]

[-(EM|Email) UserEmailAddresses]

[-(RT|RequestType) RequestTypes]

[-(RS|RequestStatus) RequestStatus]

[-(TA|TArflag) TarFlag]

[-(DQ|DateRequest) DateRequestSubmit]

[-(DR|DateReady) DateRequestProcess]

[-(DP|DatePurge) DateRequestPurge]

[-(DF|DataFormat) DefaultDataFormat]

[-(AF|ArchiveFormat) DefaultArchiveFormat]

[-(SN|Specialist) Specialists]

[-(HN|HostName) HostMachineNames]

[-(OF|OutputFile) OutputFileName]

[-(DB|Debug) DebugModeInfo]

Available mode options:

-(CS|CheckStatus)	check and show more detailed information on request status
-(FO|FormatOutput)	format the column output with a fixed width for all values of a given field

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

Valid request field names and their corresponding Info option names:

Names	Info Options	Descriptions
R	-(RI|RequestIndex)	data request index
Q	-(RN|RequestName)	request name/ID
E	-(EM|Email)	email of the user who submitted the request
B	-(DS|Dataset)	dataset name/ID, dNNNNNN
I	-(GI|GroupIndex)	group index defined in table dsgroup
T	-(RT|RequestType)	request type; Subset, Format conversion
O	-(SQ|SizeRequest)	size of data files requested
W	-(SI|SizeInput)	size of original data files needed
C	-(FC|FileCount)	number of data files requested
J	-(DQ|DateRequest)	date request submitted
K	-(TQ|TimeRequest)	time request submitted
U	-(DR|DateReady)	date request processed
V	-(TR|TimeReady)	time request processed
X	-(DP|DatePurge)	date request to be purged
Y	-(TP|TimePurge)	time request to be purged
A	-(RS|RequestStatus)	request status
G	-(TA|TArflag)	Y to tar small request files
P	-(PO|Priority)	process priority of a Queued request
N	-(DF|DataFormat)	default data format for the output data
M	-(AF|ArchiveFormat)	default archive format for the output data
S	-(SN|Specialist)	DECS specialist who owns the request record
L	-(RL|RequestLocation)	specified path to stage the request result
H	-(HN|HostName)	machine name a request can be processed on
Z	-(EN|EmailNotice)	email notice file link, instead of default one
D	-(DE|Description)	readable request description
F	-(RF|RequestDesc)	additional request information

Request information can be retrieved for the request indices given via option -RI (-RequestIndex). Info option -RN (-RequestName) can also identify request indices, and accepts the wildcard ‘%’ to match any number of characters.

If no dataset or request is specified, the request records owned by the specialist running this action are returned.

EXAMPLE 3. To get the default-field request information owned by the specialist with login name ‘zji’:

dsrqst GR -SN zji

Content of the output:

RequestIndex<:>Email<:>Dataset<:>RequestType<:>SizeRequest<:>FileCount<:>DateRequest<:>DateReady<:>DatePurge<:>RequestStatus<:>Specialist<:>
42<:>zaihuaji@gmail.com<:>d540006<:>M<:>5917241626<:>69<:>2009-06-15<:><:><:>W<:>zji<:>
...

Back to Top

Back to Table of Contents