3.1.1 - Set Request Control Information

      Action Option -SC (-SetControl) :

      creates and modifies request control information into RDADB for given datasets, groups, and request types. One or multiple records can be processed each time.

      dsrqst-(SC|SetControl) [Mode Options]
        [-(CI|ControlIndex) RequestControlIndices]
        -(DS|Dataset) dsnnn.n
        [-(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) DSSSpecialists]
        [-(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]

      Mode option that can be specified for this action include:

      If information of a request control exists already in RDADB for a given request control index, the request control record is modified; otherwise, a new record is added if control index is 0 and Mode option -NC (-NewControl) is present. A group Index 0 means that the request control is for the whole dataset. Combination of dataset number, group index and request type must be unique for each request control record.

      Partitions are used to divide a large request, involving many files, into smaller paritions (maximum 64). All partitions may be processed concurrently if enough computer resource is available. To turn on partition functionality for a request control configuration, DECS specialists need 1. in the customized ProcessCommand, specified for the request control, make sure to process the whole request and generate all the file records in table wfrqst without processing the individual data file physically, and instead fill the field wfrqst.command with one command for subset/format conversion of each individual file. The command is executed in the later partition process; 2. set either Partition Limit or Size in the request control configuration via -PL (-PartitionLimit) or -PZ (-PartitionSize); 3. optionally set the command call flag, via -PF (-PartitionFlag), to control how the request control command is called. The parition flag is defaulted to N for the request control ommand is called, as in form of 'CustomizedCommand RequestIndex', intially once to generate the wfrqst file records, and DSRQST will then take care of partitioning and building individual files. Set the flag to P for DSRQST to call the reuqest control command again for each partition process in the form of 'CustomizedCommand RequestIndex RequestDirectory PartitionIndex', and then the commands to build individual files in field wfrqst.command are optional for flag value of P. If the partition flag is set to F, the request control command is called, in form of 'CustomizedCommand RequestIndex RequstrDirectory', finally again after all the paritions are processed successfully. Set the flag to B if P and F are both required.

      If a DSS specialist, other than the primary dataset owner, is set for a request control record, this specialist will take responsibility of data requests of the dataset instead of the primary dataset owner.


      EXAMPLE 1.

      Set Request Control Information Of Ds540.6 Via Input File 'Ds540.6.Ctl'

      -(NC|NewRequest)sets a new request control record into RDADB for given dataset,
      -(NC|NewRequest)sets a new request control record into RDADB for given dataset, group index, and request type
      dsrqstSC -NC -IF ds540.6.ctl

      Content of input file ds540.6.ctl:

      ControlIndex<:>Dataset<:>GroupIndex<:>RequestType<:>ControlMode<:>Specialist<:>
      0<:>ds540.6<:>0<:>M<:>S<:>zji<:>



      Back to Top