3.1.1 - Set Request Control Information

Action Option -SC (-SetControl) :

creates or modifies request control information in GDEXDB for given datasets, groups, and request types. One or more records can be processed per call.

dsrqst -(SC|SetControl) [Mode Options]
[-(CI|ControlIndex) RequestControlIndices]
[-(GI|GroupIndex) GroupIndices]
[-(RT|RequestType) RequestTypes]
[-(CM|ControlMode) ControlMode]
[-(VP|ValidPeriod) NumberDaysDataAvailable]
[-(LM|RequestLimit) RequestLimitInGB]
[-(MP|MaxPeriod) MaximumRequestPeriod]
[-(PL|PartitionLimit) PartitionFileCountLimit]
[-(PZ|PartitionsiZe) PartitionDataSizeLimit]
[-(PF|PartitionFlag) PartitionCommandCallFlag]
[-(DF|DataFormat) DefaultDataFormat]
[-(TF|ToFormat) DataOutputFormats]
[-(AF|ArchiveFormat) DefaultArchiveFormat]
[-(TA|TArflag) TarFlag]
[-(SN|Specialist) DECSSpecialists]
[-(PC|Command) ProcessCommand]
[-(MR|MaxRequest) MaxNumberOfOutstandingRequests]
[-(EO|EmptyOutput) EmptyOutputFlag]
[-(UA|URL) URLLinks]
[-(HN|HostName) HostMachineNames]
[-(MO|Modules) ModuleList]
[-(EV|Environments) EnvironmentPairList]
[-(QS|QsubOptions) PBSBatchOptions]
[-(EN|EmailNotice) EmailNoticeTemplateFile]
[-(CC|CarbonCopy) CarbonCopyEmails]
[-(DE|Description) ControlDescription]
[-(DB|Debug) DebugModeInfo]

Available mode options:

-(MD|MyDataset)

writes information to GDEXDB regardless of whether the specialist running dsrqst owns the dataset

-(NC|NewControl)

adds a new request control record to GDEXDB for the given dataset, group index, and request type

If a request control record already exists in GDEXDB for the given control index, that record is modified; otherwise, a new record is added when the control index is 0 and Mode option -NC (-NewControl) is present. A group index of 0 means the request control applies to the whole dataset. The combination of dataset number, group index, and request type must be unique for each request control record.

Partitions divide a large request, involving many files, into smaller pieces (up to 64). All partitions can be processed concurrently if enough compute resources are available. To enable partition support for a request control configuration, a DECS specialist must:

If a DECS specialist other than the primary dataset owner is set in a request control record, that specialist takes responsibility for the dataset’s data requests instead of the primary owner.

EXAMPLE 1. Set the request control information for d540006 from the input file ‘d540006.ctl’:

dsrqst SC -NC -IF d540006.ctl

Content of input file d540006.ctl:

ControlIndex<:>Dataset<:>GroupIndex<:>RequestType<:>ControlMode<:>Specialist<:>
0<:>d540006<:>0<:>M<:>S<:>zji<:>