.. _section3.3.8:

3.3.8 - Check Update Status
=================================


.. _CU:

Action Option -**CU** (-**CheckUpdate**) :
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

verifies whether remote files are available for
retrieval. This is useful when remote data files become available
irregularly but are organized into files covering regular temporal
periods.

| **dsupdt** [[:ref:`-(DS|Dataset) <DS>`] dNNNNNN] -(CU|CheckUpdate) [:ref:`Mode Options <mode3.3.8>`]
|           [:ref:`-(LI|LocalIndex) <LI>` LocalFileIndices]
|           [:ref:`-(LF|LocalFile) <LF>` LocalFileNames]
|           [:ref:`-(CI|ControlIndex) <CI>` UpdateControlIndices]
|           [:ref:`-(XO|ExecOrder) <XO>` ExecOrderIndex]
|           [:ref:`-(RF|RemoteFile) <RF>` RemoteFileNames]
|           [:ref:`-(SF|ServerFile) <SF>` ServerFileNames]
|           [:ref:`-(DO|DownloadOrder) <DO>` DownloadOrderIndices]
|           [:ref:`-(DC|DownloadCommand) <DC>` DownloadCommand]
|           [:ref:`-(ED|EndDate) <ED>` NextDataEndDate]
|           [:ref:`-(EH|EndHour) <EH>` NextDataEndHour]
|           [:ref:`-(GP|GenericPattern) <GP>` GenericPatterns]
|           [:ref:`-(WD|WorkDir) <WD>` WorkingDirectory]
|           [:ref:`-(MR|MissRemote) <MR>` AllowMissRemoteFile]
|           [:ref:`-(FQ|Frequency) <FQ>` UpdateFrequencies]
|           [:ref:`-(CD|CurrentDate) <CD>` CurrentDate]
|           [:ref:`-(CH|CurrentHour) <CH>` CurrentHour]
|           [:ref:`-(HO|HourOffset) <HO>` TimeZoneHourOffset]
|           [:ref:`-(CC|CarbonCopy) <CC>` Cc'dEmailAddresses]
|           [:ref:`-(DB|Debug) <DB>` DebugModeInfo]

Available :ref:`Mode options <section4>`:

.. list-table::
   :widths: auto
   :header-rows: 0

   * - :ref:`-(CA|CheckAll) <CA>`
     - checks all remote files rather than stopping at the first unavailable one
   * - :ref:`-(EE|ErrorEmail) <EE>`
     - sends email only when an error occurs during checking
   * - :ref:`-(MU|MultipleUpdate) <MU>`
     - checks files across multiple update periods
   * - :ref:`-(NE|NoEmail) <NE>`
     - suppresses post-check email notification
   * - :ref:`-(NY|NoLeapYear) <NY>`
     - skips February 29 in leap years
   * - :ref:`-(SE|SummaryEmail) <SE>`
     - sends a summary-only email with update status, without detailed log information
   * - :ref:`-(UB|UseBeginTime) <UB>`
     - uses the period's beginning time instead of the end time when substituting temporal patterns

When executed without additional conditions, every dataset due for
updates is checked for update status.



| :ref:`Back to Top <section3.3.8>`
| :ref:`Back to Table of Contents <index>`