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.
Available Mode options:
sets information into GDEXDB regardless of dataset ownership |
|
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.
The update frequency (-FQ) must be a single count with a unit of Y, M, W, D, H, N, or S (i.e., 1W, 1M), optionally a fraction of a month (1M/2, 1M/3, 1M/5, 1M/6, 1M/10). Interval values (-CO, -RI, -VI here, and -DI, -AT, -TI in the local and remote file records) must be one or more count/unit pairs (i.e., 1D, 1D3H, 12H); malformed values are rejected when the record is set rather than failing later during an update.
EXAMPLE 1. To set three new update control records for d277000 from input file ‘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<:>