3.1.1 - Set Update Controls

Action Option -SC (-SetControl) (Alias: -SetUpdateControl) :

(Alias: -SetUpdateControl) creates or modifies update control records in GDEXDB for a given dataset. These records schedule data update actions that are launched automatically by the daemon dscheck. One or more control records may be set per execution.

dsupdt [[-(DS|Dataset)] dNNNNNN] -(SC|SetControl) [Mode Options]
-(CI|ControlIndex) UpdateControlIndices
[-(ID|ControlID) ControlIdString]
[-(SN|Specialist) GDEXSpecialist]
[-(PI|ParentIndex) ParentControlIndices]
[-(AN|ActionName) DSUPDTActionNames]
[-(FQ|Frequency) UpdateControlFrequencies]
[-(CO|ControlOffset) UpdateControlOffsets]
[-(CT|ControlTime) UpdateControlTimes]
[-(RI|RetryInterval) ControlRetryInterval]
[-(VI|ValidInterval) UpdateValidInterval]
[-(UC|UpdateControl) UpdateControlOptions]
[-(MC|EMailControl) EmailControlOptions]
[-(EC|ErrorControl) ErrorControlOptions]
[-(KF|KeepFile) KeepFileOptions]
[-(HO|HourOffset) TimeZoneOffsets]
[-(DT|DataTime) DataUpdatedTimes]
[-(HN|HostName) HostNames]
[-(XC|ExecuteCommand) CommandAfterUpdate]
[-(CC|CarbonCopy) Cc’dEmailAddresses]
[-(DB|Debug) DebugModeInfo]

Available Mode options:

-(MD|MyDataset)

sets information into GDEXDB regardless of dataset ownership

-(NC|NewControl)

adds a new update control record to GDEXDB

An existing update control record in GDEXDB is modified in place. A new record is created only when the control index is 0 and Mode option -NC (-NewControl) is present. The dataset name via -DS is required only when adding a new control record.

EXAMPLE 1. To set three new update control records for d277000 from input file ‘d277000.cntl’:

dsupdt SC -NC -IF d277000.cntl

Content of input file d277000.cntl:

Dataset<=>d277000
ControlIndex<:>Specialist<:>ParentIndex<:>Action<:>Frequency<:>ControlOffset<:>ControlTime<:>RetryInterval<:>UpdateControl<:>EMailControl<:>ErrorControl<:>KeepFile<:>HourOffset<:>
0<:>zji<:>0<:>UF<:>1W<:>1D9H<:>2011-10-24 09:00:00<:>12H<:><:>A<:>N<:>N<:>0<:>
0<:>zji<:>0<:>UF<:>1M<:>1D15H<:>2011-11-02 15:00:00<:>1D<:><:>A<:>N<:>N<:>0<:>
0<:>zji<:>0<:>UF<:>1M<:>2D15H<:>2011-11-03 15:00:00<:>1D<:><:>A<:>N<:>N<:>0<:>