3.1.2 - Get Update Controls

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

      retrieves update control information for a given dataset.

      dsupdt[[-(DS|Dataset)] dsnnn.n] -(GC|GetControl) [Mode Option]
        [-(FN|FieldNames) FieldNameString]
        [-(CI|ControlIndex) UpdateControlIndices]
        [-(ID|ControlID) ControlIdString]
        [-(SN|Specialist) DSSSpecialist]
        [-(PI|ParentIndex) ParentControlIndedices]
        [-(AN|ActionName) DSUPDTActionNames]
        [-(FQ|Frequency) UpdateControlFrequencies]
        [-(CO|ControlOffset) UpdateControlOffsets]
        [-(CT|ControlTime) UpdateControlTimes]
        [-(OF|OutputFile) OutputFileName]
        [-(DB|Debug) DebugModeInfo]

      Mode option that can be specified for getting update control Action:

      Use Info option -FN (-FieldNames) to specify what control fields to be retrieved. It defaults to 'CLNPAFOTRVUJEKZ' if option -FN is not provided. Update information of all available fields is retrieved if -FN ALL is given.

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

      -(FO|FormatOutput)format the column output with a fix width for all values of a given field
      NamesInfo OptionsDescriptions
      C-(CI|ControlIndex)index of update control record
      L-(ID|ControlID)descriptive id for a control record
      N-(SN|Specialist)DSS 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: YYY-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|HourOffsset)time zone hour offset, hours ahead of local time
      D-(DT|DataTime)time data updated to, format: YYY-MM-DD HH:NN:SS
      H-(HN|HostName)hostnames this cindex can/cannot be processed on
      S-(SB|SBatchOptions)additional PBS batch options
      Q-(QS|QSubOptions)additional SLURM batch options
      Y-(CC|CarbonCopy)carbon copies for additional email addresses
      X-(XC|ExecuteCommand)Command to be executed after successful update

      If dataset number is missed, update control information is displayed for all available control records, of different datasets, owned by the specialist who runs 'dsupdt'.


      EXAMPLE 2.

      To Get The Update Control Information Of Ds277.0 For Default fields

      dsupdt277.0 GC

      Content of the output:

      Dataset<=>ds277.0
      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