3.1.2 - Get Request Control Information

Action Option -GC (-GetControl) :

retrieves request control information for the given datasets, groups, or request types. If specialist login names are provided, records owned by those specialists are retrieved. If no condition is given, the records owned by the specialist running dsrqst are retrieved.

dsrqst -(GC|GetControl) [Mode Options]

[-(FN|FieldNames) FieldNameString]

[-(CI|ControlIndex) controlIndices]

[-(DS|Dataset) dNNNNNN]

[-(GI|GroupIndex) GroupIndices]

[-(RT|RequestType) RequestTypes]

[-(CM|ControlMode) ControlMode]

[-(SN|Specialist) DECSSpecialists]

[-(PC|Command) ProcessCommand]

[-(EO|EmptyOutput) EmptyOutputFlag]

[-(UA|URL) URLLinks]

[-(HN|HostName) HostMachineNames]

[-(OF|OutputFile) OutputFileName]

[-(DB|Debug) DebugModeInfo]

Available mode option:

-(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 control fields to retrieve. If -FN is not provided, it defaults to ‘CTIRWGSPOUH’. Use -FN ALL to retrieve every available field.

Valid request control field names and their corresponding Info option names:

Names	Info Options	Descriptions
C	-(CI|ControlIndex)	request control index
T	-(DS|Dataset)	Dataset number/ID
I	-(GI|GroupIndex)	group index
R	-(RT|RequestType)	S - subset, F - format conversion, D - CDP
W	-(CM|ControlMode)	S - specialist controlled, A - automated
V	-(VP|ValidPeriod)	number of days the data are available
J	-(LM|RequestLimit)	upper request limit (GB) of data to be requested each time
K	-(MP|MaxPeriod)	maximum default request period
L	-(PL|PartitionLimit)	upper limit of file count in each partition
Z	-(PZ|PartitionSize)	upper limit of data size in each partition
F	-(PF|PartitionFlag)	partition command call flag, N, P, F and B
D	-(DF|DataFormat)	default data format for the output data
A	-(AF|ArchiveFormat)	default archive format for the output data
X	-(TF|ToFormat)	to format for data output; GRIB:NETCDF
G	-(TA|TArflag)	Y to tar small request files
S	-(SN|Specialist)	DECS specialist who controls the requests
P	-(PC|Command)	processing command provided by specialist
N	-(MR|MaxRequest)	max number of outstanding requests allowed
O	-(EO|EmptyOutput)	Y - sends email to user for empty output, default is N
U	-(UA|URL)	specified URL links for the requests
H	-(HN|HostName)	machines on which requests should or should not be processed
M	-(MO|Modules)	include modules to load to batch job script
B	-(EV|Environments)	environment variables to load in batch job script
Q	-(QS|QsubOptions)	additional PBS batch options for qsub
E	-(EN|EmailNotice)	email notice template file, instead of the default one
Y	-(CC|CarbonCopy)	Carbon copy emails; S - specialist only

Request control information can be retrieved for specified datasets via option -DS (-Dataset), with optional additional conditions. Info option -DS accepts the wildcard ‘%’ to match any number of characters.

If no dataset number is given, only the request control records owned by the specialist running this action are returned. To view records owned by another specialist, specify Info option -SN (-Specialist) for that specialist. To view all request control records, supply -SN with the value ‘ALL’.

EXAMPLE 2. To get every field of every request control under your control:

dsrqst GC -FN ALL

Back to Top

Back to Table of Contents