3.1.2 - Get Update Controls

Action Option -GC (-GetControl) (Alias: -GetUpdateControl) :

(Alias: -GetUpdateControl) retrieves update control records for a given dataset.

dsupdt [[-(DS|Dataset)] dNNNNNN] -(GC|GetControl) [Mode Option]

[-(FN|FieldNames) FieldNameString]

[-(CI|ControlIndex) UpdateControlIndices]

[-(ID|ControlID) ControlIdString]

[-(SN|Specialist) GDEXSpecialist]

[-(PI|ParentIndex) ParentControlIndices]

[-(AN|ActionName) DSUPDTActionNames]

[-(FQ|Frequency) UpdateControlFrequencies]

[-(CO|ControlOffset) UpdateControlOffsets]

[-(CT|ControlTime) UpdateControlTimes]

[-(OF|OutputFile) OutputFileName]

[-(DB|Debug) DebugModeInfo]

Available Mode option:

-(FO|FormatOutput)

formats each column to a uniform fixed width

Use Info option -FN (-FieldNames) to specify which control fields to retrieve. The default is ‘CLNPAFOTRVUJEKZ’ when -FN is not provided. To return every available field, supply -FN ALL.

Valid field names of update controls and their corresponding Info option names:

Names	Info Options	Descriptions
C	-(CI|ControlIndex)	index of update control record
L	-(ID|ControlID)	descriptive id for a control record
N	-(SN|Specialist)	GDEX specialist who owns the control record
P	-(PI|ParentIndex)	parent index, refers to a dcupdt.cindex if not 0
A	-(AN|ActionName)	update action name for dsupdt
F	-(FQ|Frequency)	frequency of update control, i.e., 1W, 1M
O	-(CO|ControlOffset)	time offset for next process, i.e., 2D10H, 3H15N
T	-(CT|ControlTime)	time to run dsupdt, format: YYYY-MM-DD HH:NN:SS
R	-(RI|RetryInterval)	retry interval for failed dsupdt, i.e., 1M2D, 2H
V	-(VI|ValidInterval)	update valid interval, i.e., 2D, 1M
U	-(UC|UpdateControl)	any of B-Begin, C-Current, E-Reset End Date/Time, F-Future, G-GMT, M-Multi, N-New, O-Miss, Y-Skip Feb. 29, Z-Allow Zero Filesize
J	-(MC|EMailControl)	one of A-All, E-Error, N-No, S-Summary, B-Summary when Error
E	-(EC|ErrorControl)	one of I-Ignore Error, Q-Quit on Error, N-Neither
K	-(KF|KeepFile)	one of S-Server File, R-Remote File, B-Keep Both, N-Neither
Z	-(HO|HourOffset)	time zone hour offset, hours ahead of local time
D	-(DT|DataTime)	time data updated to, format: YYYY-MM-DD HH:NN:SS
H	-(HN|HostName)	hostnames on which this control index can or cannot be processed
Q	-(QS|QsubOptions)	additional PBS qsub options
Y	-(CC|CarbonCopy)	carbon copies for additional email addresses
X	-(XC|ExecuteCommand)	Command to be executed after successful update

When no dataset number is supplied, update control information is shown for all available control records across every dataset owned by the specialist running dsupdt.

EXAMPLE 2. To retrieve the default update control fields for d277000:

dsupdt d277000 GC

Content of the output:

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

Back to Top

Back to Table of Contents