This component sends updates the archive with data that has been passed by the station mentor. It updated any data that has been flagged as passed QA/QC but has not yet been inserted into the archive.

Usage

da.update.passed [switches…​] [station…​] [times]

Switches

--after=TIME

This sets the time to re-pass after. When set, this will update all data passed after the given time. This can be used to ignore the record of the last update, but doing so can cause there to be passed data that does not exist in the final archive. No effect when used with an explicit time range.

Default: Last run time

Undefined values are permitted, to indicate that the option is set but not to a specific time.

--detached[=BOOLEAN]

This option causes the update to be executed in detached processes. This allows for better isolation in the event of failure or other problems.

--fragment=INTERVAL

This sets the maximum time that an individual fragment of data is updated at. Any intervals longer than this threshold will be cut down to be shorter. This is intended to prevent excessively long archive access.

Default: 31 days

Undefined intervals are accepted. The interval must be greater than zero in length.

--profile=STRING…​

This sets the profiles to update. If set then only the profiles listed here will be considered for updating. Consult the station editing configuration for available profiles.

Default: All passed profiles and the aerosol profile

--quiet[=BOOLEAN]

If set then no progress output is displayed and any confirmation prompts are bypassed.

Default: Disabled

--wait=NUMBER

This is the maximum time to wait for another process to complete, in seconds. If there are two concurrent processes for the same station and profile, the new one will wait at most this many seconds before giving up without performing an update.

Default: Thirty seconds

This option only accepts numbers greater than or equal to 0. Undefined values are permitted, to indicate that the option is set but not to a specific value.

Arguments

station

This argument is used to specify the station used to look up variables that do not include a station as part of an archive read specification. The station is the three letter GAW station code of the location, such as BND. The argument accepts multiple stations specified as regular expressions and separated by : or ; or ,. For example BND,MLO and (BND|MLO) are two ways of selecting both the BND and MLO stations.

The special value allstations may also be specified to select all stations.

times

This argument may be split into multiple actual program arguments. This full list of time arguments defines a time bounds list that sets the range of data queried. The final resulting data are clipped to the given time bounds but any values that intersect them are returned.

Examples

Update all stations

This will update passed data for all profiles and all stations.

da.update.passed 2015-05-01 2015-05-03